Changeset 1623

Timestamp:

12/11/18 17:58:35 (6 years ago)

Author:

oabramkina

Message:

Updating reference guide.

Location:

XIOS/trunk/doc

Files:

• XIOS_reference_guide.lyx (modified) (252 diffs)
• XIOS_reference_guide.pdf (modified) (previous)
• XIOS_user_guide.lyx (modified) (6 diffs)
• XIOS_user_guide.pdf (modified) (previous)

XIOS/trunk/doc/XIOS_reference_guide.lyx

@@ -10 +10 @@
 \maintain_unincluded_children false
 \language english
-\language_package default
+\language_package auto
 \inputencoding auto
 \fontencoding global
@@ -99 +99 @@
 
 \begin_layout Plain Layout
-enumeration { Gregorian, Julian, D360, AllLeap, NoLeap, user_defined }
+enumeration {Gregorian, Julian, D360, AllLeap, NoLeap, user_defined}
 \end_layout
 
@@ -272 +272 @@
 
 \begin_layout Standard
-Define the time origin of the time axis.
- It will appear as metadata attached to the time axis in the output file.
+Define the time origin of a time axis.
+ It will appear as metadata attached to the time axis in an output file.
  This attribute is optional, the default value is 
 \begin_inset Flex Emph
@@ -441 +441 @@
 
 \begin_layout Standard
-Define the duration of a day, in seconds, when using a custom calendar.
+Define the duration of a day in seconds when using a custom calendar.
  This attribute is mandatory if the calendar 
 \series bold
@@ -677 +677 @@
 \series default
  attribute is used, otherwise it must not be defined.
- The default behaviour is not to have any leap year.
+ The default behavior is not to have any leap year.
  If defined, this attribute must comply with the following constraint: 
 \begin_inset Formula $1\leq leap\_year\_month\leq size(month\_lengths)$
@@ -758 +758 @@
 \series default
  attribute is used, otherwise it must not be defined.
- The default behaviour is not to have any leap year, i.e.
+ The default behavior is not to have any leap year, i.e.
  the default value is 
 \begin_inset Formula $\mathbf{0}$
@@ -886 +886 @@
 
 \begin_layout Section
+Scalar attribute reference
+\end_layout
+
+\begin_layout Subsection*
+name (optional): 
+\begin_inset Flex Emph
+status collapsed
+
+\begin_layout Plain Layout
+string
+\end_layout
+
+\end_inset
+
+
+\end_layout
+
+\begin_layout Standard
+Fortran: 
+\end_layout
+
+\begin_layout LyX-Code
+CHARACTER(LEN=*) :: name
+\end_layout
+
+\begin_layout Standard
+Defines the name of a scalar as it will appear in a file.
+ If not defined, the name will be generated automatically based on the id.
+ If multiple scalars are defined in the same file, each scalar must have
+ a unique name.
+ 
+\end_layout
+
+\begin_layout Subsection*
+standard_name (optional): 
+\begin_inset Flex Emph
+status collapsed
+
+\begin_layout Plain Layout
+string
+\end_layout
+
+\end_inset
+
+
+\end_layout
+
+\begin_layout Standard
+Fortran: 
+\end_layout
+
+\begin_layout LyX-Code
+CHARACTER(LEN=*) :: standard_name
+\end_layout
+
+\begin_layout Standard
+Defines the standard name of a scalar as it will appear in the scalar's
+ metadata in an output file.
+ 
+\end_layout
+
+\begin_layout Subsection*
+long_name (optional): 
+\begin_inset Flex Emph
+status collapsed
+
+\begin_layout Plain Layout
+string
+\end_layout
+
+\end_inset
+
+
+\end_layout
+
+\begin_layout Standard
+Fortran: 
+\end_layout
+
+\begin_layout LyX-Code
+CHARACTER(LEN=*) :: long_name
+\end_layout
+
+\begin_layout Standard
+Defines the long name of a scalar as it will appear in the scalar's metadata
+ in an output file.
+ 
+\end_layout
+
+\begin_layout Subsection*
+unit (optional): 
+\begin_inset Flex Emph
+status collapsed
+
+\begin_layout Plain Layout
+string
+\end_layout
+
+\end_inset
+
+
+\end_layout
+
+\begin_layout Standard
+Fortran: 
+\end_layout
+
+\begin_layout LyX-Code
+CHARACTER(LEN=*) :: unit
+\end_layout
+
+\begin_layout Standard
+Defines the scalar unit as it will appear in the scalar's metadata in an
+ output file.
+\end_layout
+
+\begin_layout Subsection*
+value (optional): 
+\begin_inset Flex Emph
+status collapsed
+
+\begin_layout Plain Layout
+double
+\end_layout
+
+\end_inset
+
+
+\end_layout
+
+\begin_layout Standard
+Fortran:
+\end_layout
+
+\begin_layout LyX-Code
+DOUBLE PRECISION :: value
+\end_layout
+
+\begin_layout Standard
+Defines the value of a scalar.
+ If both, the label and the value, are set then only the label will be written
+ into a file.
+\end_layout
+
+\begin_layout Subsection*
+bounds (optional): 
+\begin_inset Flex Emph
+status collapsed
+
+\begin_layout Plain Layout
+1D-array of double
+\end_layout
+
+\end_inset
+
+
+\end_layout
+
+\begin_layout Standard
+Fortran:
+\end_layout
+
+\begin_layout LyX-Code
+DOUBLE PRECISION :: bounds(:)
+\end_layout
+
+\begin_layout Standard
+Defines (two) scalar boundaries.
+ The array size must should be equal to 2.
+\end_layout
+
+\begin_layout Subsection*
+bounds_name (optional): 
+\begin_inset Flex Emph
+status collapsed
+
+\begin_layout Plain Layout
+string
+\end_layout
+
+\end_inset
+
+
+\end_layout
+
+\begin_layout Standard
+Fortran: 
+\end_layout
+
+\begin_layout LyX-Code
+CHARACTER(LEN=*) :: bounds_name
+\end_layout
+
+\begin_layout Standard
+Defines the name of scalar bounds as it will appear in a file.
+ If not defined, the name will be generated automatically based on the scalar
+ id.
+\end_layout
+
+\begin_layout Subsection*
+prec (optional): 
+\emph on
+integer
+\end_layout
+
+\begin_layout Standard
+Fortran:
+\end_layout
+
+\begin_layout LyX-Code
+INTEGER :: prec
+\end_layout
+
+\begin_layout Standard
+Defines the precision in bytes of scalar value and boundaries as it will
+ be written into an output file.
+ Available values are: 2 (integer), 4 (float single precision) and 8 (float
+ double precision).
+ The default value is 8.
+\end_layout
+
+\begin_layout Subsection*
+label (optional): 
+\begin_inset Flex Emph
+status collapsed
+
+\begin_layout Plain Layout
+string
+\end_layout
+
+\end_inset
+
+
+\end_layout
+
+\begin_layout Standard
+Fortran: 
+\end_layout
+
+\begin_layout LyX-Code
+CHARACTER(LEN=*) :: label
+\end_layout
+
+\begin_layout Standard
+Defines the label of a scalar.
+ If both, the label and the value, are set then only the label will be output
+ into a file.
+\end_layout
+
+\begin_layout Subsection*
+scalar_ref (optional): string
+\end_layout
+
+\begin_layout Standard
+Fortran:
+\end_layout
+
+\begin_layout LyX-Code
+CHARACTER(LEN=*) :: scalar_ref
+\end_layout
+
+\begin_layout Standard
+Defines the reference to a scalar.
+ All attributes will be inherited from the referenced scalar via the classical
+ inheritance mechanism.
+ The value assigned to the referenced scalar will be transmitted to the
+ current scalar.
+\end_layout
+
+\begin_layout Subsection*
+positive (optional): 
+\begin_inset Flex Emph
+status collapsed
+
+\begin_layout Plain Layout
+enumeration {up, down}
+\end_layout
+
+\end_inset
+
+
+\end_layout
+
+\begin_layout Standard
+Fortran:
+\end_layout
+
+\begin_layout LyX-Code
+CHARACTER(LEN=*) :: positive
+\end_layout
+
+\begin_layout Standard
+Defines the positive direction for fields representing height or depth.
+\end_layout
+
+\begin_layout Subsection*
+axis_type (optional): 
+\begin_inset Flex Emph
+status collapsed
+
+\begin_layout Plain Layout
+enumeration {X, Y, Z, T}
+\end_layout
+
+\end_inset
+
+
+\end_layout
+
+\begin_layout Standard
+Fortran:
+\end_layout
+
+\begin_layout LyX-Code
+CHARACTER(LEN=*) :: axis_type
+\end_layout
+
+\begin_layout Standard
+Defines the type of a (scalar) axis.
+ The values correspond to the following axis types:
+\end_layout
+
+\begin_layout Itemize
+
+\series bold
+\shape italic
+X:
+\series default
+\shape default
+ longitude
+\end_layout
+
+\begin_layout Itemize
+
+\series bold
+\shape italic
+\emph on
+Y
+\emph default
+:
+\series default
+\shape default
+ latitude
+\end_layout
+
+\begin_layout Itemize
+
+\series bold
+\shape italic
+\emph on
+Z
+\emph default
+:
+\series default
+\shape default
+ vertical axis
+\end_layout
+
+\begin_layout Itemize
+
+\series bold
+\shape italic
+T: 
+\series default
+\shape default
+time axis.
+\end_layout
+
+\begin_layout Subsection*
+comment: 
+\begin_inset Flex Emph
+status collapsed
+
+\begin_layout Plain Layout
+string
+\end_layout
+
+\end_inset
+
+
+\end_layout
+
+\begin_layout Standard
+Fortran: 
+\end_layout
+
+\begin_layout LyX-Code
+CHARACTER(LEN=*) :: comment
+\end_layout
+
+\begin_layout Standard
+Allows a user to set a comment.
+ 
+\end_layout
+
+\begin_layout Section
 Axis attribute reference
 \end_layout
 
 \begin_layout Subsection*
-name: 
+name (optional): 
 \begin_inset Flex Emph
 status collapsed
@@ -912 +1308 @@
 
 \begin_layout Standard
-Define the name of the vertical axis, as it will appear in a file.
- If not defined, a name is self generated from the id.
- If multiple vertical axis are defined in a same file, each name must be
- different.
+Defines the name of a vertical axis as it will appear in an output file.
+ If not defined, the name will be generated automatically based on the axis
+ id.
+ If multiple vertical axes are defined in the same file, each axis must
+ have a unique name.
  
 \end_layout
 
 \begin_layout Subsection*
-standard_name: 
+standard_name (optional): 
 \begin_inset Flex Emph
 status collapsed
@@ -942 +1339 @@
 
 \begin_layout Standard
-Define the standard name of the vertical axis, as it will appear in the
- metadata attached to the axis of the output file.
+Defines the standard name of a vertical axis as it will appear in the axis'
+ metadata in an output file.
  
 \end_layout
 
 \begin_layout Subsection*
-long_name: 
+long_name (optional): 
 \begin_inset Flex Emph
 status collapsed
@@ -970 +1367 @@
 
 \begin_layout Standard
-Define the long name of the vertical axis, as it will appear in the metadata
- attached to the axis of the output file.
+Defines the long name of a vertical axis as it will appear in the axis'
+ metadata in an output file.
  
 \end_layout
 
 \begin_layout Subsection*
-unit: 
+unit (optional): 
 \begin_inset Flex Emph
 status collapsed
@@ -998 +1395 @@
 
 \begin_layout Standard
-Define the unit of the axis as it will appear in the metadata attached to
- the axis in the output file.
-\end_layout
-
-\begin_layout Subsection*
-n_glo: 
+Defines the unit of an axis as it will appear in the axis' metadata in an
+ output file.
+\end_layout
+
+\begin_layout Subsection*
+dim_name (optional): 
 \begin_inset Flex Emph
 status collapsed
 
 \begin_layout Plain Layout
+string
+\end_layout
+
+\end_inset
+
+
+\end_layout
+
+\begin_layout Standard
+Fortran: 
+\end_layout
+
+\begin_layout LyX-Code
+CHARACTER(LEN=*) :: dim_name
+\end_layout
+
+\begin_layout Standard
+Defines the name of axis dimension as it will appear in the file's metadata.
+\end_layout
+
+\begin_layout Subsection*
+formula (optional): 
+\begin_inset Flex Emph
+status collapsed
+
+\begin_layout Plain Layout
+string
+\end_layout
+
+\end_inset
+
+
+\end_layout
+
+\begin_layout Standard
+Fortran: 
+\end_layout
+
+\begin_layout LyX-Code
+CHARACTER(LEN=*) :: formula
+\end_layout
+
+\begin_layout Standard
+Adds the formula attribute to a parametric vertical axis.
+\end_layout
+
+\begin_layout Subsection*
+formula_term (optional): 
+\begin_inset Flex Emph
+status collapsed
+
+\begin_layout Plain Layout
+string
+\end_layout
+
+\end_inset
+
+
+\end_layout
+
+\begin_layout Standard
+Fortran: 
+\end_layout
+
+\begin_layout LyX-Code
+CHARACTER(LEN=*) :: formula_term
+\end_layout
+
+\begin_layout Standard
+Adds the formula terms attribute to a parametric vertical axis.
+\end_layout
+
+\begin_layout Subsection*
+formula_bounds (optional): 
+\begin_inset Flex Emph
+status collapsed
+
+\begin_layout Plain Layout
+string
+\end_layout
+
+\end_inset
+
+
+\end_layout
+
+\begin_layout Standard
+Fortran: 
+\end_layout
+
+\begin_layout LyX-Code
+CHARACTER(LEN=*) :: formula_bounds
+\end_layout
+
+\begin_layout Standard
+Adds the formula attribute to the bounds of a parametric vertical axis.
+ The attribute is mandatory if the 
+\begin_inset Flex Strong
+status collapsed
+
+\begin_layout Plain Layout
+formula
+\end_layout
+
+\end_inset
+
+ attribute is defined for the axis.
+\end_layout
+
+\begin_layout Subsection*
+formula_term_bounds (optional): 
+\begin_inset Flex Emph
+status collapsed
+
+\begin_layout Plain Layout
+string
+\end_layout
+
+\end_inset
+
+
+\end_layout
+
+\begin_layout Standard
+Fortran: 
+\end_layout
+
+\begin_layout LyX-Code
+CHARACTER(LEN=*) :: formula_term_bounds
+\end_layout
+
+\begin_layout Standard
+Adds the formula terms attribute to the bounds of a parametric vertical
+ axis.
+ The attribute is mandatory if the 
+\begin_inset Flex Strong
+status collapsed
+
+\begin_layout Plain Layout
+formula
+\end_layout
+
+\end_inset
+
+ attribute is defined for the axis.
+\end_layout
+
+\begin_layout Subsection*
+n_glo (mandatory): 
+\begin_inset Flex Emph
+status collapsed
+
+\begin_layout Plain Layout
 integer
 \end_layout
@@ -1025 +1575 @@
 
 \begin_layout Standard
-Define the global size of the axis.
- This attribute is mandatory.
-\end_layout
-
-\begin_layout Subsection*
-begin: 
+Defines the global size of an axis.
+\end_layout
+
+\begin_layout Subsection*
+begin (optional): 
 \begin_inset Flex Emph
 status collapsed
@@ -1052 +1601 @@
 
 \begin_layout Standard
-Define the the beginning index of the local domain.
- This attribute is optional.
- This must be an index between 0 and 
+Defines the beginning index of the local domain.
+ It can take value between 0 and 
 \begin_inset Flex Strong
 status collapsed
@@ -1069 +1617 @@
 
 \begin_layout Subsection*
-n: 
+n (optional): 
 \begin_inset Flex Emph
 status collapsed
@@ -1091 +1639 @@
 
 \begin_layout Standard
-Define the the local size of the axis.
- This attribute is optional.
- This must be an integer between 1 and 
+Defines the local size of an axis.
+ It can take value between 0 and 
 \begin_inset Flex Strong
 status collapsed
@@ -1115 +1662 @@
 
 .
- 
-\end_layout
-
-\begin_layout Subsection*
-value: 
+ Local axis decomposition can be declared either with attributes 
+\series bold
+\shape italic
+{n, begin}
+\series default
+\shape default
+ or with 
+\series bold
+\shape italic
+index
+\series default
+\shape default
+.
+\end_layout
+
+\begin_layout Subsection*
+index (optional): 
 \begin_inset Flex Emph
 status collapsed
@@ -1137 +1696 @@
 
 \begin_layout LyX-Code
+DOUBLE PRECISION :: index(:)
+\end_layout
+
+\begin_layout Standard
+Defines the global indexes of a local axis held by each process.
+ If the attribute is specified, its array size must be equal to 
+\begin_inset Flex Strong
+status collapsed
+
+\begin_layout Plain Layout
+n
+\end_layout
+
+\end_inset
+
+.
+ Local axis decomposition can be declared either with attributes 
+\series bold
+\shape italic
+{n, begin}
+\series default
+\shape default
+ or with 
+\series bold
+\shape italic
+index
+\series default
+\shape default
+.
+\end_layout
+
+\begin_layout Subsection*
+value (optional): 
+\begin_inset Flex Emph
+status collapsed
+
+\begin_layout Plain Layout
+1D-array of double
+\end_layout
+
+\end_inset
+
+
+\end_layout
+
+\begin_layout Standard
+Fortran:
+\end_layout
+
+\begin_layout LyX-Code
 DOUBLE PRECISION :: value(:)
 \end_layout
 
 \begin_layout Standard
