Changeset f20342a in flex_extract.git for For_developers/Sphinx/source/Documentation/Input/templates.rst
- Timestamp:
- May 27, 2020, 8:01:54 PM (4 years ago)
- Branches:
- master, ctbto, dev
- Children:
- 550435b
- Parents:
- a14839a
- File:
-
- 1 edited
Legend:
- Unmodified
- Added
- Removed
-
For_developers/Sphinx/source/Documentation/Input/templates.rst
rb1674ed rf20342a 3 3 ********* 4 4 5 In ``flex_extract`` we use the Python package `genshi <https://genshi.edgewall.org/>`_ to create specific files from templates. It is the most efficient way to be able to quickly adapt e.g. the job scripts send to the ECMWF batch queue system or the namelist file für the Fortran programwithout the need to change the program code.5 In ``flex_extract``, the Python package `genshi <https://genshi.edgewall.org/>`_ is used to create specific files from templates. It is the most efficient way to be able to quickly adapt, e. g., the job scripts sent to the ECMWF batch queue system, or the namelist file für the Fortran program, without the need to change the program code. 6 6 7 7 .. note:: 8 Usually it is not recommended to change anything in these files without being able to understand the effects.8 Do not change anything in these files unless you understand the effects! 9 9 10 Each template file has its content framework and keeps so-called placeholder variables in the positions where the values need s to be substituted at run time. These placeholders are marked by a leading ``$`` sign. In case of the Kornshell job scripts, where (environment) variables are used the ``$`` sign needs to be doubled to `escape` and keep a single ``$`` sign as it is.10 Each template file has its content framework and keeps so-called placeholder variables in the positions where the values need to be substituted at run time. These placeholders are marked by a leading ``$`` sign. In case of the Kornshell job scripts, where (environment) variables are used, the ``$`` sign needs to be doubled for `escaping`. 11 11 12 The following templates are used and can be found indirectory ``flex_extract_vX.X/Templates``:12 The following templates are used; they can be found in the directory ``flex_extract_vX.X/Templates``: 13 13 14 14 convert.nl 15 15 ---------- 16 16 17 This is the template for a Fortran namelist file called ``fort.4`` which will beread by ``calc_etadot``.17 This is the template for a Fortran namelist file called ``fort.4`` read by ``calc_etadot``. 18 18 It contains all the parameters ``calc_etadot`` needs. 19 19 … … 57 57 This template is used to create the job script file called ``compilejob.ksh`` during the installation process for the application modes **remote** and **gateway**. 58 58 59 At the beginning some directives for the batch system are set.60 On the **ecgate** server the ``SBATCH`` comments are the directives for the SLURM workload manager. A description of the single lines can be found at `SLURM directives <https://confluence.ecmwf.int/display/UDOC/Writing+SLURM+jobs>`_.61 For the high performance computers **cca** and **ccb** the ``PBS`` comments are necessary and can be view at`PBS directives <https://confluence.ecmwf.int/display/UDOC/Batch+environment%3A++PBS>`_.62 63 The software environment requirements mentioned in :ref:`ref-requirements` are prepared by loading the corresponding modules depending in the ``HOST``. It should not be changed without testing.64 65 Afterwards the installation steps as such are done. Including the generation of the root directory, putting files in place, compiling the Fortran program and sending a log file viaemail.59 At the beginning, some directives for the batch system are set. 60 On the **ecgate** server, the ``SBATCH`` comments are the directives for the SLURM workload manager. A description of the single lines can be found at `SLURM directives <https://confluence.ecmwf.int/display/UDOC/Writing+SLURM+jobs>`_. 61 For the high-performance computers **cca** and **ccb**, the ``PBS`` comments are necessary; for details see `PBS directives <https://confluence.ecmwf.int/display/UDOC/Batch+environment%3A++PBS>`_. 62 63 The software environment requirements mentioned in :ref:`ref-requirements` are prepared by loading the corresponding modules depending on the ``HOST``. It should not be changed without testing. 64 65 Afterwards, the installation steps as such are done. They included the generation of the root directory, putting files in place, compiling the Fortran program, and sending a log file by email. 66 66 67 67 .. code-block:: ksh … … 145 145 This template is used to create the actual job script file called ``job.ksh`` for the execution of ``flex_extract`` in the application modes **remote** and **gateway**. 146 146 147 At the beginning some directives for the batch system are set. 148 On the **ecgate** server the ``SBATCH`` comments are the directives for the SLURM workload manager. A description of the single lines can be found at `SLURM directives <https://confluence.ecmwf.int/display/UDOC/Writing+SLURM+jobs>`_. 149 For the high performance computers **cca** and **ccb** the ``PBS`` comments are necessary and can be view at `PBS directives <https://confluence.ecmwf.int/display/UDOC/Batch+environment%3A++PBS>`_. 150 151 The software environment requirements mentioned in :ref:`ref-requirements` are prepared by loading the corresponding modules depending in the ``HOST``. It should not be changed without testing. 152 153 Afterwards the run directory and the ``CONTROL`` file are created and ``flex_extract`` is executed. In the end a log file is send via email. 147 At the beginning, some directives for the batch system are set. 148 On the **ecgate** server, the ``SBATCH`` comments are the directives for the SLURM workload manager. A description of the single lines can be found at `SLURM directives <https://confluence.ecmwf.int/display/UDOC/Writing+SLURM+jobs>`_. 149 For the high performance computers **cca** and **ccb**, the ``PBS`` comments are necessary; 150 for details see `PBS directives <https://confluence.ecmwf.int/display/UDOC/Batch+environment%3A++PBS>`_. 151 152 The software environment requirements mentioned in :ref:`ref-requirements` are prepared by loading the corresponding modules depending on the ``HOST``. It should not be changed without testing. 153 154 Afterwards, the run directory and the ``CONTROL`` file are created and ``flex_extract`` is executed. In the end, a log file is send by email. 154 155 155 156 .. code-block:: ksh … … 239 240 ------------ 240 241 241 This template is used to create the template for the execution job script ``job.temp`` for ``flex_extract`` in the installation process. A description of the file can be found under ``job.temp``. A couple ofparameters are set in this process, such as the user credentials and the ``flex_extract`` version number.242 This template is used to create the template for the execution job script ``job.temp`` for ``flex_extract`` in the installation process. A description of the file can be found under ``job.temp``. Several parameters are set in this process, such as the user credentials and the ``flex_extract`` version number. 242 243 243 244 .. code-block:: ksh … … 325 326 326 327 327 328 329 330 331 332 333 334 335 336 337 338 339 340 341 342 328 343 329
Note: See TracChangeset
for help on using the changeset viewer.