Control & Input DataΒΆ

Input Data
  • The CONTROL file

    Flex_extract needs a number of controlling parameters to decide on the behaviour and the actual dataset to be retrieved. They are initialized by flex_extract with their default values and can be overwritten with definitions set in the so called The CONTROL file.

    To be able to successfully retrieve data from the ECMWF Mars archive it is necessary to understand these parameters and set them to proper and consistent values. They are described in The CONTROL parameters section.

    We also have some CONTROL file examples and description of CONTROL file changes changes to previous versions and downward compatibilities.

  • ECMWF User Credential file ECMWF_ENV

    For flex_extract it is necessary to be able to reach ECMWF servers in the remote mode and the gateway mode. Therefore a ECMWF User Credential file ECMWF_ENV is created during the installation process.

  • Templates

    A number of files which are created by flex_extract are taken from templates. This makes it easy to adapt for example the jobscripts regarding its settings for the batch jobs.

Controlling

The main tasks and behaviour of flex_extract are controlled by its Python scripts. There are two top-level scripts, one for installation called install and one for execution called submit. They can interpret a number of command line arguments which can be seen by typing --help after the script call. Go to the root directory of flex_extract to type:

cd flex_extract_vX.X
python3 source/python/install.py --help
python3 source/python/submit.py --help

In this new version we provide also the wrapping Shell scripts setup and run, which sets the command line parameters, do some checks and execute the corresponing Python scripts install.py and submit.py respectivley.

It might be faster and easier for beginners. See Quick Start for information on how to use them.

Additionally, flex_extract creates the Korn Shell scripts The Compilation Jobscript compilejob.ksh and The Jobscript job.ksh which will be send to the ECMWF serves in the remote mode and the gateway mode for starting batch jobs.

The Fortran program will be compiled during the installation process by the The Fortran Makefile - CONVERT2.

To sum up, the following scripts controls flex_extract:

Installation
Execution