-Define the value of each level of a vertical axis.
- The size of the array must be equal to the 
-\begin_inset Flex Strong
-status collapsed
-
-\begin_layout Plain Layout
-size
-\end_layout
-
-\end_inset
-
- attribute.
- If not defined the default values are filled with values from 1 to 
-\begin_inset Flex Strong
-status collapsed
-
-\begin_layout Plain Layout
-size
+Defines the value of each level of a vertical axis.
+ The array size must be equal to the value of the attribute 
+\begin_inset Flex Strong
+status collapsed
+
+\begin_layout Plain Layout
+n
 \end_layout
 
@@ -1164 +1762 @@
 
 .
-\end_layout
-
-\begin_layout Subsection*
-bounds: 
+ If the label is provided then only the label will be written into a file
+ and not the axis value and the axis boundaries.
+\end_layout
+
+\begin_layout Subsection*
+bounds (optional): 
 \begin_inset Flex Emph
 status collapsed
@@ -1185 +1785 @@
 
 \begin_layout LyX-Code
-DOUBLE PRECISION :: value(:,:)
-\end_layout
-
-\begin_layout Standard
-Define the boundaries of each level of a the vertical axis.
+DOUBLE PRECISION :: bounds(:,:)
+\end_layout
+
+\begin_layout Standard
+Defines the boundaries of each level of a vertical axis.
  The dimensions of the array must be 
 \begin_inset Formula $2\times n$
@@ -1198 +1798 @@
 
 \begin_layout Subsection*
-data_begin:
+bounds_name (optional): 
+\begin_inset Flex Emph
+status collapsed
+
+\begin_layout Plain Layout
+string
+\end_layout
+
+\end_inset
+
+
+\end_layout
+
+\begin_layout Standard
+Fortran: 
+\end_layout
+
+\begin_layout LyX-Code
+CHARACTER(LEN=*) :: bounds_name
+\end_layout
+
+\begin_layout Standard
+Defines the name of axis boundaries as it will appear in a file.
+ If not defined, the name will be generated automatically based on the axis
+ id.
+\end_layout
+
+\begin_layout Subsection*
+prec (optional): 
+\emph on
+integer
+\end_layout
+
+\begin_layout Standard
+Fortran:
+\end_layout
+
+\begin_layout LyX-Code
+INTEGER :: prec
+\end_layout
+
+\begin_layout Standard
+Defines the precision in bytes of axis value and boundaries as it will be
+ written into an output file.
+ Available values are: 2 (integer), 4 (float single precision) and 8 (float
+ double precision).
+ The default value is 8.
+\end_layout
+
+\begin_layout Subsection*
+label (optional): 
+\begin_inset Flex Emph
+status collapsed
+
+\begin_layout Plain Layout
+string
+\end_layout
+
+\end_inset
+
+
+\end_layout
+
+\begin_layout Standard
+Fortran: 
+\end_layout
+
+\begin_layout LyX-Code
+CHARACTER, ALLOCATABLE :: label(:)
+\end_layout
+
+\begin_layout Standard
+Defines the label of an axis.
+ The size of the array must be equal to the value of the attribute 
+\begin_inset Flex Strong
+status collapsed
+
+\begin_layout Plain Layout
+n
+\end_layout
+
+\end_inset
+
+.
+ If the label is provided then only the label will be written into a file
+ and not the axis value and the axis boundaries.
+\end_layout
+
+\begin_layout Subsection*
+data_begin (optional):
 \emph on
  integer
@@ -1212 +1901 @@
 
 \begin_layout Standard
-Define the beginning index of the field data for the axis.
- This attribute is an offset regarding the local axis, so the value can
+Defines the beginning index of local field data owned by each process.
+ The attribute is an offset relative to the local axis, so the value can
  be negative.
  A negative value indicates that only some valid part of the data will extracted
@@ -1219 +1908 @@
  A positive value indicates that the local domain is greater than the data
  stored in memory.
- A 0-value means that the local domain matches the data in memory.
- This attribute is optional and the default value is 0.
- Otherwise 
+ The 0-value means that the local domain matches the data in memory.
+ The default value is 0.
+ The attributes 
 \begin_inset Flex Strong
 status collapsed
@@ -1245 +1934 @@
 
 \begin_layout Subsection*
-data_n: 
+data_n (optional): 
 \emph on
 integer
@@ -1259 +1948 @@
 
 \begin_layout Standard
-Define the size of the field data for the first axis.
- This attribute is optional and the default value is 
+Defines the size of local field data.
+ The attribute can take value starting from 0 (no data on a process).
+ The default value is 
 \begin_inset Flex Strong
 status collapsed
@@ -1271 +1961 @@
 
 .
- Otherwise 
+ The attributes 
 \begin_inset Flex Strong
 status collapsed
@@ -1295 +1985 @@
 
 \begin_layout Subsection*
-data_index: 
+data_index (optional): 
 \emph on
 integer
@@ -1309 +1999 @@
 
 \begin_layout Standard
-In case of a compressed vertical axis, this attribute define the number
- of points stored in memory on the local axis.
-\end_layout
-
-\begin_layout Subsection*
-mask: 
+In case of a compressed vertical axis, the attribute defines the position
+ of data points stored in the memory.
+ The array size has to be equal to 
+\begin_inset Flex Strong
+status collapsed
+
+\begin_layout Plain Layout
+data_n
+\end_layout
+
+\end_inset
+
+.
+ For example, for a local axis of size 
+\begin_inset Flex Strong
+status collapsed
+
+\begin_layout Plain Layout
+n=3
+\end_layout
+
+\end_inset
+
+ and local data size of 
+\begin_inset Flex Strong
+status collapsed
+
+\begin_layout Plain Layout
+data_n=5
+\end_layout
+
+\end_inset
+
+, if 
+\begin_inset Flex Strong
+status collapsed
+
+\begin_layout Plain Layout
+data_index=(/ -1, 2, 1, 0, -1 /)
+\end_layout
+
+\end_inset
+
+ then the first and the last data points are ghosts and only the three middle
+ values will be written in the reversed order.
+\end_layout
+
+\begin_layout Subsection*
+mask (optional): 
 \emph on
 1D-array of bool
@@ -1328 +2061 @@
 
 \begin_layout Standard
-Define the mask of the local axis.
+Defines the mask of the local axis.
  The masked value will be replaced by the value of the field attribute 
 \begin_inset Flex Strong
@@ -1339 +2072 @@
 \end_inset
 
- in the output file.
-\end_layout
-
-\begin_layout Subsection*
-n_distributed_partition: 
+ in an output file.
+\end_layout
+
+\begin_layout Subsection*
+n_distributed_partition (optional): 
 \emph on
 integer
@@ -1357 +2090 @@
 
 \begin_layout Standard
-Define the number of local axis in case axis is auto-generated.
- This attribute is optional and the default value is 
+Defines the number of local axes in case if the axis is generated automatically
+ by XIOS.
+ The default value is 
 \begin_inset Flex Strong
 status collapsed
@@ -1372 +2106 @@
 
 \begin_layout Subsection*
-positive: 
+axis_ref (optional): string
+\end_layout
+
+\begin_layout Standard
+Fortran:
+\end_layout
+
+\begin_layout LyX-Code
+CHARACTER(LEN=*) :: axis_ref
+\end_layout
+
+\begin_layout Standard
+Defines the reference of an axis.
+ All attributes will be inherited from the referenced axis with the classical
+ inheritance mechanism.
+ The value assigned to the referenced axis will be transmitted to the current
+ axis.
+\end_layout
+
+\begin_layout Subsection*
+positive (optional): 
 \begin_inset Flex Emph
 status collapsed
 
 \begin_layout Plain Layout
-enumeration { up, down }
+enumeration {up, down}
 \end_layout
 
@@ -1394 +2148 @@
 
 \begin_layout Standard
-Define the direction of vertical axis.
-\end_layout
-
-\begin_layout Subsection*
-axis_ref: string
-\end_layout
-
-\begin_layout Standard
-Fortran:
-\end_layout
-
-\begin_layout LyX-Code
-CHARACTER(LEN=*) :: axis_ref
-\end_layout
-
-\begin_layout Standard
-Define the reference of the axis.
- All attributes are inherited from the referenced axis with the classical
- inheritance mechanism.
- The value assigned to the referenced axis is transmitted to to current
- axis.
- This attribute is optional.
-\end_layout
-
-\begin_layout Subsection*
-index: 
+Defines the positive direction for fields representing height or depth.
+\end_layout
+
+\begin_layout Subsection*
+axis_type (optional): 
 \begin_inset Flex Emph
 status collapsed
 
 \begin_layout Plain Layout
-1D-array of double
-\end_layout
-
-\end_inset
-
-
-\end_layout
-
-\begin_layout Standard
-Fortran:
-\end_layout
-
-\begin_layout LyX-Code
-DOUBLE PRECISION :: index(:)
-\end_layout
-
-\begin_layout Standard
-Define the global index of axis which the local axis holds.
- This attribute is optional and the size of the array is equal to 
-\begin_inset Flex Strong
-status collapsed
-
-\begin_layout Plain Layout
-n
-\end_layout
-
-\end_inset
-
-.
+enumeration {X, Y, Z, T}
+\end_layout
+
+\end_inset
+
+
+\end_layout
+
+\begin_layout Standard
+Fortran:
+\end_layout
+
+\begin_layout LyX-Code
+CHARACTER(LEN=*) :: axis_type
+\end_layout
+
+\begin_layout Standard
+Defines the type of an axis.
+ The values correspond to the following axis types:
+\end_layout
+
+\begin_layout Itemize
+
+\series bold
+\shape italic
+X:
+\series default
+\shape default
+ longitude
+\end_layout
+
+\begin_layout Itemize
+
+\series bold
+\shape italic
+\emph on
+Y
+\emph default
+:
+\series default
+\shape default
+ latitude
+\end_layout
+
+\begin_layout Itemize
+
+\series bold
+\shape italic
+\emph on
+Z
+\emph default
+:
+\series default
+\shape default
+ vertical axis
+\end_layout
+
+\begin_layout Itemize
+
+\series bold
+\shape italic
+T: 
+\series default
+\shape default
+time axis.
+\end_layout
+
+\begin_layout Subsection*
+comment (optional): 
+\begin_inset Flex Emph
+status collapsed
+
+\begin_layout Plain Layout
+string
+\end_layout
+
+\end_inset
+
+
+\end_layout
+
+\begin_layout Standard
+Fortran: 
+\end_layout
+
+\begin_layout LyX-Code
+CHARACTER(LEN=*) :: comment
+\end_layout
+
+\begin_layout Standard
+Allows a user to set a comment.
+ 
 \end_layout
 
@@ -1460 +2256 @@
 
 \begin_layout Subsection*
-name: 
+name (optional): 
 \begin_inset Flex Emph
 status collapsed
@@ -1482 +2278 @@
 
 \begin_layout Standard
-Define the name of the horizontal domain.
+Defines the name of a horizontal domain.
  This attribute may be used in case of multiple domains defined in the same
  file.
@@ -1497 +2293 @@
  attribute will be suffixed to the longitude and latitude dimensions and
  axis name.
- Otherwise, a suffix will be self-generated.
-\end_layout
-
-\begin_layout Subsection*
-standard_name: 
+ If the domain name is not provided, it will be generated automatically.
+\end_layout
+
+\begin_layout Subsection*
+standard_name (optional): 
 \begin_inset Flex Emph
 status collapsed
@@ -1523 +2319 @@
 
 \begin_layout Standard
-Define the standard name of the domain, as it will appear in the metadata
- attached to the domain of the output file.
+Defines the standard name of a domain as it will appear in the domain's
+ metadata in an output file.
  
 \end_layout
 
 \begin_layout Subsection*
-long_name: 
+long_name (optional): 
 \begin_inset Flex Emph
 status collapsed
@@ -1551 +2347 @@
 
 \begin_layout Standard
-Define the long name of the domain, as it will appear in the metadata attached
- to the domain of the output file.
+Defines the long name of a domain as it will appear in the domain's metadata
+ in an output file.
  
 \end_layout
 
 \begin_layout Subsection*
-type: 
+type (mandatory): 
 \begin_inset Flex Emph
 status collapsed
 
 \begin_layout Plain Layout
-enumeration { rectilinear, curvilinear, unstructured }
+enumeration {rectilinear, curvilinear, unstructured, gaussian}
 \end_layout
 
@@ -1579 +2375 @@
 
 \begin_layout Standard
-Define the type of the grid.
- This attribute is mandatory.
-\end_layout
-
-\begin_layout Subsection*
-ni_glo: 
+Defines the type of a grid.
+\end_layout
+
+\begin_layout Subsection*
+dim_i_name (optional): 
 \begin_inset Flex Emph
 status collapsed
 
 \begin_layout Plain Layout
+string
+\end_layout
+
+\end_inset
+
+
+\end_layout
+
+\begin_layout Standard
+Fortran: 
+\end_layout
+
+\begin_layout LyX-Code
+CHARACTER(LEN=*) :: dim_i_name
+\end_layout
+
+\begin_layout Standard
+Defines the name of the first domain dimension as it will appear in the
+ file's metadata.
+\end_layout
+
+\begin_layout Subsection*
+dim_j_name (optional): 
+\begin_inset Flex Emph
+status collapsed
+
+\begin_layout Plain Layout
+string
+\end_layout
+
+\end_inset
+
+
+\end_layout
+
+\begin_layout Standard
+Fortran: 
+\end_layout
+
+\begin_layout LyX-Code
+CHARACTER(LEN=*) :: dim_j_name
+\end_layout
+
+\begin_layout Standard
+Defines the name of the second domain dimension as it will appear in file's
+ metadata.
+\end_layout
+
+\begin_layout Subsection*
+ni_glo (mandatory): 
+\begin_inset Flex Emph
+status collapsed
+
+\begin_layout Plain Layout
 integer
 \end_layout
@@ -1606 +2455 @@
 
 \begin_layout Standard
-Define the first dimension of the global domain.
- This attribute is mandatory.
-\end_layout
-
-\begin_layout Subsection*
-nj_glo: 
+Defines the size of the first dimension of the global domain.
+\end_layout
+
+\begin_layout Subsection*
+nj_glo (mandatory): 
 \begin_inset Flex Emph
 status collapsed
@@ -1633 +2481 @@
 
 \begin_layout Standard
-Define the second dimension of the global domain.
- This attribute is mandatory.
-\end_layout
-
-\begin_layout Subsection*
-ibegin: 
+Defines the size of the second dimension of the global domain.
+\end_layout
+
+\begin_layout Subsection*
+ibegin (optional): 
 \begin_inset Flex Emph
 status collapsed
@@ -1660 +2507 @@
 
 \begin_layout Standard
-Define the begining index of the first dimension of the local domain.
- This attribute is optional.
- This must be an integer between 
+Defines the beginning index of the first dimension of a local domain.
+ The attribute takes value between 
 \begin_inset Flex Strong
 status collapsed
@@ -1697 +2543 @@
 
 \begin_layout Subsection*
-ni: 
+ni (optional): 
 \begin_inset Flex Emph
 status collapsed
@@ -1719 +2565 @@
 
 \begin_layout Standard
-Define the first dimension of the local domain.
- This attribute is optional.
- This must be an integer between 
+Defines the size of the first dimension of a local domain.
+ The attribute takes value between 
 \begin_inset Flex Strong
 status collapsed
@@ -1756 +2601 @@
 
 \begin_layout Subsection*
-jbegin: 
+jbegin (optional): 
 \begin_inset Flex Emph
 status collapsed
@@ -1778 +2623 @@
 
 \begin_layout Standard
-Define the beginning index of the second dimension of the local domain.
- This attribute is optional.
- This must be an integer between 
+Defines the beginning index of the second dimension of a local domain.
+ The attribute takes value between 
 \begin_inset Flex Strong
 status collapsed
@@ -1815 +2659 @@
 
 \begin_layout Subsection*
-nj: 
+nj (optional): 
 \begin_inset Flex Emph
 status collapsed
@@ -1837 +2681 @@
 
 \begin_layout Standard
-Define the second dimension of the local domain.
- This attribute is optional.
- This must be an integer between 
+Defines the size of the second dimension of a local domain.
+ he attribute takes value between 
 \begin_inset Flex Strong
 status collapsed
@@ -1874 +2717 @@
 
 \begin_layout Subsection*
-lonvalue_1d: 
+lonvalue_1d (optional): 
 \emph on
 1D-array of double
@@ -1888 +2731 @@
 
 \begin_layout Standard
-Define the value of the longitude on the local domain.
- For a cartesian grid, the size of the array will be 
+Defines the longitude values of a local domain.
+ For a cartesian grid, the array size should be 
 \begin_inset Flex Strong
 status collapsed
@@ -1900 +2743 @@
 
 .
- For a curvilinear grid, the size of the array will be 
+ For a curvilinear grid, the array size should be 
 \begin_inset Flex Strong
 status collapsed
@@ -1915 +2758 @@
 
 .
- This attribute is optional.
-\end_layout
-
-\begin_layout Subsection*
-lonvalue_2d: 
+\end_layout
+
+\begin_layout Subsection*
+lonvalue_2d (optional): 
 \emph on
 2D-array of double
@@ -1933 +2775 @@
 
 \begin_layout Standard
-Define the value of the longitude on the local domain.
- For a cartesian and curvilinear grid, the size of the array will be 
+Defines the longitude values of a local domain.
+ For cartesian and curvilinear grids the array size should be 
 \begin_inset Flex Strong
 status collapsed
@@ -1949 +2791 @@
 
 .
- This attribute is mandatory.
  Only lonvalue_1d or lonvalue_2d can be defined.
