Versions Compared

Old Version 5

changes.mady.by.user Sandor Kertesz

Saved on

compared with

New Version 6

changes.mady.by.user Sandor Kertesz

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Section
Column
width76px

Column

This icon generates the gridded input data and the AVAILABLE file needed to run the FLEXTRA trajectory model. The input forecast or analysis fields are automatically retrieved from ECMWF's MARS archive. A tutorial on using FLEXTRA from within Metview is available from the Tutorials pageruns the FLEXPART Lagrangian dispersion model and converts its outputs to formats Metview can work with. For help on editing icons, please see Editing Icons.

The macro language equivalent is flextraflexpart_prepare().

About FLEXTRA input  data

The following is for information only - FLEXTRA Prepare handles these details internally.

FLEXTRA requires input fields on a regular latitude-longitude grid in GRIB format. The input data must contain four three-dimensional fields: the two horizontal wind components, vertical velocity and temperature. Two additional two-dimensional fields are needed as well: topography and surface pressure. The three-dimensional input data has to be available on ECMWF model (i.e. η) levels defined by a hybrid vertical coordinate system. An important restriction is that all the data fields used within a FLEXTRA run must have the same domain size, resolution, number of levels, etc.

All the required fields, with one exception, can be retrieved from ECMWF's MARS archive. The only exception is vertical velocity because FLEXTRA needs the following field for its computations:

Mathinline
\dot \eta \frac{\partial \eta}{\partial p}
Since only
Mathinline
\dot \eta
is archived in MARS the full product needs to be computed during the data preparation process (FLEXTRA Prepare does it for you).

FLEXTRA requires all the input GRIB files to be in the same folder using the following file naming convention: ENyymmddhh. In addition to the GRIBs FLEXTRA needs several parameter files as well. Most of these files are automatically generated by Metview in the background, so users do not need to create them. The only exception is the file called AVAILABLE because it can be optionally provided by the user

run().

The FLEXPART Run Editor

Info
All the date parameters used for FLEXPART Run have yyyymmdd format. Relative dates are allowed: e.g. -1 means yesterday, 0 means today, etc.                   

...

Specifies the FLEXPART executable. Both absolute and relative path can be given here. If left empty Metview will use the MV_FLEXPART_EXECUTABLE_PATH environment variable to locate the executable.

Input Mode

The MARS experiment identifier of the forecast fieldsDefines how the location of the input data and the AVAILABLE file is specified. If it is set to Icon the input is specified via a FLEXPART Prepare icon in parameter Input Data. While if it is set to Path then parameters Input Path and Available File Path specifie he input data. The default value is Icon (operational forecast).
 

Input Data

Holds a FLEXPART Prepare icon specifying the input data location. Enabled when Input Mode is set to Icon.The i

Input Path

Specifies the location of the input data (GRIB) files. Both an absolute and relative path can be given here. Enabled when Input Mode is set to Path. 

Available File Path

Specifies the location of the AVAILABLE file. If the default value (the string literal SAME_AS_INPUT_PATH) is set it indicates that the AVAILABLE file is located in the same directory as the input data.as the input data. Enabled when Input Mode is set to Path.  

Output Path

Specifies the location of the output data files. Both an absolute and relative path can be given here.

...

Specifies the FLEXPART simulation direction in time. The possible values are: Forward and Backward. The default value is Forward.

Starting Date

Specifies the beginning date of the simulation in a YYYYMMDD format.   Relative dates are allowed: e.g. -1 means yesterday, 0 means today, etc.   

Starting Time

Specifies the beginning time of the simulation in a HH[:MM[:SS]] format. 

Ending Date

Specifies

...

the ending date of the simulation in a YYYYMMDD format.   Relative dates are allowed: e.g. -1 means yesterday, 0 means today, etc.   

Ending Time

Specifies the ending time of the simulation in a HH[:MM[:SS]] format. 

...

Specifies the sampling rate that is used for the averaging of the output. This period must be shorter than the Output Averaging Interval. The format is HHH[:MM[:SS]]. The default value is 1 (hour).

...

Specifies the grid resolution for the gridded output in degrees in an as east_west_resolution/north_south_resolution format. The default value is 1/1. 

Output Levels

Specifies the list of height levels of the gridded output. The levels are given in metres units. The default value is an empty list.

...

Levels

Specifies the list of height levels of the gridded output. The levels are given in metres units. The default value is an empty list.

Release

...

Species

Specifies the list of the species released for the simulation. At all release locations the same species are emitted. The species are identified by the SPECIES_NNN files string the physical and chemical properties of species.  

Release Units

Specifies the concentration units of the released species. The possible options are mass and mixr (mixing ratio) of height levels of the gridded output. The levels are given in metres units. The default value is an empty list mass. 

Releases

Specifies the releases as a group of FLEXPART Release icons. 

Receptor units

Specifies the concentration units at the receptor. For forward simulations this the units of the output concentrations. For backward simulations ????? The possible options are mass and mixr (mixing ratio) list of height levels of the gridded output. The levels are given in metres units. The default value is an empty list mass. 

...

Receptors

Specifies Enables the list of height levels of the gridded output. The levels are given in metres units. The default value is an empty list.

Receptors

Specifies the list of height levels of the gridded output. The levels are given in metres unitsusage of receptor sites for forward simulations (on or off). When it is enabled the list of receptor sites can be defined via Receptor Names, Receptor Latitudes and Receptor Longitude. The default value is an empty list off.

Receptor Names

Specifies the list of height levels of the gridded output. The levels are given in metres unitsthe list of receptor site names.The default value is an empty list.

Receptor Latitudes

Specifies the list of height levels of the gridded output. The levels are given in metres unitsreceptor site latitudes. The default value is an empty list.

Receptors Longitudes

Specifies the list of height levels of the gridded output. The levels are given in metres unitsreceptor site longitudes. The default value is an empty list.

Ageclasses

Specifies the list times for the age class calculation. The entries specify the of height levels of the gridded output. The levels are given in metres units. The default value is an empty list.

...