-\end_layout
-
-\begin_layout Subsection*
-latvalue_1d: 
+ Also the layout of latitude and longitude should be in conformance with
+ each other: either 1D or 2D.
+\end_layout
+
+\begin_layout Subsection*
+latvalue_1d (optional): 
 \emph on
 1D-array of double
@@ -1968 +2811 @@
 
 \begin_layout Standard
-Define the value of the latitude on the local domain.
+Defines the latitude values of a local domain.
  For a cartesian grid, the size of the array will be nj.
  For a curvilinear grid, the size of the array will be 
@@ -1985 +2828 @@
 
 .
- This attribute is optional.
-\end_layout
-
-\begin_layout Subsection*
-latvalue_2d: 
+ 
+\end_layout
+
+\begin_layout Subsection*
+latvalue_2d (optional): 
 \emph on
 2D-array of double
@@ -2003 +2846 @@
 
 \begin_layout Standard
-Define the value of the latitude on the local domain.
- For a cartesian and a curvilinear grid, the size of the array will be 
+Defines the latitude values of a local domain.
+ For cartesian and curvilinear grids the array size should be 
 \begin_inset Flex Strong
 status collapsed
@@ -2019 +2862 @@
 
 .
- This attribute is mandatory.
  Only latvalue_1d or latvalue_2d can be defined.
-\end_layout
-
-\begin_layout Subsection*
-nvertex: 
+ Also the layout of latitude and longitude should be in conformance with
+ each other: either 1D or 2D.
+\end_layout
+
+\begin_layout Subsection*
+lon_name (optional): 
+\begin_inset Flex Emph
+status collapsed
+
+\begin_layout Plain Layout
+string
+\end_layout
+
+\end_inset
+
+
+\end_layout
+
+\begin_layout Standard
+Fortran: 
+\end_layout
+
+\begin_layout LyX-Code
+CHARACTER(LEN=*) :: lon_name
+\end_layout
+
+\begin_layout Standard
+Defines the longitude name as it will appear in an output file.
+\end_layout
+
+\begin_layout Subsection*
+lat_name (optional): 
+\begin_inset Flex Emph
+status collapsed
+
+\begin_layout Plain Layout
+string
+\end_layout
+
+\end_inset
+
+
+\end_layout
+
+\begin_layout Standard
+Fortran: 
+\end_layout
+
+\begin_layout LyX-Code
+CHARACTER(LEN=*) :: lat_name
+\end_layout
+
+\begin_layout Standard
+Defines the latitude name as it will appear in an output file.
+\end_layout
+
+\begin_layout Subsection*
+nvertex (optional): 
 \emph on
 integer
@@ -2038 +2934 @@
 
 \begin_layout Standard
-Define the the maximum number of vertices for a cell.
- This is useful to specify the boundaries of cells for an unstructured mesh.
- This attribute is optional.
-\end_layout
-
-\begin_layout Subsection*
-bounds_lon_1d: 
+Defines the maximum number of vertices for a grid.
+ The attribute is required for specifying the cell boundaries of unstructured
+ meshes.
+\end_layout
+
+\begin_layout Subsection*
+bounds_lon_1d (optional): 
 \emph on
 2D-array of double
@@ -2058 +2954 @@
 
 \begin_layout Standard
-Longitude value of the vertex of the cells.
+Defines the longitude values of domain vertexes.
+ The attribute 
 \begin_inset Flex Strong
 status collapsed
@@ -2068 +2965 @@
 \end_inset
 
- attribute must also be defined.
- This attribute is optional.
-\end_layout
-
-\begin_layout Subsection*
-bounds_lon_2d: 
+ must be also defined.
+ The array dimensions must be 
+\begin_inset Formula $\textbf{nvertex}\times\textbf{ni}$
+\end_inset
+
+.
+\end_layout
+
+\begin_layout Subsection*
+bounds_lon_2d (optional): 
 \emph on
 3D-array of double
@@ -2087 +2988 @@
 
 \begin_layout Standard
-Longitude value of the vertex of the cells.
+Defines the longitude values of domain vertexes.
+ The attribute 
 \begin_inset Flex Strong
 status collapsed
@@ -2097 +2999 @@
 \end_inset
 
- attribute must also be defined.
- This attribute is optional.
+ must be also defined.
  This attribute is useful when lonvalue_2d is defined.
- Only bounds_lon_1d or bounds_lon_2d can be defined.
-\end_layout
-
-\begin_layout Subsection*
-bounds_lat_1d: 
+ The array dimensions must be 
+\begin_inset Formula $\textbf{nvertex}\times\textbf{ni}\times\textbf{nj}$
+\end_inset
+
+.
+ Either bounds_lon_1d or bounds_lon_2d can be defined.
+\end_layout
+
+\begin_layout Subsection*
+bounds_lat_1d (optional): 
 \emph on
 2D-array of double
@@ -2118 +3024 @@
 
 \begin_layout Standard
-Latitude value of the vertex of the cells.
+Defines the latitude values of domain vertexes.
+ The attribute 
 \begin_inset Flex Strong
 status collapsed
@@ -2128 +3035 @@
 \end_inset
 
- attribute must also be defined.
- This attribute is optional.
-\end_layout
-
-\begin_layout Subsection*
-bounds_lat_2d: 
+ must be also defined.
+ The array dimensions must be 
+\begin_inset Formula $\textbf{nvertex}\times\textbf{ni}$
+\end_inset
+
+.
+\end_layout
+
+\begin_layout Subsection*
+bounds_lat_2d (optional): 
 \emph on
 3D-array of double
@@ -2147 +3058 @@
 
 \begin_layout Standard
-Latitude value of the vertex of the cells.
+Defines the latitude values of domain vertexes.
+ The attribute 
 \begin_inset Flex Strong
 status collapsed
@@ -2157 +3069 @@
 \end_inset
 
- attribute must also be defined.
- This attribute is optional.
- This attribute is useful when latvalue_2d is defined.
- Only bounds_lat_1d or bounds_lat_2d can be defined.
-\end_layout
-
-\begin_layout Subsection*
-area: 
+ must be also defined.
+ The attribute is useful when lonvalue_2d is defined.
+ The array dimensions must be 
+\begin_inset Formula $\textbf{nvertex}\times\textbf{ni}\times\textbf{nj}$
+\end_inset
+
+.
+ Either bounds_lon_1d or bounds_lon_2d can be defined.
+\end_layout
+
+\begin_layout Subsection*
+bounds_lon_name (optional): 
+\begin_inset Flex Emph
+status collapsed
+
+\begin_layout Plain Layout
+string
+\end_layout
+
+\end_inset
+
+
+\end_layout
+
+\begin_layout Standard
+Fortran: 
+\end_layout
+
+\begin_layout LyX-Code
+CHARACTER(LEN=*) :: lon_name
+\end_layout
+
+\begin_layout Standard
+Defines the longitude name of domain vertexes as it will appear in an output
+ file.
+\end_layout
+
+\begin_layout Subsection*
+bounds_lat_name (optional): 
+\begin_inset Flex Emph
+status collapsed
+
+\begin_layout Plain Layout
+string
+\end_layout
+
+\end_inset
+
+
+\end_layout
+
+\begin_layout Standard
+Fortran: 
+\end_layout
+
+\begin_layout LyX-Code
+CHARACTER(LEN=*) :: lat_name
+\end_layout
+
+\begin_layout Standard
+Defines the latitude name of domain vertexes as it will appear in an output
+ file.
+\end_layout
+
+\begin_layout Subsection*
+area (optional): 
 \emph on
 2D-array of double
@@ -2178 +3148 @@
 
 \begin_layout Standard
-Area of the cells.
+The area of cells.
  The size of the array must be 
 \begin_inset Flex Strong
@@ -2194 +3164 @@
 
 .
- This attribute is optional.
-\end_layout
-
-\begin_layout Subsection*
-data_dim: 
+\end_layout
+
+\begin_layout Subsection*
+prec (optional): 
 \emph on
 integer
@@ -2208 +3177 @@
 
 \begin_layout LyX-Code
+INTEGER :: prec
+\end_layout
+
+\begin_layout Standard
+Defines the precision in bytes of domain attributes.
+ Available values are: 2 (integer), 4 (float single precision) and 8 (float
+ double precision).
+ The default value of 8.
+\end_layout
+
+\begin_layout Subsection*
+data_dim (optional): 
+\emph on
+integer
+\end_layout
+
+\begin_layout Standard
+Fortran:
+\end_layout
+
+\begin_layout LyX-Code
 INTEGER :: datadim
 \end_layout
 
 \begin_layout Standard
-Define how a field is stored on memory for the client code.
- 
-\begin_inset Flex Strong
-status collapsed
-
-\begin_layout Plain Layout
-datadim
-\end_layout
-
-\end_inset
-
- value can be 
+Defines how a field is stored on memory for the client code.
+ The value can be either 
 \begin_inset Flex Strong
 status collapsed
@@ -2244 +3224 @@
 
 .
- A value of 
+ The value of 
 \begin_inset Flex Strong
 status collapsed
@@ -2254 +3234 @@
 \end_inset
 
- indicates that the horizontal layer of the field is stored on a 1D array
- as a vector of points.
- A value of 
+ indicates that the horizontal layer of the field is stored as a 1D array.
+ The value of 
 \begin_inset Flex Strong
 status collapsed
@@ -2266 +3245 @@
 \end_inset
 
- indicates that the horizontal layer is stored in a 2D array.
- This attribute is optional.
+ indicates that the horizontal layer is stored as a 2D array.
  The default value is 
 \begin_inset Flex Strong
@@ -2282 +3260 @@
 
 \begin_layout Subsection*
-data_ibegin:
+data_ibegin (optional):
 \emph on
  integer
@@ -2296 +3274 @@
 
 \begin_layout Standard
-Define the beginning index of the field data for the first dimension.
- This attribute is an offset regarding the local domain, so the value can
- be negative.
+Defines the beginning index of field data for the first dimension.
+ This attribute is an offset relative to the local domain, so the value
+ can be negative.
  A negative value indicates that only some valid part of the data will extracted
 , for example in the case of a ghost cell.
@@ -2304 +3282 @@
  stored in memory.
  A 0-value means that the local domain matches the data in memory.
- This attribute is optional and the default value is 0.
- Otherwise 
+ The default value is 0.
+ The attributes 
 \begin_inset Flex Strong
 status collapsed
@@ -2329 +3307 @@
 
 \begin_layout Subsection*
-data_ni: 
+data_ni (optional): 
 \emph on
 integer
@@ -2343 +3321 @@
 
 \begin_layout Standard
-Define the size of the field data for the first dimension.
- This attribute is optional and the default value is 
+Defines the size of field data for the first dimension.
+ The default value is 
 \begin_inset Flex Strong
 status collapsed
@@ -2355 +3333 @@
 
 .
- Otherwise 
+ The attributes 
 \begin_inset Flex Strong
 status collapsed
@@ -2379 +3357 @@
 
 \begin_layout Subsection*
-data_jbegin: 
+data_jbegin (optional): 
 \emph on
 integer
@@ -2393 +3371 @@
 
 \begin_layout Standard
-Define the beginning index of the field data for the second dimension.
- This attribute is take account only if
+Defines the beginning index of field data for the second dimension.
+ The attribute is taken into account only if
 \begin_inset Flex Strong
 status collapsed
@@ -2405 +3383 @@
 
 .
- This attribute is an offset regarding the local domain, so the value can
+ The attribute is an offset relative to the local domain, so the value can
  be negative.
  A negative value indicate that only some valid part of the data will extracted,
@@ -2411 +3389 @@
  A positive value indicate that the local domain is greater than the data
  stored in memory.
- A 0-value means that the local domain match the data in memory.
- This attribute is optional and the default value is 
+ The 0-value means that the local domain matches the data in memory.
+ The default value is 
 \begin_inset Flex Strong
 status collapsed
@@ -2423 +3401 @@
 
 .
- Otherwise 
+ The attributes 
 \begin_inset Flex Strong
 status collapsed
@@ -2447 +3425 @@
 
 \begin_layout Subsection*
-data_nj: 
+data_nj (optional): 
 \emph on
 integer
@@ -2461 +3439 @@
 
 \begin_layout Standard
-Define the size of the field data for the second dimension.
- This attribute is taken account only if 
+Defines the size of field data for the second dimension.
+ The attribute is taken account only if 
 \begin_inset Flex Strong
 status collapsed
@@ -2473 +3451 @@
 
 .
- This attribute is optional and the default value is 
+ The default value is 
 \begin_inset Flex Strong
 status collapsed
@@ -2484 +3462 @@
 
 .
- Otherwise 
+ The attributes 
 \begin_inset Flex Strong
 status collapsed
@@ -2508 +3486 @@
 
 \begin_layout Subsection*
-data_i_index: 
+data_i_index (optional): 
 \emph on
 1D-array of integer
@@ -2522 +3500 @@
 
 \begin_layout Standard
-In case of a compressed horizontal domain, define the indexation the indexation
- of the data for the first dimension.
- The size of the array must be 
-\begin_inset Flex Strong
-status collapsed
-
-\begin_layout Plain Layout
-data_nindex
+In case of a compressed horizontal domain, define the data indexation for
+ the first dimension.
+ The array size must be 
+\begin_inset Flex Strong
+status collapsed
+
+\begin_layout Plain Layout
+data_n
 \end_layout
 
@@ -2535 +3513 @@
 
 .
- This attribute is optional.
-\end_layout
-
-\begin_layout Subsection*
-data_j_index: 
+\end_layout
+
+\begin_layout Subsection*
+data_j_index (optional): 
 \emph on
 1D-array of integer
@@ -2553 +3530 @@
 
 \begin_layout Standard
-In case of a compressed horizontal domain, define the indexation the indexation
- of the data for the second dimension.
- This is meaningful only if 
+In case of a compressed horizontal domain, defines the data indexation for
+ the second dimension.
+ The attribute is meaningful only if 
 \begin_inset Flex Strong
 status collapsed
@@ -2566 +3543 @@
 
 .
- This attribute is optional.
-\end_layout
-
-\begin_layout Subsection*
-mask_1d: 
+\end_layout
+
+\begin_layout Subsection*
+mask_1d (optional): 
 \emph on
 1D-array of bool
@@ -2584 +3560 @@
 
 \begin_layout Standard
-Define the 1-dimension mask of the local domain.
- The attribute is optional.
- By default, none value is masked.
+Defines the 1D mask of a local domain.
  The masked value will be replaced by the value of the field attribute 
 \begin_inset Flex Strong
@@ -2597 +3571 @@
 \end_inset
 
- in the output file.
+ in an output file.
  This value is useful in case a field is stored linearly in memory.
- This attribute is optional.
-\end_layout
-
-\begin_layout Subsection*
-mask_2d: 
+ By default none of the values are masked.
+\end_layout
+
+\begin_layout Subsection*
+mask_2d (optional): 
 \emph on
 2D-array of bool
@@ -2617 +3591 @@
 
 \begin_layout Standard
-Define the mask of the local domain.
- The attribute is optional.
- By default, none value is masked.
- The masked value will be replaced by the value of the field attribute 
+Defines the 2D mask of a local domain.
+ The masked values will be replaced by the value of the field attribute
+ 
 \begin_inset Flex Strong
 status collapsed
@@ -2630 +3603 @@
 \end_inset
 
- in the output file.
+ in an output file.
+ By default, none of the values are masked.
  Only mask_2d or mask_1d can be defined.
 \end_layout
 
 \begin_layout Subsection*
-domain_ref: string
+domain_ref (optional): string
 \end_layout
 
@@ -2647 +3621 @@
 
 \begin_layout Standard
-Define the reference of the domain.
+Defines the reference to a domain.
  All attributes are inherited from the referenced domain with the classic
  inheritance mechanism.
  The value assigned to the referenced domain is transmitted to to current
  domain.
- This attribute is optional.
-\end_layout
-
-\begin_layout Subsection*
-i_index: 
+\end_layout
+
+\begin_layout Subsection*
+i_index (optional): 
 \begin_inset Flex Emph
 status collapsed
@@ -2678 +3651 @@
 
 \begin_layout Standard
-Define the global index of the first dimension of domain which the local
- domain holds.
- This attribute is optional and by default, the size of the array is equal
- to 
+Defines the global index of the first dimension of a local domain held by
+ a process.
+ By default the size of the array is equal to 
 \begin_inset Flex Strong
 status collapsed
@@ -2695 +3667 @@
 
 \begin_layout Subsection*
-j_index: 
+j_index (optional): 
 \begin_inset Flex Emph
 status collapsed
@@ -2717 +3689 @@
 
 \begin_layout Standard
-Define the global index of the second dimension of domain which the local
- domain holds.
- This attribute is optional and by default, the size of the array is equal
- to 
+Defines the global index of the second dimension of a local domain held
+ by a process.
+ By default the size of the array is equal to 
 \begin_inset Flex Strong
 status collapsed
@@ -2731 +3702 @@
 
 .
+\end_layout
+
+\begin_layout Subsection*
+comment (optional): 
+\begin_inset Flex Emph
+status collapsed
+
+\begin_layout Plain Layout
+string
+\end_layout
+
+\end_inset
+
+
+\end_layout
+
+\begin_layout Standard
+Fortran: 
+\end_layout
+
+\begin_layout LyX-Code
+CHARACTER(LEN=*) :: comment
+\end_layout
+
+\begin_layout Standard
+Allows a user to set a comment.
 \end_layout
 
@@ -2738 +3735 @@
 
 \begin_layout Subsection*
-name: string
+name (optional): string
 \end_layout
 
@@ -2750 +3747 @@
 
 \begin_layout Standard
-Define the name of the grid.
- This attribute is actually not used internally.
- Optional attribute.
-\end_layout
-
-\begin_layout Subsection*
-description: string
+Defines the name of a grid.
+\end_layout
+
+\begin_layout Subsection*
+description (optional): string
 \end_layout
 
@@ -2768 +3763 @@
 
 \begin_layout Standard
-Define the description of the grid.
- This attribute is optional.
-\end_layout
-
-\begin_layout Subsection*
-mask_1d: 
+Defines the descriptions of a grid.
+\end_layout
+
+\begin_layout Subsection*
+mask_1d (optional): 
 \emph on
 1D-array of bool
@@ -2787 +3781 @@
 
 \begin_layout Standard
-Define the mask of the local 1-dimension grid.
- Masked value will be replaced by the value of the field attribute 
+Defines the mask of a local 1D grid.
+ Masked values will be replaced by the value of the field attribute 
 \begin_inset Flex Strong
 status collapsed
@@ -2798 +3792 @@
 \end_inset
 
- in the output file.
- This attribute is optional.
- By default, none value is masked.
-\end_layout
-
-\begin_layout Subsection*
-mask_2d: 
+ in an output file.
+ By default none of the value are masked.
+\end_layout
+
+\begin_layout Subsection*
+mask_2d (optional): 
 \emph on
 2D-array of bool
@@ -2818 +3811 @@
 
 \begin_layout Standard
-Define the mask of the local 2-dimension grid.
- Masked value will be replaced by the value of the field attribute 
+Defines the mask of a local 2D grid.
+ Masked values will be replaced by the value of the field attribute 
 \begin_inset Flex Strong
 status collapsed
@@ -2829 +3822 @@
 \end_inset
 
- in the output file.
- This attribute is optional.
- By default, none value is masked.
-\end_layout
-
-\begin_layout Subsection*
-mask_3d: 
+ in an output file.
+ By default none of the value are masked.
+\end_layout
+
+\begin_layout Subsection*
+mask_3d (optional): 
 \emph on
 3D-array of bool
@@ -2849 +3841 @@
 
 \begin_layout Standard
-Define the mask of the local 3-dimension grid.
- Masked value will be replaced by the value of the field attribute 
+Define the mask of a local 3D grid.
+ Masked values will be replaced by the value of the field attribute 
 \begin_inset Flex Strong
 status collapsed
@@ -2860 +3852 @@
 \end_inset
 
- in the output file.
- This attribute is optional.
- By default, none value is masked.
- Only one mask can be defined.
+ in an output file.
+ By default none of the value are masked.
+\end_layout
+
+\begin_layout Subsection*
+mask_4d (optional): 
+\emph on
+4D-array of bool
+\end_layout
+
+\begin_layout Standard
+Fortran:
+\end_layout
+
+\begin_layout LyX-Code
+LOGICAL :: mask_4d(:,:,:)
+\end_layout
+
+\begin_layout Standard
+Define the mask of a local 4D grid.
+ Masked values will be replaced by the value of the field attribute 
+\begin_inset Flex Strong
+status collapsed
+
+\begin_layout Plain Layout
+default_value
+\end_layout
+
+\end_inset
+
+ in an output file.
+ By default none of the value are masked.
+\end_layout
+
+\begin_layout Subsection*
+mask_5d (optional): 
+\emph on
+5D-array of bool
+\end_layout
+
+\begin_layout Standard
+Fortran:
+\end_layout
+
+\begin_layout LyX-Code
+LOGICAL :: mask_5d(:,:,:)
+\end_layout
+
+\begin_layout Standard
+Define the mask of a local 5D grid.
+ Masked values will be replaced by the value of the field attribute 
+\begin_inset Flex Strong
+status collapsed
+
+\begin_layout Plain Layout
+default_value
+\end_layout
+
+\end_inset
+
+ in an output file.
+ By default none of the value are masked.
+\end_layout
+
+\begin_layout Subsection*
+mask_6d (optional): 
+\emph on
+6D-array of bool
+\end_layout
+
+\begin_layout Standard
+Fortran:
+\end_layout
+
+\begin_layout LyX-Code
+LOGICAL :: mask_6d(:,:,:)
+\end_layout
+
+\begin_layout Standard
+Define the mask of a local 6D grid.
+ Masked values will be replaced by the value of the field attribute 
+\begin_inset Flex Strong
+status collapsed
+
+\begin_layout Plain Layout
+default_value
+\end_layout
+
+\end_inset
+
+ in an output file.
+ By default none of the value are masked.
+\end_layout
+
+\begin_layout Subsection*
+mask_7d (optional): 
+\emph on
+7D-array of bool
+\end_layout
+
+\begin_layout Standard
+Fortran:
+\end_layout
+
+\begin_layout LyX-Code
+LOGICAL :: mask_7d(:,:,:)
+\end_layout
+
+\begin_layout Standard
+Define the mask of a local 7D grid.
+ Masked values will be replaced by the value of the field attribute 
+\begin_inset Flex Strong
+status collapsed
+
+\begin_layout Plain Layout
+default_value
+\end_layout
+
+\end_inset
+
+ in an output file.
+ By default none of the value are masked.
+\end_layout
+
+\begin_layout Subsection*
+comment (optional): 
+\begin_inset Flex Emph
+status collapsed
+
+\begin_layout Plain Layout
+string
+\end_layout
+
+\end_inset
+
+
+\end_layout
+
+\begin_layout Standard
+Fortran: 
+\end_layout
+
+\begin_layout LyX-Code
+CHARACTER(LEN=*) :: comment
+\end_layout
+
+\begin_layout Standard
+Allows a user to set a comment.
 \end_layout
 
@@ -2871 +4007 @@
 
 \begin_layout Subsection*
-name: 
+name (optional): 
 \emph on
 string
@@ -2885 +4021 @@
 
 \begin_layout Standard
-Define the 
-\begin_inset Flex Strong
-status collapsed
-
-\begin_layout Plain Layout
-name
-\end_layout
-
-\end_inset
-
- of the field as it will appear in an output file.
- This attribute is optional.
+Defines the name of a field as it will appear in an output file.
  If not present, the identifier 
 \begin_inset Flex Strong
@@ -2911 +4036 @@
 
 \begin_layout Subsection*
-standard_name: 
+standard_name (optional): 
 \emph on
 string
@@ -2925 +4050 @@
 
 \begin_layout Standard
-Define the 
+Defines the 
 \begin_inset Flex Strong
 status collapsed
@@ -2936 +4061 @@
 
  attribute as it will appear in the metadata of an output file.
- This attribute is optional.
-\end_layout
-
-\begin_layout Subsection*
-long_name: 
+\end_layout
+
+\begin_layout Subsection*
+long_name (optional): 
 \emph on
 string
@@ -2954 +4078 @@
 
 \begin_layout Standard
-Define the 
-\begin_inset Flex Strong
-status collapsed
-
-\begin_layout Plain Layout
-long_name
-\end_layout
-
-\end_inset
-
- attribute as it will appear in the metadata of an output file.
- This attribute is optional.
-\end_layout
-
-\begin_layout Subsection*
-unit: 
+Defines the long name as it will appear in the metadata of an output file.
+\end_layout
+
+\begin_layout Subsection*
+expr (optional): 
 \emph on
 string
@@ -2979 +4092 @@
 
 \begin_layout LyX-Code
+CHARACTER(LEN=*) :: expr
+\end_layout
+
+\begin_layout Standard
+Defines the expression for arithmetic or time-integration operations performed
+ on a field.
+ For example if 
+\series bold
+expr=
+\begin_inset Quotes erd
+\end_inset
+
+sqrt(@temp2 - pow(@temp, 2))
+\begin_inset Quotes erd
+\end_inset
+
+
+\series default
+ then the variance will be calculated on the incoming flux of the field
+ 
+\series bold
+temp
+\series default
+ (given that field temp2 that holds the square of temp was correctly defined).
+ 
+\end_layout
+
+\begin_layout Subsection*
+unit (optional): 
+\emph on
+string
+\end_layout
+
+\begin_layout Standard
+Fortran: 
+\end_layout
+
+\begin_layout LyX-Code
 CHARACTER(LEN=*) :: unit
 \end_layout
 
 \begin_layout Standard
-Define the 
-\begin_inset Flex Strong
-status collapsed
-
-\begin_layout Plain Layout
-unit
-\end_layout
-
-\end_inset
-
- of the field.
- This attribute is optional.
-\end_layout
-
-\begin_layout Subsection*
-operation: enumeration
-\emph on
- { once, instant, average, maximum, minimum, accumulate }
+Defines the unit of a field.
+\end_layout
+
+\begin_layout Subsection*
+operation (mandatory): enumeration
+\emph on
+ {once, instant, average, maximum, minimum, accumulate}
 \end_layout
 
@@ -3012 +4152 @@
 
 \begin_layout Standard
-Define the temporal operation applied on the field.
- This attribute is optional, by default no operation is applied.
-\end_layout
-
-\begin_layout Subsection*
-freq_op: 
+Defines the temporal operation applied to a field.
+\end_layout
+
+\begin_layout Subsection*
+freq_op (optional): 
 \emph on
 duration
@@ -3031 +4170 @@
 
 \begin_layout Standard
-Define the frequency of the sampling for the temporal operation, so a field
- value will be used for temporal averaging every 
+Defines the sampling frequency of a temporal operation, so that field values
+ will be used for temporal sampling at frequency 
 \begin_inset Flex Strong
 status collapsed
@@ -3042 +4181 @@
 \end_inset
 
- time step.
- It is very useful for sub-processes called at different frequency in a
- model.
- This attribute is optional, the default value is 
+.
+ It is useful for sub-processes called at different frequency in a model.
+ The default value is equal to the file attribute 
+\begin_inset Flex Strong
+status collapsed
+
+\begin_layout Plain Layout
+output_freq
+\end_layout
+
+\end_inset
+
+ for 
+\begin_inset Flex Strong
+status collapsed
+
+\begin_layout Plain Layout
+instant
+\end_layout
+
+\end_inset
+
+ operations and 
 \begin_inset Flex Strong
 status collapsed
@@ -3055 +4213 @@
 \end_inset
 
-(1 time step).
-\end_layout
-
-\begin_layout Subsection*
-freq_offset: 
+ (1 time step) otherwise.
+\end_layout
+
+\begin_layout Subsection*
+freq_offset (optional): 
 \emph on
 duration
@@ -3073 +4231 @@
 
 \begin_layout Standard
-Define the offset when 
+Defines the offset when 
 \begin_inset Flex Strong
 status collapsed
@@ -3084 +4242 @@
 
  is defined.
- This attribute is optional, the default value is 
-\begin_inset Flex Strong
-status collapsed
-
-\begin_layout Plain Layout
-0ts
-\end_layout
-
-\end_inset
-
-(0 time step).
-\end_layout
-
-\begin_layout Standard
-\begin_inset Formula $0\leq freq\_offset<freq\_op$
-\end_inset
-
-
-\end_layout
-
-\begin_layout Subsection*
-level: 
+ Accepted values lie between 
+\series bold
+0
+\series default
+ and 
+\begin_inset Flex Strong
+status collapsed
+
+\begin_layout Plain Layout
+freq_op
+\end_layout
+
+\end_inset
+
+.
+ The default value is 
+\begin_inset Flex Strong
+status collapsed
+
+\begin_layout Plain Layout
+freq_op - 1ts
+\end_layout
+
+\end_inset
+
+ for fields in the 
+\begin_inset Flex Strong
+status collapsed
+
+\begin_layout Plain Layout
+write
+\end_layout
+
+\end_inset
+
+ mode and 
+\series bold
+0
+\series default
+ for fields in the 
+\begin_inset Flex Strong
+status collapsed
+
+\begin_layout Plain Layout
+read
+\end_layout
+
+\end_inset
+
+ mode.
+\end_layout
+
+\begin_layout Subsection*
+level (optional): 
 \emph on
 integer
@@ -3119 +4309 @@
 
 \begin_layout Standard
-Define the level of output of the field.
- A field will be output only if the file attribute
+Defines the output level of a field.
+ The field will be output only if the file attribute
 \begin_inset Flex Strong
 status collapsed
@@ -3135 +4325 @@
 
 .
- This attribute is optional, the default value is 
+ The default value is 
 \begin_inset Flex Strong
 status collapsed
@@ -3149 +4339 @@
 
 \begin_layout Subsection*
-prec: 
+prec (optional): 
 \emph on
 integer
@@ -3163 +4353 @@
 
 \begin_layout Standard
-Define the precision in byte of a field in an output file.
- Available value are: 2 (integer), 4 (float single precision) and 8 (float
+Defines the precision in bytes of a field in an output file.
+ Available values are: 2 (integer), 4 (float single precision) and 8 (float
  double precision).
-\end_layout
-
-\begin_layout Subsection*
-enabled: 
+ The default value of 8.
+\end_layout
+
+\begin_layout Subsection*
+enabled (optional): 
 \emph on
 bool
@@ -3183 +4374 @@
 
 \begin_layout Standard
-Define if a field must be output or not.
- This attribute is optional, the default value is 
+Defines if a field must be output or not.
+ The default value is 
 \begin_inset Flex Strong
 status collapsed
@@ -3198 +4389 @@
 
 \begin_layout Subsection*
-read_access: 
+check_if_active (optional): 
 \emph on
 bool
@@ -3208 +4399 @@
 
 \begin_layout LyX-Code
+LOGICAL :: check_if_active
+\end_layout
+
+\begin_layout Standard
+Sets a check if a field will be used at a given time step.
+ Activating the check may improve performance for fields which are not used
+ frequently, while it can detoriate performance for fields used at each
+ time step.
+ The default value is false.
+\end_layout
+
+\begin_layout Subsection*
+read_access (optional): 
+\emph on
+bool
+\end_layout
+
+\begin_layout Standard
+Fortran:
+\end_layout
+
+\begin_layout LyX-Code
 LOGICAL :: read_access
 \end_layout
 
 \begin_layout Standard
-Define whether a field can be read from the model or not.
- This attribute is optional, the default value is 
+Defines whether a field can be read from the model or not.
+ The default value is 
 \begin_inset Flex Strong
 status collapsed
@@ -3242 +4455 @@
 
 \begin_layout Subsection*
-field_ref: 
+field_ref (optional): 
 \emph on
 string
@@ -3256 +4469 @@
 
 \begin_layout Standard
-Define a field reference.
- All attributes are inherited from the referenced field after the classical
+Defines the field reference.
+ All attributes will be inherited from the referenced field via the classical
  inheritance mechanism.
- The value assigned to the referenced field is transmitted to to current
- field to perform temporal operation.
- This attribute is optional.
-\end_layout
-
-\begin_layout Subsection*
-grid_ref: 
+ The values assigned to the referenced field will be transmitted to the
+ current field to perform temporal operation.
+\end_layout
+
+\begin_layout Subsection*
+grid_ref (optional): 
 \emph on
 string
@@ -3279 +4491 @@
 
 \begin_layout Standard
-Define on which grid the current field is defined.
- This attribute is optional, if missing, domain_ref and axis_ref must be
- defining.
-\end_layout
-
-\begin_layout Subsection*
-domain_ref: 
+Defines the field grid.
+ Note that only either 
+\begin_inset Flex Strong
+status collapsed
+
+\begin_layout Plain Layout
+grid_ref
+\end_layout
+
+\end_inset
+
+ or a combination of 
+\begin_inset Flex Strong
+status collapsed
+
+\begin_layout Plain Layout
+domain_ref
+\end_layout
+
+\end_inset
+
+, 
+\begin_inset Flex Strong
+status collapsed
+
+\begin_layout Plain Layout
+scalar_ref
+\end_layout
+
+\end_inset
+
+ or 
+\begin_inset Flex Strong
+status collapsed
+
+\begin_layout Plain Layout
+axis_ref
+\end_layout
+
+\end_inset
+
+ can be specified.
+\end_layout
+
+\begin_layout Subsection*
+domain_ref (optional): 
 \emph on
 string
@@ -3299 +4550 @@
 
 \begin_layout Standard
-Define on which horizontal domain the current field is defined.
- This attribute is optional, but if this attribute is defined, 
+Defines the field domain.
+ If the attribute is defined, the attribute 
 \begin_inset Flex Strong
 status collapsed
@@ -3310 +4561 @@
 \end_inset
 
- must not be.
-\end_layout
-
-\begin_layout Subsection*
-axis_ref: 
+ must not be specified.
+\end_layout
+
+\begin_layout Subsection*
+axis_ref (optional): 
 \emph on
 string
@@ -3328 +4579 @@
 
 \begin_layout Standard
-Define on which vertical axis the current field is defined.
- This attribute is optional, but if this attribute is defined, 
-\begin_inset Flex Strong
-status collapsed
-
-\begin_layout Plain Layout
-domain_ref
-\end_layout
-
-\end_inset
-
- must be too and 
+Defines an axis for the current field.
+ If the attribute is defined, the attribute 
 \begin_inset Flex Strong
 status collapsed
@@ -3349 +4590 @@
 \end_inset
 
- must not.
-\end_layout
-
-\begin_layout Subsection*
-grid_path: 
+ must not be specified.
+\end_layout
+
+\begin_layout Subsection*
+scalar_ref (optional): 
 \emph on
 string
@@ -3363 +4604 @@
 
 \begin_layout LyX-Code
+CHARACTER(LEN=*) :: scalar_ref
+\end_layout
+
+\begin_layout Standard
+Defines a scalar domain for the current field.
+ If the attribute is defined, the attribute 
+\begin_inset Flex Strong
+status collapsed
+
+\begin_layout Plain Layout
+grid_ref
+\end_layout
+
+\end_inset
+
+ must not be specified.
+\end_layout
+
+\begin_layout Subsection*
+grid_path (optional): 
+\emph on
+string
+\end_layout
+
+\begin_layout Standard
+Fortran: 
+\end_layout
+
+\begin_layout LyX-Code
 CHARACTER(LEN=*) :: grid_path
 \end_layout
 
 \begin_layout Standard
-Define the way operations passing from a grid to others.
- This attribute is optional.
-\end_layout
-
-\begin_layout Subsection*
-default_value: 
+Defines the way operations pass from a grid to other grids.
+\end_layout
+
+\begin_layout Subsection*
+default_value (optional): 
 \emph on
 double
@@ -3386 +4655 @@
 
 \begin_layout Standard
-Define the value which should be used in place of the missing data of a
- field.
- This attribute is optional.
- If no value was defined, the missing data will be replaced by uninitialized
- values which can lead to undefined behaviors.
-\end_layout
-
-\begin_layout Subsection*
-valid_min: 
+Defines the value which will be used instead of missing field data.
+ If no value is provided, the missing data will be replaced by uninitialized
+ values what can lead to undefined behavior.
+\end_layout
+
+\begin_layout Subsection*
+valid_min (optional): 
 \emph on
 double
@@ -3418 +4685 @@
 \end_inset
 
- attribute value are set to missing value.
-\end_layout
-
-\begin_layout Subsection*
-valid_max: 
+ attribute value will be set to missing value.
+\end_layout
+
+\begin_layout Subsection*
+valid_max (optional): 
 \emph on
 double
@@ -3446 +4713 @@
 \end_inset
 
- attribute value are set to missing value.
-\end_layout
-
-\begin_layout Subsection*
-detect_missing_value: 
+ attribute value will be set to missing value.
+\end_layout
+
+\begin_layout Subsection*
+detect_missing_value (optional): 
 \emph on
 bool
@@ -3464 +4731 @@
 
 \begin_layout Standard
-When XIOS detect a default value in a field, it does not include the value
- in the statistic of the operation, like averaging, minimum, maximum...
-\end_layout
-
-\begin_layout Subsection*
-add_offset: 
+When XIOS detects a default value in a field, it does not take into account
+ the value during arithmetic operations such as averaging, minimum, maximum,
+ etc.
+\end_layout
+
+\begin_layout Subsection*
+add_offset (optional): 
 \emph on
 double
@@ -3483 +4751 @@
 
 \begin_layout Standard
-Set the 
+Sets the 
 \begin_inset Flex Strong
 status collapsed
@@ -3493 +4761 @@
 \end_inset
 
- metadata CF attribute in the output file.
+ metadata CF attribute in an output file.
  In output, the 
 \begin_inset Flex Strong
@@ -3504 +4772 @@
 \end_inset
 
- value is subtracted to the field values.
+ value will be subtracted from the field values.
 \end_layout
 
@@ -3522 +4790 @@
 
 \begin_layout Standard
-Set the 
+Sets the 
 \begin_inset Flex Strong
 status collapsed
@@ -3532 +4800 @@
 \end_inset
 
- metadata CF attribute in the output file.
- In output, the field values are divided by the 
+ metadata CF attribute in an output file.
+ In output, the field values will be divided by the 
 \begin_inset Flex Strong
 status collapsed
@@ -3547 +4815 @@
 
 \begin_layout Subsection*
-compression_level: 
+compression_level (optional): 
 \emph on
 integer
@@ -3561 +4829 @@
 
 \begin_layout Standard
-Define whether the field should be compressed using NetCDF-4 built-in compressio
-n.
+Defines whether a field should be compressed using NetCDF-4 built-in compression.
  The compression level must range from 0 to 9.
- An higher compression level means a better compression at the cost of using
+ A higher compression level means a better compression at the cost of using
  more processing power.
- This attribute is optional, the default value is inherited from the file
- attribute 
+ The default value is inherited from the file attribute 
 \series bold
 compression_level
@@ -3575 +4841 @@
 
 \begin_layout Subsection*
-indexed_output: 
+indexed_output (optional): 
 \emph on
 bool
@@ -3589 +4855 @@
 
 \begin_layout Standard
-Define whether the field data must be outputted as an indexed grid instead
- of a full grid whenever possible.
- This attribute is optional, the default value is 
+Defines whether field data must be output as an indexed grid instead of
+ a full grid whenever possible.
+ The default value is 
 \series bold
 \emph on
@@ -3601 +4867 @@
 
 \begin_layout Subsection*
-ts_enabled: 
+ts_enabled (optional): 
 \emph on
 bool
@@ -3615 +4881 @@
 
 \begin_layout Standard
-Define whether the field can be outputted as a timeserie if requested.
- This attribute is optional, the default value is 
+Defines whether a field can be output as a timeseries.
+ The default value is 
 \series bold
 \emph on
@@ -3626 +4892 @@
 
 \begin_layout Subsection*
-ts_split_freq: 
+ts_split_freq (optional): 
 \emph on
 duration
@@ -3640 +4906 @@
 
 \begin_layout Standard
-Define the splitting frequency that should be used for the timeserie if
+Defines the splitting frequency that should be used for a timeseries if
  it has been requested.
- This attribute is optional, by default this value is inherited from the
- file 
+ By default the attribute value is inherited from the file attribute 
 \series bold
 split_freq
@@ -3650 +4915 @@
 \end_layout
 
+\begin_layout Subsection*
+cell_methods (optional): 
+\emph on
+string
+\end_layout
+
+\begin_layout Standard
+Fortran: 
+\end_layout
+
+\begin_layout LyX-Code
+CHARACTER(LEN=*) :: cell_methods
+\end_layout
+
+\begin_layout Standard
+Defines the cell methods field attribute.
+\end_layout
+
+\begin_layout Subsection*
+cell_methods_mode (optional): enumeration
+\emph on
+ {overwrite, prefix, suffix, none}
+\end_layout
+
+\begin_layout Standard
+Fortran:
+\end_layout
+
+\begin_layout LyX-Code
+CHARACTER(LEN=*) :: cell_methods_mode
+\end_layout
+
+\begin_layout Standard
+Defines the cell methods mode of a field.
+\end_layout
+
+\begin_layout Subsection*
+comment (optional): 
+\begin_inset Flex Emph
+status collapsed
+
+\begin_layout Plain Layout
+string
+\end_layout
+
+\end_inset
+
+
+\end_layout
+
+\begin_layout Standard
+Fortran: 
+\end_layout
+
+\begin_layout LyX-Code
+CHARACTER(LEN=*) :: comment
+\end_layout
+
+\begin_layout Standard
+Allows a user to set a comment.
+\end_layout
+
 \begin_layout Section
 Variable attribute reference
@@ -3655 +4982 @@
 
 \begin_layout Subsection*
-name: 
+name (optional): 
 \emph on
 string
@@ -3669 +4996 @@
 
 \begin_layout Standard
-Define the 
-\begin_inset Flex Strong
-status collapsed
-
-\begin_layout Plain Layout
-name
-\end_layout
-
-\end_inset
-
- of the variable as it will appear in an output file.
- This attribute is optional.
- If not present, the 
+Defines the name of a variable as it will appear in an output file.
+ If not present, the variable 
 \begin_inset Flex Strong
 status collapsed
@@ -3691 +5007 @@
 \end_inset
 
- will be used instead.
-\end_layout
-
-\begin_layout Subsection*
-type: enumeration { bool, int, int32, int16, int64, float, double, string
- }
+ will be used.
+\end_layout
+
+\begin_layout Subsection*
+type (mandatory): enumeration {bool, int, int32, int16, int64, float, double,
+ string}
 \end_layout
 
@@ -3708 +5024 @@
 
 \begin_layout Standard
-Define the 
-\begin_inset Flex Strong
-status collapsed
-
-\begin_layout Plain Layout
-type
-\end_layout
-
-\end_inset
-
- of the variable.
+Defines the type of a variable.
  Note that the 
 \series bold
@@ -3732 +5038 @@
 \emph default
 .
- This attribute is mandatory.
+\end_layout
+
+\begin_layout Subsection*
+ts_target (optional): enumeration {file, field, both, none}
+\end_layout
+
+\begin_layout Standard
+Fortran:
+\end_layout
+
+\begin_layout LyX-Code
+CHARACTER(LEN=*) :: ts_target
 \end_layout
 
@@ -3740 +5057 @@
 
 \begin_layout Subsection*
-name: 
+name (mandatory): 
 \emph on
 string
@@ -3754 +5071 @@
 
 \begin_layout Standard
-Define the name of the file.
- This attribute is mandatory.
-\end_layout
-
-\begin_layout Subsection*
-description: 
+Defines the name of a file.
+\end_layout
+
+\begin_layout Subsection*
+description (optional): 
 \emph on
 string
@@ -3773 +5089 @@
 
 \begin_layout Standard
-Define the description of the file.
- This attribute is optional.
-\end_layout
-
-\begin_layout Subsection*
-name_suffix: 
+Defines the description of a file.
+\end_layout
+
+\begin_layout Subsection*
+name_suffix (optional): 
 \emph on
 string
@@ -3792 +5107 @@
 
 \begin_layout Standard
-Define a suffix to add to the name of the file.
- This attribute is optional.
-\end_layout
-
-\begin_layout Subsection*
-min_digits: 
+Defines a suffix added to the file name.
+\end_layout
+
+\begin_layout Subsection*
+min_digits (optional): 
 \emph on
 integer
@@ -3811 +5125 @@
 
 \begin_layout Standard
-For multiple_file, define the minimum digits composing the suffix defining
- the rank of the server, which will be happened to the name of the file.
- This attribute is optional and the default value is 
+For the 
+\series bold
+multiple_file
+\series default
+ mode defines the minimum number of digits of the suffix describing the
+ server rank which will be appended to the file name.
+ The default value is 
 \begin_inset Flex Strong
 status collapsed
@@ -3823 +5141 @@
 \end_inset
 
+ (no server rank suffix is added).
+\end_layout
+
+\begin_layout Subsection*
+output_freq (mandatory): 
+\emph on
+duration
+\end_layout
+
+\begin_layout Standard
+Fortran:
+\end_layout
+
+\begin_layout LyX-Code
+TYPE(xios_duration) :: output_freq
+\end_layout
+
+\begin_layout Standard
+Defines the output frequency for the current file.
+\end_layout
+
+\begin_layout Subsection*
+output_level (optional): 
+\emph on
+integer
+\end_layout
+
+\begin_layout Standard
+Fortran:
+\end_layout
+
+\begin_layout LyX-Code
+INTEGER :: output_level
+\end_layout
+
+\begin_layout Standard
+Defines the output level for all fields of the current file.
+ The field is output only if the field attribute 
+\series bold
+level
+\series default
+ is less or equal to the file attribute 
+\series bold
+output_level
+\series default
 .
 \end_layout
 
 \begin_layout Subsection*
-output_freq: 
+sync_freq (optional): 
 \emph on
 duration
@@ -3837 +5200 @@
 
 \begin_layout LyX-Code
-TYPE(xios_duration) :: output_freq
-\end_layout
-
-\begin_layout Standard
-Define the output frequency for the current file.
- This attribute is mandatory.
-\end_layout
-
-\begin_layout Subsection*
-output_level: 
-\emph on
-integer
-\end_layout
-
-\begin_layout Standard
-Fortran:
-\end_layout
-
-\begin_layout LyX-Code
-INTEGER :: output_level
-\end_layout
-
-\begin_layout Standard
-Define an output level for the field defining inside the current file.
- Field is output only if the field attribute 
-\begin_inset Formula $level\leq output\_level$
-\end_inset
-
-.
-\end_layout
-
-\begin_layout Subsection*
-sync_freq: 
+TYPE(xios_duration) :: sync_freq
+\end_layout
+
+\begin_layout Standard
+Defines the frequency for flushing the current file onto a disk.
+ It may result in poor performances but data will be written even if a file
+ is not yet closed.
+\end_layout
+
+\begin_layout Subsection*
+split_freq (optional): 
 \emph on
 duration
@@ -3879 +5220 @@
 
 \begin_layout LyX-Code
-TYPE(xios_duration) :: sync_freq
-\end_layout
-
-\begin_layout Standard
-Define the frequency for flushing the current file onto disk.
- It may result bad performance but data are wrote even if the file will
- not be closed.
- This attribute is optional.
-\end_layout
-
-\begin_layout Subsection*
-split_freq: 
-\emph on
-duration
-\end_layout
-
-\begin_layout Standard
-Fortran:
-\end_layout
-
-\begin_layout LyX-Code
 TYPE(xios_duration) :: split_freq
 \end_layout
 
 \begin_layout Standard
-Define the time frequency for splitting the current file.
- In that case, the start and end dates are added to the file 
+Defines the frequency for splitting the current file.
+ The start and end dates will be added to the file name (see 
+\begin_inset Flex Emph
+status collapsed
+
+\begin_layout Plain Layout
+
 \series bold
-name
-\series default
- (see 
-\begin_inset Flex Emph
-status collapsed
-
-\begin_layout Plain Layout
-
-\series bold
 \emph on
 split_freq_format
@@ -3923 +5239 @@
 
  attribute).
- This attribute is optional, by default no splitting is done.
-\end_layout
-
-\begin_layout Subsection*
-split_freq_format: 
+ By default no splitting is done.
+\end_layout
+
+\begin_layout Subsection*
+split_freq_format (optional): 
 \emph on
 string
@@ -3941 +5257 @@
 
 \begin_layout Standard
-Define the format of the split date suffixed to the file.
- Can contain any character, 
+Defines the format of the split date suffixed to a file.
+ It can contain any character, 
 \emph on
 
@@ -4027 +5343 @@
 
  by the number of full days since the time origin.
- This attribute is optional and the default behavior is to create a suffix
- with the date until the smaller non zero unit.
+ The default behavior is to create a suffix with the date until the smaller
+ non zero unit.
  For example, in one day split frequency, the hour, minute and second will
  not appear in the suffix, only year, month and day.
@@ -4034 +5350 @@
 
 \begin_layout Subsection*
-enabled: 
+split_start_offset(optional): 
+\emph on
+duration
+\end_layout
+
+\begin_layout Standard
+Fortran:
+\end_layout
+
+\begin_layout LyX-Code
+TYPE(xios_duration) :: split_start_offset
+\end_layout
+
+\begin_layout Standard
+Defines the offset of file splitting.
+ 
+\end_layout
+
+\begin_layout Subsection*
+split_end_offset(optional): 
+\emph on
+duration
+\end_layout
+
+\begin_layout Standard
+Fortran:
+\end_layout
+
+\begin_layout LyX-Code
+TYPE(xios_duration) :: split_end_offset
+\end_layout
+
+\begin_layout Subsection*
+split_last_date (optional): 
+\emph on
+string
+\end_layout
+
+\begin_layout Standard
+Fortran:
+\end_layout
+
+\begin_layout LyX-Code
+CHARACTER(LEN=*) :: split_last_date
+\end_layout
+
+\begin_layout Subsection*
+enabled (optional): 
 \emph on
 bool
@@ -4048 +5411 @@
 
 \begin_layout Standard
-Define if a file must be written/read or not.
- This attribute is optional, the default value is 
+Defines if a file must be written/read or not.
+ The default value is 
 \begin_inset Flex Strong
 status collapsed
@@ -4063 +5426 @@
 
 \begin_layout Subsection*
-mode: 
-\emph on
-enumeration { read, write }
+mode (optional): 
+\emph on
+enumeration {read, write}
 \end_layout
 
@@ -4077 +5440 @@
 
 \begin_layout Standard
-Define whether the file will be read or written.
- This attribute is optional, the default value is 
+Defines whether a file will be read or written.
+ The default value is 
 \begin_inset Flex Strong
 status collapsed
@@ -4092 +5455 @@
 
 \begin_layout Subsection*
-type: 
-\emph on
-enumeration { one_file, multiple_file }
+type (mandatory): 
+\emph on
+enumeration {one_file, multiple_file}
 \end_layout
 
@@ -4106 +5469 @@
 
 \begin_layout Standard
-Define the type of the file: 
+Defines the type of a file: 
 \begin_inset Flex Strong
 status collapsed
@@ -4131 +5494 @@
 
 : one single global file is wrote using netcdf4 parallel access.
- This attribute is mandatory.
-\end_layout
-
-\begin_layout Subsection*
-format: 
-\emph on
-enumeration { netcdf4, netcdf4_classic }
-\end_layout
-
-\begin_layout Standard
-Fortran:
-\end_layout
-
-\begin_layout LyX-Code
-CHARACTER(LEN=*) :: type
-\end_layout
-
-\begin_layout Standard
-Define the format of the file: 
+\end_layout
+
+\begin_layout Subsection*
+format (optional): 
+\emph on
+enumeration {netcdf4, netcdf4_classic}
+\end_layout
+
+\begin_layout Standard
+Fortran:
+\end_layout
+
+\begin_layout LyX-Code
+CHARACTER(LEN=*) :: format
+\end_layout
+
+\begin_layout Standard
+Define the format of a file: 
 \begin_inset Flex Strong
 status collapsed
@@ -4178 +5540 @@
 
 : the classic NetCDF format will be used.
- The attribute is optional, the default value is 
+ The default value is 
 \series bold
 \emph on
@@ -4210 +5572 @@
 
 \begin_layout Subsection*
-par_access: 
-\emph on
-enumeration { collective, independent }
+par_access (optional): 
+\emph on
+enumeration {collective, independent}
 \end_layout
 
@@ -4224 +5586 @@
 
 \begin_layout Standard
-For parallel writing, define which type of MPI calls will be used.
- This attribute is optional, the default value is 
+For parallel writing, defines which type of MPI calls will be used.
+ The default value is 
 \begin_inset Flex Strong
 status collapsed
@@ -4241 +5603 @@
 
 \begin_layout Subsection*
-append: 
+read_metadata_par (optional): 
 \emph on
 bool
@@ -4251 +5613 @@
 
 \begin_layout LyX-Code
+LOGICAL :: read_metadata_par
+\end_layout
+
+\begin_layout Standard
+For files in the read mode, defines if parallel or serial I/O will be used
+ by model processes for reading file metadata.
+ The default value is false implying serial I/O for reading metadata.
+\end_layout
+
+\begin_layout Subsection*
+convention (optional): 
+\emph on
+enumeration {CF, UGRID}
+\end_layout
+
+\begin_layout Standard
+Fortran:
+\end_layout
+
+\begin_layout LyX-Code
+CHARACTER(LEN=*) :: convention
+\end_layout
+
+\begin_layout Standard
+Defines the file conventions.
+ By default the CF conventions are followed.
+\end_layout
+
+\begin_layout Subsection*
+convention_str (optional): 
+\emph on
+string
+\end_layout
+
+\begin_layout Standard
+Fortran:
+\end_layout
+
+\begin_layout LyX-Code
+CHARACTER(LEN=*) :: convention_str
+\end_layout
+
+\begin_layout Standard
+Defines the 
+\series bold
+Conventions 
+\series default
+attribute to be added to file global attributes.
+\end_layout
+
+\begin_layout Subsection*
+append (optional): 
+\emph on
+bool
+\end_layout
+
+\begin_layout Standard
+Fortran:
+\end_layout
+
+\begin_layout LyX-Code
 LOGICAL :: append
 \end_layout
 
 \begin_layout Standard
-Define whether the output data is to be appended at the end of the file
- if it already exists or if the existing file is to be overwritten.
- This attribute is optional, the default value is 
+Defines whether data is to be appended at the end of a file if it already
+ exists or if the existing file is to be overwritten.
+ The default value is 
 \begin_inset Flex Strong
 status collapsed
@@ -4273 +5696 @@
 
 \begin_layout Subsection*
-compression_level: 
+compression_level (optional): 
 \emph on
 integer
@@ -4287 +5710 @@
 
 \begin_layout Standard
-Define whether the fields should be compressed using NetCDF-4 built-in compressi
-on by default.
+Defines whether the fields should be compressed using NetCDF-4 built-in
+ compression by default.
  The compression level must range from 0 to 9.
- An higher compression level means a better compression at the cost of using
+ A higher compression level means a better compression at the cost of using
  more processing power.
- This attribute is optional, the default value is 
+ The default value is 
 \begin_inset Flex Strong
 status collapsed
@@ -4308 +5731 @@
 
 \begin_layout Subsection*
-time_counter: 
-\emph on
-enumeration { centered, instant, record, none }
+time_counter (optional): 
+\emph on
+enumeration {centered, instant, record, exclusive, centered_exclusive, instant_e
+xclusive, none}
 \end_layout
 
@@ -4322 +5746 @@
 
 \begin_layout Standard
-Define how the 
+Defines how the 
 \begin_inset Quotes eld
 \end_inset
@@ -4330 +5754 @@
 \end_inset
 
- variable will be outputted:
+ variable will be output:
 \end_layout
 
@@ -4340 +5764 @@
 \series default
 \emph default
-: use centered times
+: use centered times (default option for all field operations except for
+ instant)
 \end_layout
 
@@ -4350 +5775 @@
 \series default
 \emph default
-: use instant times
+: use instant times (default option for field operation 
+\series bold
+instant
+\series default
+)
 \end_layout
 
@@ -4366 +5795 @@
 
 \series bold
+\shape italic
+centered_exclusive: 
+\series default
+\shape default
+do not include centered times into an output file
+\end_layout
+
+\begin_layout Itemize
+
+\series bold
+\shape italic
+\emph on
+instant_
+\emph default
+exclusive: 
+\series default
+\shape default
+do not include instant times into an output file
+\end_layout
+
+\begin_layout Itemize
+
+\series bold
+\shape italic
+exclusive: 
+\series default
+\shape default
+include neither instant times nor centered times into an output file
+\end_layout
+
+\begin_layout Itemize
+
+\series bold
 \emph on
 none
@@ -4374 +5836 @@
 
 \begin_layout Standard
-This attribute is optional, the default value is 
+The default value is 
 \series bold
 \emph on
@@ -4384 +5846 @@
 
 \begin_layout Subsection*
-time_counter_name: 
+time_counter_name (optional): 
 \emph on
 string
@@ -4398 +5860 @@
 
 \begin_layout Standard
-Define the name of the time counter.
- This attribute is optional.
-\end_layout
-
-\begin_layout Subsection*
-timeseries: 
-\emph on
-enumeration { none, only, both, exclusive }
+Define the name of a time counter.
+\end_layout
+
+\begin_layout Subsection*
+timeseries (optional): 
+\emph on
+enumeration {none, only, both, exclusive}
 \end_layout
 
@@ -4417 +5878 @@
 
 \begin_layout Standard
-Define whether the timeseries must be outputted:
+Defines whether the timeseries must be output:
 \end_layout
 
@@ -4427 +5888 @@
 \series default
 \emph default
-: no timeseries are outputted, only the regular file
+: no timeseries is outputted, only the regular file
 \end_layout
 
@@ -4437 +5898 @@
 \series default
 \emph default
-: only the timeseries are outputted, the regular file is not created
+: only the timeseries is outputted, the regular file is not created
 \end_layout
 
@@ -4457 +5918 @@
 \series default
 \emph default
-: the timeseries are outputted and a regular file is created with only the
- fields which were not marked for output as a timeserie (if any).
-\end_layout
-
-\begin_layout Standard
-This attribute is optional, the default value is 
+: the timeseries is outputted and a regular file is created with only the
+ fields which were not marked for output as a timeseries (if any).
+\end_layout
+
+\begin_layout Standard
+The default value is 
 \series bold
 \emph on
@@ -4472 +5933 @@
 
 \begin_layout Subsection*
-ts_prefix: 
+ts_prefix (optional): 
 \emph on
 string
@@ -4486 +5947 @@
 
 \begin_layout Standard
-Define the prefix to use for the name of the timeseries files.
- This attribute is optional, by default the file 
-\series bold
-name
-\series default
- will be used.
-\end_layout
-
-\begin_layout Subsection*
-record_offset: 
+Defines the prefix to use for the name of the timeseries files.
+ By default the file name will be used.
+\end_layout
+
+\begin_layout Subsection*
+time_units (optional): 
+\emph on
+enumeration {seconds, days}
+\end_layout
+
+\begin_layout Standard
+Fortran:
+\end_layout
+
+\begin_layout LyX-Code
+CHARACTER(LEN=*) :: time_units
+\end_layout
+
+\begin_layout Subsection*
+record_offset (optional): 
 \emph on
 integer
@@ -4509 +5980 @@
 
 \begin_layout Standard
-Define offset of record from the beginning record.
- This attribute is optional, by default, its value is 0.
+Defines the offset of a record from the beginning record.
+ The default value is 0.
+\end_layout
+
+\begin_layout Subsection*
+cyclic (optional): 
+\emph on
+bool
+\end_layout
+
+\begin_layout Standard
+Fortran:
+\end_layout
+
+\begin_layout LyX-Code
+LOGICAL :: cyclic
+\end_layout
+
+\begin_layout Standard
+If the option is activated for fields to be read, then upon reaching the
+ last time record, reading will continue 
+\begin_inset Quotes eld
+\end_inset
+
+cycle
+\begin_inset Quotes erd
+\end_inset
+
+ at the first time record.
+ The default value is false.
+\end_layout
+
+\begin_layout Subsection*
+time_stamp_name (optional): 
+\begin_inset Flex Emph
+status collapsed
+
+\begin_layout Plain Layout
+string
+\end_layout
+
+\end_inset
+
+
+\end_layout
+
+\begin_layout Standard
+Fortran: 
+\end_layout
+
+\begin_layout LyX-Code
+CHARACTER(LEN=*) :: time_stamp_name
+\end_layout
+
+\begin_layout Standard
+Defines the timestamp name of the date and time when the program was executed
+ which will be written into an output file.
+ The default value is 
+\begin_inset Quotes eld
+\end_inset
+
+timeStamp
+\begin_inset Quotes erd
+\end_inset
+
+.
+\end_layout
+
+\begin_layout Subsection*
+time_stamp_format (optional): 
+\begin_inset Flex Emph
+status collapsed
+
+\begin_layout Plain Layout
+string
+\end_layout
+
+\end_inset
+
+
+\end_layout
+
+\begin_layout Standard
+Fortran: 
+\end_layout
+
+\begin_layout LyX-Code
+CHARACTER(LEN=*) :: time_stamp_format
+\end_layout
+
+\begin_layout Standard
+Defines the timestamp format of the date and time when the program was executed
+ to be written into an output file.
+ It can contain any character.
+ 
+\emph on
+
+\begin_inset Flex Code
+status collapsed
+
+\begin_layout Plain Layout
+%Y
+\end_layout
+
+\end_inset
+
+
+\emph default
+ will be replaced by the 4-digit year (4 digits), while 
+\emph on
+
+\begin_inset Flex Code
+status collapsed
+
+\begin_layout Plain Layout
+%y
+\end_layout
+
+\end_inset
+
+
+\emph default
+ will be replaced by the 2-digit year.
+ 
+\begin_inset Flex Code
+status collapsed
+
+\begin_layout Plain Layout
+%m
+\end_layout
+
+\end_inset
+
+ will be by the 2-digit month, while %b will be replaced by the 3-character
+ month.
+ 
+\begin_inset Flex Code
+status collapsed
+
+\begin_layout Plain Layout
+%d
+\end_layout
+
+\end_inset
+
+ will be replaced by the day (2 char), 
+\begin_inset Flex Code
+status collapsed
+
+\begin_layout Plain Layout
+%H
+\end_layout
+
+\end_inset
+
+ by the hour (2 char), 
+\begin_inset Flex Code
+status collapsed
+
+\begin_layout Plain Layout
+%M
+\end_layout
+
+\end_inset
+
+ by the minute (2 char), 
+\begin_inset Flex Code
+status collapsed
+
+\begin_layout Plain Layout
+%S
+\end_layout
+
+\end_inset
+
+ by the number of seconds, 
+\begin_inset Flex Code
+status collapsed
+
+\begin_layout Plain Layout
+%D
+\end_layout
+
+\end_inset
+
+ by the date in the MM/DD/YY format.
+\end_layout
+
+\begin_layout Subsection*
+uuid_name (optional): 
+\begin_inset Flex Emph
+status collapsed
+
+\begin_layout Plain Layout
+string
+\end_layout
+
+\end_inset
+
+
+\end_layout
+
+\begin_layout Standard
+Fortran: 
+\end_layout
+
+\begin_layout LyX-Code
+CHARACTER(LEN=*) :: uuid_name
+\end_layout
+
+\begin_layout Standard
+Defines the name of file's UUID.
+\end_layout
+
+\begin_layout Subsection*
+uuid_format (optional): 
+\begin_inset Flex Emph
+status collapsed
+
+\begin_layout Plain Layout
+string
+\end_layout
+
+\end_inset
+
+
+\end_layout
+
+\begin_layout Standard
+Fortran: 
+\end_layout
+
+\begin_layout LyX-Code
+CHARACTER(LEN=*) :: uuid_format
+\end_layout
+
+\begin_layout Standard
+Defines the format of file's UUID.
+\end_layout
+
+\begin_layout Subsection*
+comment (optional): 
+\begin_inset Flex Emph
+status collapsed
+
+\begin_layout Plain Layout
+string
+\end_layout
+
+\end_inset
+
+
+\end_layout
+
+\begin_layout Standard
+Fortran: 
+\end_layout
+
+\begin_layout LyX-Code
+CHARACTER(LEN=*) :: comment
+\end_layout
+
+\begin_layout Standard
+Allows a user to set a comment.
 \end_layout
 
@@ -4518 +6251 @@
 
 \begin_layout Subsection
+reduce_scalar_to_scalar
+\end_layout
+
+\begin_layout Subsection*
+operation (mandatory): 
+\emph on
+enumeration {min, max, sum, average}
+\end_layout
+
+\begin_layout Standard
+Fortran:
+\end_layout
+
+\begin_layout LyX-Code
+CHARACTER(LEN=*) :: operation
+\end_layout
+
+\begin_layout Standard
+Defines a reduction operation performed on a scalar across model processes.
+ (It is analogous to MPI_Allreduce.)
+\end_layout
+
+\begin_layout Subsection
+extract_axis_to_scalar
+\end_layout
+
+\begin_layout Subsection*
+position: 
+\emph on
+integer
+\end_layout
+
+\begin_layout Standard
+Fortran: 
+\end_layout
+
+\begin_layout LyX-Code
+INTEGER :: position
+\end_layout
+
+\begin_layout Standard
+Global index of a point on an axis to be extracted into a scalar.
+\end_layout
+
+\begin_layout Standard
+
+\end_layout
+
+\begin_layout Subsection
 interpolate_axis
 \end_layout
 
 \begin_layout Subsection*
-type: 
+type (optional): 
 \emph on
 string
@@ -4536 +6318 @@
 
 \begin_layout Standard
-Define the type of interpolation on an axis.
- This attribute is optional.
-\end_layout
-
-\begin_layout Subsection*
-order: 
+Defines the interpolation type on an axis.
+ For now only polynomial interpolation is available.
+\end_layout
+
+\begin_layout Subsection*
+order (optional): 
 \emph on
 integer
@@ -4555 +6337 @@
 
 \begin_layout Standard
-Define a order of interpolation.
- This attribute is optional.
+Defines the order of interpolation.
  The default value is 2.
 \end_layout
 
+\begin_layout Subsection*
+coordinate (optional): 
+\emph on
+string
+\end_layout
+
+\begin_layout Standard
+Fortran:
+\end_layout
+
+\begin_layout LyX-Code
+CHARACTER(LEN=*) :: coordinate
+\end_layout
+
+\begin_layout Standard
+Defines the coordinate associated with an axis on which interpolation will
+ be performed.
+\end_layout
+
 \begin_layout Subsection
-inverse_axis
+reduce_axis_to_axis
+\end_layout
+
+\begin_layout Subsection*
+operation (mandatory): 
+\emph on
+enumeration {min, max, sum, average}
+\end_layout
+
+\begin_layout Standard
+Fortran:
+\end_layout
+
+\begin_layout LyX-Code
+CHARACTER(LEN=*) :: operation
+\end_layout
+
+\begin_layout Standard
+Defines a reduction operation performed on an axis across model processes.
+ (It is analogous to MPI_Allreduce.)
+\end_layout
+
+\begin_layout Subsection
+reduce_axis_to_scalar
+\end_layout
+
+\begin_layout Standard
+Reduces data defined on an axis into a scalar value.
+\end_layout
+
+\begin_layout Subsection*
+operation (mandatory): 
+\emph on
+enumeration {min, max, sum, average}
+\end_layout
+
+\begin_layout Standard
+Fortran:
+\end_layout
+
+\begin_layout LyX-Code
+CHARACTER(LEN=*) :: operation
 \end_layout
 
@@ -4569 +6410 @@
 
 \begin_layout Subsection*
-begin: 
+begin (optional): 
 \begin_inset Flex Emph
 status collapsed
@@ -4591 +6432 @@
 
 \begin_layout Standard
-Define the begining index of the zoomed region on global axis.
- This attribute is optional.
- This must be an integer between 
+Defines the beginning index of a zoomed region on a global axis.
+ The attribute value should be an integer between 
 \begin_inset Flex Strong
 status collapsed
@@ -4609 +6449 @@
 \begin_layout Plain Layout
 ni_glo-1
-\end_layout
-
-\end_inset
-
- of associated axis.
- If not specified the default value is 
-\begin_inset Flex Strong
-status collapsed
-
-\begin_layout Plain Layout
-0
-\end_layout
-
-\end_inset
-
-.
-\end_layout
-
-\begin_layout Subsection*
-n: 
-\begin_inset Flex Emph
-status collapsed
-
-\begin_layout Plain Layout
-integer
-\end_layout
-
-\end_inset
-
-
-\end_layout
-
-\begin_layout Standard
-Fortran:
-\end_layout
-
-\begin_layout LyX-Code
-INTEGER :: n
-\end_layout
-
-\begin_layout Standard
-Define the size of zoomed region on global axis.
- This attribute is optional.
- This must be an integer between 
-\begin_inset Flex Strong
-status collapsed
-
-\begin_layout Plain Layout
-1
-\end_layout
-
-\end_inset
-
-and 
-\begin_inset Flex Strong
-status collapsed
-
-\begin_layout Plain Layout
-nj_glo
 \end_layout
 
@@ -4678 +6459 @@
 
 \begin_layout Plain Layout
+0
+\end_layout
+
+\end_inset
+
+.
+\end_layout
+
+\begin_layout Subsection*
+n (optional): 
+\begin_inset Flex Emph
+status collapsed
+
+\begin_layout Plain Layout
+integer
+\end_layout
+
+\end_inset
+
+
+\end_layout
+
+\begin_layout Standard
+Fortran:
+\end_layout
+
+\begin_layout LyX-Code
+INTEGER :: n
+\end_layout
+
+\begin_layout Standard
+Defines the size of a zoomed region on a global axis.
+ The attribute value should be an integer between 
+\begin_inset Flex Strong
+status collapsed
+
+\begin_layout Plain Layout
+1
+\end_layout
+
+\end_inset
+
+and 
+\begin_inset Flex Strong
+status collapsed
+
+\begin_layout Plain Layout
 nj_glo
 \end_layout
@@ -4684 +6512 @@
 
  of the associated axis.
+ If not specified the default value is 
+\begin_inset Flex Strong
+status collapsed
+
+\begin_layout Plain Layout
+nj_glo
+\end_layout
+
+\end_inset
+
+ of the associated axis.
+\end_layout
+
+\begin_layout Subsection
+compute_connectivity_domain
+\end_layout
+
+\begin_layout Subsection*
+n_neighbor: 
+\begin_inset Flex Emph
+status collapsed
+
+\begin_layout Plain Layout
+1D-array of integer
+\end_layout
+
+\end_inset
+
+
+\end_layout
+
+\begin_layout Standard
+Fortran: 
+\end_layout
+
+\begin_layout LyX-Code
+INTEGER :: n_neighbor(:)
+\end_layout
+
+\begin_layout Subsection*
+local_neighbor: 
+\begin_inset Flex Emph
+status collapsed
+
+\begin_layout Plain Layout
+2D-array of integer
+\end_layout
+
+\end_inset
+
+
+\end_layout
+
+\begin_layout Standard
+Fortran: 
+\end_layout
+
+\begin_layout LyX-Code
+INTEGER :: local_neighbor(:,:)
+\end_layout
+
+\begin_layout Subsection*
+n_neighbor_max: 
+\begin_inset Flex Emph
+status collapsed
+
+\begin_layout Plain Layout
+integer
+\end_layout
+
+\end_inset
+
+
+\end_layout
+
+\begin_layout Standard
+Fortran:
+\end_layout
+
+\begin_layout LyX-Code
+INTEGER :: n_neighbor_max
+\end_layout
+
+\begin_layout Subsection
+extract_domain_to_axis
+\end_layout
+
+\begin_layout Subsection*
+position (optional): 
+\emph on
+integer
+\end_layout
+
+\begin_layout Standard
+Fortran: 
+\end_layout
+
+\begin_layout LyX-Code
+INTEGER :: position
+\end_layout
+
+\begin_layout Standard
+Defines the index on a domain starting which an axis will be extracted along
+ the direction specified with the 
+\series bold
+direction
+\series default
+ attribute.
+\end_layout
+
+\begin_layout Subsection*
+direction (mandatory): 
+\emph on
+enumeration {iDir, jDir}
+\end_layout
+
+\begin_layout Standard
+Fortran:
+\end_layout
+
+\begin_layout LyX-Code
+CHARACTER(LEN=*) :: direction
+\end_layout
+
+\begin_layout Standard
+Defines the domain dimension along which an axis will be extracted.
 \end_layout
 
@@ -4691 +6645 @@
 
 \begin_layout Subsection*
-file: 
+file (optional): 
 \emph on
 string
@@ -4705 +6659 @@
 
 \begin_layout Standard
-Define the file which contains the weight value to interpolate from domain
+Define a file which contains the weight values for interpolation from domain
  source to domain destination.
- This attribute is optional.
  If not specified, the internal interpolation module will be used.
 \end_layout
 
 \begin_layout Subsection*
+order (optional): 
+\emph on
+integer
+\end_layout
+
+\begin_layout Standard
+Fortran: 
+\end_layout
+
+\begin_layout LyX-Code
+INTEGER :: order
+\end_layout
+
+\begin_layout Standard
+Defines the order of interpolation.
+ This attribute is only for internal interpolation module.
+ The default value is 2.
+\end_layout
+
+\begin_layout Subsection
+reduce_domain_to_axis
+\end_layout
+
+\begin_layout Subsection*
+direction: 
+\emph on
+enumeration {iDir, jDir}
+\end_layout
+
+\begin_layout Standard
+Fortran:
+\end_layout
+
+\begin_layout LyX-Code
+CHARACTER(LEN=*) :: direction
+\end_layout
+
+\begin_layout Standard
+Defines the domain dimension along which a reduction of the domain into
+ an axis will be performed.
+\end_layout
+
+\begin_layout Subsection*
+operation (mandatory): 
+\emph on
+enumeration {min, max, sum, average}
+\end_layout
+
+\begin_layout Standard
+Fortran:
+\end_layout
+
+\begin_layout LyX-Code
+CHARACTER(LEN=*) :: operation
+\end_layout
+
+\begin_layout Subsection*
+local: 
+\emph on
+bool
+\end_layout
+
+\begin_layout Standard
+Fortran:
+\end_layout
+
+\begin_layout LyX-Code
+LOGICAL :: local
+\end_layout
+
+\begin_layout Standard
+Defines whether the reduction should be performed locally on data owned
+ by each process.
+\end_layout
+
+\begin_layout Subsection
+reduce_domain_to_scalar
+\end_layout
+
+\begin_layout Standard
+Reduces data defined on a domain into a scalar value.
+\end_layout
+
+\begin_layout Subsection*
+operation (mandatory): 
+\emph on
+enumeration {min, max, sum, average}
+\end_layout
+
+\begin_layout Standard
+Fortran:
+\end_layout
+
+\begin_layout LyX-Code
+CHARACTER(LEN=*) :: operation
+\end_layout
+
+\begin_layout Subsection*
+local: 
+\emph on
+bool
+\end_layout
+
+\begin_layout Standard
+Fortran:
+\end_layout
+
+\begin_layout LyX-Code
+LOGICAL :: local
+\end_layout
+
+\begin_layout Standard
+Defines whether the reduction should be performed locally on data owned
+ by each process.
+\end_layout
+
+\begin_layout Subsection
+reorder_domain
+\end_layout
+
+\begin_layout Subsection*
+invert_lat (optional): 
+\emph on
+bool
+\end_layout
+
+\begin_layout Standard
+Fortran:
+\end_layout
+
+\begin_layout LyX-Code
+LOGICAL :: invert_lat
+\end_layout
+
+\begin_layout Standard
+Defines whether the latitude should be inverted.
+ The default value is false.
+\end_layout
+
+\begin_layout Subsection*
+shift_lon_fraction (optional): 
+\begin_inset Flex Emph
+status collapsed
+
+\begin_layout Plain Layout
+double
+\end_layout
+
+\end_inset
+
+
+\end_layout
+
+\begin_layout Standard
+Fortran: 
+\end_layout
+
+\begin_layout LyX-Code
+DOUBLE PRECISION :: shift_lon_fraction
+\end_layout
+
+\begin_layout Standard
+Defines the longitude offset.
+ The value of the parameter represents a fraction of 
+\series bold
+ni_glo
+\series default
+.
+\end_layout
+
+\begin_layout Subsection*
+min_lon (optional): 
+\begin_inset Flex Emph
+status collapsed
+
+\begin_layout Plain Layout
+double
+\end_layout
+
+\end_inset
+
+
+\end_layout
+
+\begin_layout Standard
+Fortran: 
+\end_layout
+
+\begin_layout LyX-Code
+DOUBLE PRECISION :: min_lon
+\end_layout
+
+\begin_layout Standard
+If both, 
+\series bold
+min_lon
+\series default
+ and 
+\series bold
+max_lon
+\series default
+, are defined, a domain will be reordered with latitude values starting
+ from 
+\series bold
+min_lon
+\series default
+ and ending at 
+\series bold
+max_lon
+\series default
+.
+\end_layout
+
+\begin_layout Subsection*
+max_lon (optional): 
+\begin_inset Flex Emph
+status collapsed
+
+\begin_layout Plain Layout
+double
+\end_layout
+
+\end_inset
+
+
+\end_layout
+
+\begin_layout Standard
+Fortran: 
+\end_layout
+
+\begin_layout LyX-Code
+DOUBLE PRECISION :: max_lon
+\end_layout
+
+\begin_layout Standard
+If both, 
+\series bold
+min_lon
+\series default
+ and 
+\series bold
+max_lon
+\series default
+, are defined, a domain will be reordered with latitude values starting
+ from 
+\series bold
+min_lon
+\series default
+ and ending at 
+\series bold
+max_lon
+\series default
+.
+\end_layout
+
+\begin_layout Subsection
+expand_domain
+\end_layout
+
+\begin_layout Subsection*
 order: 
-\emph on
+\begin_inset Flex Emph
+status collapsed
+
+\begin_layout Plain Layout
 integer
 \end_layout
 
-\begin_layout Standard
-Fortran: 
+\end_inset
+
+
+\end_layout
+
+\begin_layout Standard
+Fortran:
 \end_layout
 
@@ -4725 +6947 @@
 \end_layout
 
-\begin_layout Standard
-Define a order of interpolation.
- This attribute is only for internal interoplation module.
- This attribute is optional.
- The default value is 2.
+\begin_layout Subsection*
+type (optional): 
+\emph on
+enumeration {node, edge}
+\end_layout
+
+\begin_layout Standard
+Fortran:
+\end_layout
+
+\begin_layout LyX-Code
+CHARACTER(LEN=*) :: type
+\end_layout
+
+\begin_layout Standard
+Defines whether the node or edge connectivity should be calculated for the
+ expanded domain.
+\end_layout
+
+\begin_layout Subsection*
+i_periodic (optional): 
+\emph on
+bool
+\end_layout
+
+\begin_layout Standard
+Fortran:
+\end_layout
+
+\begin_layout LyX-Code
+LOGICAL :: i_periodic
+\end_layout
+
+\begin_layout Standard
+If the attribute value is true, values of fields defined on the expanded
+ domain will be duplicated from those of the original domain periodically
+ along the first dimension.
+ The default value is false (masked values on the expanded domain).
+\end_layout
+
+\begin_layout Subsection*
+j_periodic (optional): 
+\emph on
+bool
+\end_layout
+
+\begin_layout Standard
+Fortran:
+\end_layout
+
+\begin_layout LyX-Code
+LOGICAL :: j_periodic
+\end_layout
+
+\begin_layout Standard
+If the attribute value is true, values of fields defined on the expanded
+ domain will be duplicated from those of the original domain periodically
+ along the second dimension.
+ The default value is false (masked values on the expanded domain).
 \end_layout
 
@@ -4737 +7013 @@
 
 \begin_layout Subsection*
-ibegin: 
+ibegin (optional): 
 \begin_inset Flex Emph
 status collapsed
@@ -4759 +7035 @@
 
 \begin_layout Standard
-Define the begining index of the zoomed region on the first dimension of
- the global domain.
- This attribute is optional.
+Defines the beginning index of the zoomed region on the first dimension
+ of the global domain.
  This must be an integer between 
 \begin_inset Flex Strong
@@ -4794 +7069 @@
 
 .
-\end_layout
-
-\begin_layout Subsection*
-ni: 
+ Note that if one of the zoom attributes (ibegin, ni, jbegin or nj) is defined
+ then all the rest should be specified by a user as well.
+\end_layout
+
+\begin_layout Subsection*
+ni (optional): 
 \begin_inset Flex Emph
 status collapsed
@@ -4820 +7097 @@
 \begin_layout Standard
 Define the size of zoomed region on the first dimension of the global domain.
- This attribute is optional.
  This must be an integer between 
 \begin_inset Flex Strong
@@ -4853 +7129 @@
 
  of the dimension of domain.
-\end_layout
-
-\begin_layout Subsection*
-jbegin: 
+ Note that if one of the zoom attributes (ibegin, ni, jbegin or nj) is defined
+ then all the rest should be specified by a user as well.
+\end_layout
+
+\begin_layout Subsection*
+jbegin (optional): 
 \begin_inset Flex Emph
 status collapsed
@@ -4878 +7156 @@
 
 \begin_layout Standard
-Define the begining index of the zoomed region on the second dimension of
- the global domain.
- This attribute is optional.
+Define the beginning index of the zoomed region on the second dimension
+ of the global domain.
  This must be an integer between 
 \begin_inset Flex Strong
@@ -4913 +7190 @@
 
 .
-\end_layout
-
-\begin_layout Subsection*
-nj: 
+ Note that if one of the zoom attributes (ibegin, ni, jbegin or nj) is defined
+ then all the rest should be specified by a user as well.
+\end_layout
+
+\begin_layout Subsection*
+nj (optional): 
 \begin_inset Flex Emph
 status collapsed
@@ -4939 +7218 @@
 \begin_layout Standard
 Define the size of zoomed region on the second dimension of the global domain.
- This attribute is optional.
- This must be an integer between 
+ The attribute value should be an integer between 
 \begin_inset Flex Strong
 status collapsed
@@ -4972 +7250 @@
 
  of the dimension of domain.
+ Note that if one of the zoom attributes (ibegin, ni, jbegin or nj) is defined
+ then all the rest should be specified by a user as well.
 \end_layout
 
@@ -4978 +7258 @@
 \end_layout
 
-\begin_layout Standard
-
+\begin_layout Subsection*
+lon_start (optional): 
+\begin_inset Flex Emph
+status collapsed
+
+\begin_layout Plain Layout
+double
+\end_layout
+
+\end_inset
+
+
+\end_layout
+
+\begin_layout Standard
+Fortran: 
+\end_layout
+
+\begin_layout LyX-Code
+DOUBLE PRECISION :: lon_start
+\end_layout
+
+\begin_layout Standard
+Along with 
+\series bold
+lon_end
+\series default
+, the attribute defines the longitude range of a generated domain.
+\end_layout
+
+\begin_layout Subsection*
+lon_end (optional): 
+\begin_inset Flex Emph
+status collapsed
+
+\begin_layout Plain Layout
+double
+\end_layout
+
+\end_inset
+
+
+\end_layout
+
+\begin_layout Standard
+Fortran: 
+\end_layout
+
+\begin_layout LyX-Code
+DOUBLE PRECISION :: lon_end
+\end_layout
+
+\begin_layout Standard
+Along with 
+\series bold
+lon_start
+\series default
+, the attribute defines the longitude range of a generated domain.
+\end_layout
+
+\begin_layout Subsection*
+lat_start (optional): 
+\begin_inset Flex Emph
+status collapsed
+
+\begin_layout Plain Layout
+double
+\end_layout
+
+\end_inset
+
+
+\end_layout
+
+\begin_layout Standard
+Fortran: 
+\end_layout
+
+\begin_layout LyX-Code
+DOUBLE PRECISION :: lat_start
+\end_layout
+
+\begin_layout Standard
+Along with 
+\series bold
+lat_end
+\series default
+, the attribute defines the latitude range of a generated domain.
+\end_layout
+
+\begin_layout Subsection*
+lat_end (optional): 
+\begin_inset Flex Emph
+status collapsed
+
+\begin_layout Plain Layout
+double
+\end_layout
+
+\end_inset
+
+
+\end_layout
+
+\begin_layout Standard
+Fortran: 
+\end_layout
+
+\begin_layout LyX-Code
+DOUBLE PRECISION :: lat_end
+\end_layout
+
+\begin_layout Standard
+Along with 
+\series bold
+lat_start
+\series default
+, the attribute defines the latitude range of a generated domain.
+\end_layout
+
+\begin_layout Subsection*
+bounds_lon_start: 
+\begin_inset Flex Emph
+status collapsed
+
+\begin_layout Plain Layout
+double
+\end_layout
+
+\end_inset
+
+
+\end_layout
+
+\begin_layout Standard
+Fortran: 
+\end_layout
+
+\begin_layout LyX-Code
+DOUBLE PRECISION :: bounds_lon_start
+\end_layout
+
+\begin_layout Standard
+Attributes 
+\series bold
+bounds_lon_start
+\series default
+ and 
+\series bold
+bounds_lon_start
+\series default
+ set the longitude range of a generated domain.
+ If both sets, 
+\series bold
+(lon_start, lon_end)
+\series default
+ and 
+\series bold
+(bounds_lon_start, bounds_lon_end)
+\series default
+, are specified then the bound attributes will be ignored.
+\end_layout
+
+\begin_layout Subsection*
+bounds_lon_end: 
+\begin_inset Flex Emph
+status collapsed
+
+\begin_layout Plain Layout
+double
+\end_layout
+
+\end_inset
+
+
+\end_layout
+
+\begin_layout Standard
+Fortran: 
+\end_layout
+
+\begin_layout LyX-Code
+DOUBLE PRECISION :: bounds_lon_end
+\end_layout
+
+\begin_layout Standard
+Attributes 
+\series bold
+bounds_lon_start
+\series default
+ and 
+\series bold
+bounds_lon_start
+\series default
+ set the longitude range of a generated domain.
+ If both sets, 
+\series bold
+(lon_start, lon_end)
+\series default
+ and 
+\series bold
+(bounds_lon_start, bounds_lon_end)
+\series default
+, are specified then the bound attributes will be ignored.
+\end_layout
+
+\begin_layout Subsection*
+bounds_lat_start: 
+\begin_inset Flex Emph
+status collapsed
+
+\begin_layout Plain Layout
+double
+\end_layout
+
+\end_inset
+
+
+\end_layout
+
+\begin_layout Standard
+Fortran: 
+\end_layout
+
+\begin_layout LyX-Code
+DOUBLE PRECISION :: bounds_lat_start
+\end_layout
+
+\begin_layout Standard
+Attributes 
+\series bold
+bounds_lat_start
+\series default
+ and 
+\series bold
+bounds_lat_start
+\series default
+ set the latitude range of a generated domain.
+ If both sets, 
+\series bold
+(lat_start, lat_end)
+\series default
+ and 
+\series bold
+(bounds_lat_start, bounds_lat_end)
+\series default
+, are specified then the bound attributes will be ignored.
+\end_layout
+
+\begin_layout Subsection*
+bounds_lat_end: 
+\begin_inset Flex Emph
+status collapsed
+
+\begin_layout Plain Layout
+double
+\end_layout
+
+\end_inset
+
+
+\end_layout
+
+\begin_layout Standard
+Fortran: 
+\end_layout
+
+\begin_layout LyX-Code
+DOUBLE PRECISION :: bounds_lat_end
+\end_layout
+
+\begin_layout Standard
+Attributes 
+\series bold
+bounds_lat_start
+\series default
+ and 
+\series bold
+bounds_lat_start
+\series default
+ set the latitude range of a generated domain.
+ If both sets, 
+\series bold
+(lat_start, lat_end)
+\series default
+ and 
+\series bold
+(bounds_lat_start, bounds_lat_end)
+\series default
+, are specified then the bound attributes will be ignored.
 \end_layout
 
@@ -5521 +8089 @@
 
 \begin_layout Standard
-This set of subroutines enable the models to interact, complete or query
+This set of subroutines enables the models to interact, complete or query
  the XML tree data base.
  New elements or group of elements can be added as child in the tree, attributes
  of the elements can be set or query.
- The type of element actually available are: context, axis, domain, grid,
+ The type of elements currently available are: context, axis, domain, grid,
  field, variable and file.
  An element can be identified by a string or by an handle associated to
@@ -5702 +8270 @@
 
 \begin_layout Standard
-where element is one of the existing element or group of element.
+where element is one of the existing elements or group of elements.
 \end_layout
 
@@ -5740 +8308 @@
 
 \begin_layout Standard
-This subroutine return the handle of the specified element identified by
+This subroutine returns the handle of the specified element identified by
  its string.
- The element must be existing otherwise it raise an error.
+ The element must be existing otherwise an error is raised.
 \end_layout
 
@@ -5762 +8330 @@
 
 \begin_layout Standard
-where element is one of the existing element or group of element.
+where element is one of the existing elements or group of elements.
 \end_layout
 
@@ -5787 +8355 @@
 
 \begin_layout Standard
-This function return .TRUE.
- if the element defined by the string identifier id is existing in the data
- base, otherwise it return .FALSE.
+This function returns .TRUE.
+ if the element defined by the string identifier 
+\begin_inset Quotes eld
+\end_inset
+
+id
+\begin_inset Quotes erd
+\end_inset
+
+ exists in the data base, otherwise it returns .FALSE.
  .
 \end_layout
@@ -5818 +8393 @@
 
 \begin_layout Standard
-where element is one of the existing element or group of element.
+where element is one of the existing elements or element groups.
 \end_layout
 
@@ -5869 +8444 @@
 
 \begin_layout Standard
-This subroutine add a child to an existing parent element.
+This subroutine adds a child to an existing parent element.
  The identifier of the child, if existing, can be specified optionally.
- All group elements can contains child of the same kind, provided generic
+ All group elements can contain child of the same type, provided generic
  inheritance.
- Some elements can contains children of an other kind for a specific behaviour.
- File element may contains field_group, field, variable and variable_group
+ Some elements can contain children of another type for a specific behavior.
+ File element may contain field_group, field, variable and variable_group
  child elements.
- Field elements may contains variable_group of variable child element.
-\end_layout
-
-\begin_layout Subsection*
-Query if a value of an element attributes is defined (by handle)
+ Field elements may contain variable_group of variable child element.
+\end_layout
+
+\begin_layout Subsection*
+Query if the value of an element attribute is defined (by handle)
 \end_layout
 
@@ -5909 +8484 @@
 
 \begin_layout Standard
-where element is one of the existing element or group of element.
+where element is one of the existing elements or element groups.
  attribute_x is describing in the chapter dedicated to the attribute description.
 \end_layout
@@ -5948 +8523 @@
 
 \begin_layout Standard
-This subroutine my be used to query if one or more attributes of an element
+This subroutine can be used to query if one or more attributes of an element
  have a defined value.
  The list of attributes and their type are described in a specific chapter
@@ -5985 +8560 @@
 
 \begin_layout Standard
-where element is one of the existing element or group of element.
+where element is one of the existing elements or element groups.
  attribute_x is describing in the chapter dedicated to the attribute description.
 \end_layout
@@ -6024 +8599 @@
 
 \begin_layout Standard
-This subroutine my be used to query if one or more attributes of an element
+This subroutine can be used to query if one or more attributes of an element
  have a defined value.
  The list of available attributes and their type are described in a specific
@@ -6061 +8636 @@
 
 \begin_layout Standard
-where element is one of the existing element or group of element.
+where element is one of the existing elements or element groups.
  attribute_x and attribute_type_x are describing in the chapter dedicated
  to the attribute description.
@@ -6101 +8676 @@
 
 \begin_layout Standard
-This subroutine my be used to set one or more attribute to an element defined
- by its handle.
- The list of available attributes and their type are described in a specific
- chapter of the documentation.
+This subroutine can be used to set one or more attributes of an element
+ defined by its handle.
+ The list of available attributes and their types are described in corresponding
+ chapters of the documentation.
  
 \end_layout
@@ -6138 +8713 @@
 
 \begin_layout Standard
-where element is one of the existing element or group of element.
+where element is one of the existing elements or element groups.
+ The attributes attribute_x and attribute_type_x are described in corresponding
+ chapters.
+\end_layout
+
+\begin_layout Subsubsection*
+Arguments:
+\end_layout
+
+\begin_layout Itemize
+\begin_inset Flex Code
+status collapsed
+
+\begin_layout Plain Layout
+id
+\end_layout
+
+\end_inset
+
+: string identifier.
+\end_layout
+
+\begin_layout Itemize
+\begin_inset Flex Code
+status collapsed
+
+\begin_layout Plain Layout
+attr_x
+\end_layout
+
+\end_inset
+
+: value of the attribute to be set.
+\end_layout
+
+\begin_layout Subsubsection*
+Description:
+\end_layout
+
+\begin_layout Standard
+This subroutine can be used to set one or more attributes of an element
+ defined by its string id.
+ The list of available attributes and their type are described in corresponding
+ chapters of the documentation.
+\end_layout
+
+\begin_layout Subsection*
+Getting element attributes value (by handle)
+\end_layout
+
+\begin_layout Subsubsection*
+Synopsis:
+\end_layout
+
+\begin_layout LyX-Code
+SUBROUTINE xios_get_attr(handle, attr_1=attribute_1, attr_2=attribute_2,
+ ...)
+\end_layout
+
+\begin_layout LyX-Code
+TYPE(xios_element)         , INTENT(IN) :: handle
+\end_layout
+
+\begin_layout LyX-Code
+attribute_type_1, OPTIONAL  , INTENT(OUT) :: attr_1
+\end_layout
+
+\begin_layout LyX-Code
+attribute_type_2, OPTIONAL  , INTENT(OUT) :: attr_2
+\end_layout
+
+\begin_layout LyX-Code
+....
+\end_layout
+
+\begin_layout Standard
+where element is one of the existing elements or element groups.
  attribute_x and attribute_type_x are describing in the chapter dedicated
  to the attribute description.
@@ -6152 +8803 @@
 
 \begin_layout Plain Layout
-id
-\end_layout
-
-\end_inset
-
-: string identifier.
+handle
+\end_layout
+
+\end_inset
+
+: element handle.
 \end_layout
 
@@ -6170 +8821 @@
 \end_inset
 
-: value of the attribute to be set.
+: value of the attribute to be get.
 \end_layout
 
@@ -6178 +8829 @@
 
 \begin_layout Standard
-This subroutine my be used to set one or more attribute to an element defined
- by its string id.
- The list of available attributes and their type are described in a specific
- chapter of the documentation.
-\end_layout
-
-\begin_layout Subsection*
-Getting element attributes value (by handle)
-\end_layout
-
-\begin_layout Subsubsection*
-Synopsis:
-\end_layout
-
-\begin_layout LyX-Code
-SUBROUTINE xios_get_attr(handle, attr_1=attribute_1, attr_2=attribute_2,
- ...)
-\end_layout
-
-\begin_layout LyX-Code
-TYPE(xios_element)         , INTENT(IN) :: handle
-\end_layout
-
-\begin_layout LyX-Code
-attribute_type_1, OPTIONAL  , INTENT(OUT) :: attr_1
-\end_layout
-
-\begin_layout LyX-Code
-attribute_type_2, OPTIONAL  , INTENT(OUT) :: attr_2
-\end_layout
-
-\begin_layout LyX-Code
-....
-\end_layout
-
-\begin_layout Standard
-where element is one of the existing element or group of element.
- attribute_x and attribute_type_x are describing in the chapter dedicated
- to the attribute description.
-\end_layout
-
-\begin_layout Subsubsection*
-Arguments:
-\end_layout
-
-\begin_layout Itemize
-\begin_inset Flex Code
-status collapsed
-
-\begin_layout Plain Layout
-handle
-\end_layout
-
-\end_inset
-
-: element handle.
-\end_layout
-
-\begin_layout Itemize
-\begin_inset Flex Code
-status collapsed
-
-\begin_layout Plain Layout
-attr_x
-\end_layout
-
-\end_inset
-
-: value of the attribute to be get.
-\end_layout
-
-\begin_layout Subsubsection*
-Description:
-\end_layout
-
-\begin_layout Standard
-This subroutine my be used to get one or more attribute value of an element
+This subroutine can be used to get one or more attribute value of an element
  defined by its handle.
  All attributes in the arguments list must be defined.
@@ -6292 +8867 @@
 
 \begin_layout Standard
-where element is one of the existing element or group of element.
+where element is one of the existing elements or element groups.
  attribute_x is describing in the chapter dedicated to the attribute description.
 \end_layout
@@ -6331 +8906 @@
 
 \begin_layout Standard
-This subroutine my be used to get one or more attribute value of an element
+This subroutine can be used to get one or more attribute value of an element
  defined by its handle.
  All attributes in the arguments list must have a defined value.
@@ -6339 +8914 @@
 
 \begin_layout Section*
-Interface relative to context management
+Context management interface
 \end_layout
 
@@ -6397 +8972 @@
 
 \begin_layout Standard
-This subroutine initialize a context identified by 
+This subroutine initializes a context identified by 
 \begin_inset Flex Code
 status collapsed
@@ -6459 +9034 @@
 
 \begin_layout Standard
-This subroutine must be call to close a context, before the 
+This subroutine must be called to close a context before the 
 \begin_inset Flex Code
 status collapsed
@@ -6470 +9045 @@
 
  call.
- It waits until that all pending request sent to the servers will be processed
- and the opened files will be closed.
+ It waits until that all pending requests sent to the servers will be processed
+ and all opened files will be closed.
 \end_layout
 
@@ -6542 +9117 @@
 \begin_layout Standard
 These subroutines set the current active context.
- All xios calls after will refer to this active context.
- If only one context is defined, it is automatically set as the active context.
+ All following XIOS calls will refer to this active context.
+ If only one context is defined, it will be set automatically as the active
+ context.
  
 \end_layout
@@ -6572 +9148 @@
 
 \begin_layout Standard
-This subroutine must be call when all definitions of a context is finished
+This subroutine must be called when all definitions of a context are finished
  at the end of the initialization and before entering to the time loop.
  A lot of operations are performed internally (inheritance, grid definition,
@@ -6581 +9157 @@
 
 \begin_layout Section*
-Interface relative to calendar management
+Calendar management interface
 \end_layout
 
@@ -7418 +9994 @@
 
 \begin_layout Section*
-Interface relative to duration handling
+Duration handling interface
 \end_layout
 
@@ -7988 +10564 @@
 This function returns the number of seconds since the beginning of the day
  for the specified date, based on the calendar of the current context.
- It must not be used before the calendar was created.
+ It should not be used before the calendar was created.
 \end_layout
 
@@ -8030 +10606 @@
 \begin_layout Standard
 This function returns the fraction of day corresponding to the specified
- date, based on the calendar of the current context.
- It must not be used before the calendar was created.
+ date based on the calendar of the current context.
+ It should not be used before the calendar was created.
 \end_layout
 

XIOS/trunk/doc/XIOS_user_guide.lyx

@@ -4051 +4051 @@
 \end_inset
 
-, field_A)
+, field_B)
 \end_layout
 
@@ -4057 +4057 @@
 
 .
+\end_layout
+
+\begin_layout Standard
+XIOS also provides the means to define an expression in a Fortran code via
+ the field attribute 
+\begin_inset Quotes eld
+\end_inset
+
+expr
+\begin_inset Quotes erd
+\end_inset
+
+.
+ The example above can rewritten as
+\begin_inset listings
+lstparams "language=XML,breaklines=true,tabsize=2,frame=tb,postbreak={\raisebox{0ex}[0ex][0ex]{\ensuremath{\rcurvearrowse\space}}}"
+inline false
+status open
+
+\begin_layout Plain Layout
+
+<?xml version="1.0"?>
+\end_layout
+
+\begin_layout Plain Layout
+
+<simulation>
+\end_layout
+
+\begin_layout Plain Layout
+
+        <context id="test">
+\end_layout
+
+\begin_layout Plain Layout
+
+                <calendar type="Gregorian" timestep="1h" />
+\end_layout
+
+\begin_layout Plain Layout
+
+\end_layout
+
+\begin_layout Plain Layout
+
+                <grid_definition>
+\end_layout
+
+\begin_layout Plain Layout
+
+                        <grid id="grid_A"><!-- Definition ommited --></grid>
+\end_layout
+
+\begin_layout Plain Layout
+
+                </grid_definition>
+\end_layout
+
+\begin_layout Plain Layout
+
+\end_layout
+
+\begin_layout Plain Layout
+
+                <file_definition>
+\end_layout
+
+\begin_layout Plain Layout
+
+                        <file name="output" output_freq="1d">
+\end_layout
+
+\begin_layout Plain Layout
+
+                        <field id="field_B" grid_ref="grid_A" operation="average">
+\end_layout
+
+\begin_layout Plain Layout
+
+                        <field id="field_C" field_ref="field_B">
+\end_layout
+
+\begin_layout Plain Layout
+
+                        </file>
+\end_layout
+
+\begin_layout Plain Layout
+
+                </file_definition>
+\end_layout
+
+\begin_layout Plain Layout
+
+        </context>
+\end_layout
+
+\begin_layout Plain Layout
+
+</simulation>
+\end_layout
+
+\end_inset
+
+
+\end_layout
+
+\begin_layout Standard
+while the two expressions can be specified with the following calls: 
+\begin_inset Flex Code
+status open
+
+\begin_layout Plain Layout
+xios_set_field_attr(
+\begin_inset Quotes eld
+\end_inset
+
+field_B
+\begin_inset Quotes erd
+\end_inset
+
+, expr=
+\begin_inset Quotes erd
+\end_inset
+
+@this + 273.15
+\begin_inset Quotes erd
+\end_inset
+
+
+\end_layout
+
+\end_inset
+
+ and 
+\begin_inset Flex Code
+status open
+
+\begin_layout Plain Layout
+xios_set_field_attr(
+\begin_inset Quotes eld
+\end_inset
+
+field_C
+\begin_inset Quotes erd
+\end_inset
+
+, expr=
+\begin_inset Quotes erd
+\end_inset
+
+log10(field_B)
+\begin_inset Quotes erd
+\end_inset
+
+
+\end_layout
+
+\end_inset
+
+.
+ 
 \end_layout
 
@@ -5006 +5168 @@
 \begin_layout Standard
 Some of XIOS behaviors can be configured using options.
- Those options must be expressed as variables in a specific context whose
+ Those options must be exprhessed as variables in a specific context whose
  
 \series bold
@@ -5100 +5262 @@
 
 \begin_layout Standard
-To improve I/O performance and to be able to use HDF5 compression with the
- 
-\series bold
-\emph on
-
-\begin_inset Quotes eld
-\end_inset
-
-multiple_file
-\begin_inset Quotes erd
-\end_inset
-
-
-\series default
-\emph default
- mode, it is possible to separate servers into two levels: intermediaries
- (level one) and writers (level two).
- A single MPI communicator will be created for the intermediaries, while
- multiple communicators will be created for the writers according to the
- number of 
-\begin_inset Quotes eld
-\end_inset
-
-pools
-\begin_inset Quotes erd
-\end_inset
-
- which can be set by a user.
+To improve I/O performance, it is possible to separate servers into two
+ levels: intermediaries (level one) and writers (level two).
  Level-one servers will receive data from clients and will redistribute
- it to be sent to pools of level-two servers whilst level-two servers will
- do the I/O (important: for now level-two servers only do writing data).
- Secondary servers can be launched by means of three parameters:
+ and send the data to subsets of level-two servers (called “pools”), whilst
+ level-two servers will do the I/O.
+ Each file is written by only one pool.
+ If one process is assigned per pool (which is the default option), the
+ I/O is sequential and HDF5 compression can be used even in the “multiple_file”
+ mode.
+ Level-two servers can be launched and controlled by means of three parameters:
 \end_layout
 
@@ -5283 +5423 @@
 
 \begin_layout Standard
-Note that with one server per pool, the I/O is actually sequential and thus
- the use of HDF5 compression is possible.
- 
-\end_layout
-
-\begin_layout Standard
 By default file distribution among server-two pools is optimized for bandwidth.
  An alternative way of distributing files is possible in order to minimize
@@ -5438 +5572 @@
 \begin_inset Formula 
 \[
-{\scriptstyle used\_size\;=\;\min\left(minimum\_buffer\_size,\; detected\_size\;\times\; buffer\_size\_factor\right)}
+{\scriptstyle used\_size\;=\;\min\left(minimum\_buffer\_size,\;detected\_size\;\times\;buffer\_size\_factor\right)}
 \]