This icon runs 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 flexpart_run()
.
The FLEXPART Run Editor
Exe Path
Specifies the FLEXPART executable. Both absolute and relative path can be given here. If the default value (the string AS_MV_FLEXPART_EXE) is used or left blank Metview will use the MV_FLEXPART_EXE environment variable to locate the executable.
Resources Path
Specifies the location of the parameter files (IGBP_int1.dat, OH_7lev_agl.dat, surfdata.t, surfdepo.t ) needed to run FLEXTRA. Both absolute and relative path can be given here. If the default value (the string AS_MV_FLEXPART_RESOURCES) is used or left blank Metview will use the MV_FLEXPART_RESOURCES environment variable to locate the resources.
Input Mode
Defines 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. Input Data
Holds a FLEXPART Prepare icon specifying the input data location. Enabled when Input Mode is set to Icon.
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 or left blank it indicates that the AVAILABLE file is located in the same directory 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.
Run Label
Specifies a run label for the FLEXPART simulation.
Simulation Direction
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 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 HH[:MM[:SS]]
format.
Ending Date
Specifies the ending date of the simulation in 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 HH[:MM[:SS]]
format.
Output Rate
Specifies the frequency for the output generation. The output is averaged over the period given in Output Averaging Interval. The format is HHH[:MM[:SS]]
. The default value is 3 (hours).
Output Averaging Interval
Specifies the averaging interval for the output generation in HHH[:MM[:SS]]
format. If 0 is given here instantaneous values are written into the output files. The default value is 3 (hours).
Output Sampling Rate
Specifies the sampling rate 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).
Output Field Type
Specifies the type of the gridded output. The possible values are: none (no gridded output), conc (concentration), mixr (mixing ratio) and both (concentration and mixing ratio). The default value is conc.
Output Flux
Specifies if the fluxes should be computed and written out as a gridded output (on or off). Fluxes corresponding to northward, southward, eastward, westward, upward and downward directions are calculated for each grid cell of the output grid.The control surfaces are placed in the middle of each output grid cell. The default value is off.
Output Trajectory
Specifies if the plume trajectories should be computed (on or off). The default value is off.
Output Area
Specifies the area for the gridded output in degrees in S/W/N/E
format. The default value is -90/-180/90/180.
Output Grid
Specifies the grid resolution for the gridded output in degrees as east_west_resolution/north_south_resolution
. 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.
Species Path
Specifies the location of the species files files. Both an absolute and relative path can be given here. If the default value (the string AS_MV_FLEXPART_SPECIES) is used or left blank Metview will use the MV_FLEXPART_SPECIES environment variable to locate the species.
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 NNN number appearing in the the name of the SPECIES_NNN files. These files contain 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). The default value is 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). The default value is mass.
Receptors
Enables the usage 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 off.
Receptor Names
Specifies the list of receptor site names.The default value is an empty list.
Receptor Latitudes
Specifies the list of receptor site latitudes. The default value is an empty list.
Receptors Longitudes
Specifies the list of receptor 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.
Particle Splitting Constant
Specifies the time constant for particle splitting in seconds. Particles are split into two after every N seconds given here. If -1 is given here particle splitting is not used. The default value is -1 (no splitting).
Sync Interval
All processes are synchronized with this time interval, therefore, all other time constants must be multiples of this value. Output interval and Output Averaging Interval must be at least twice of this value. The default value is 900.
Ctl
Specifies the ???. CTL must be >1 for time steps shorter than the Lagrangian time scale If CTL<0, a purely random walk simulation is done. The default value -4.
Vertical Timestep Reduction
Specifies the reduction factor (as an integer) for time step used for vertical wind. The default value is 4.
Dump Particle Possition
Specifies the list of height levels of the gridded output. The levels are given in metres units. The default value is an empty list.
Subgrid Terrain
Enables subgridscale terrain parametrization (increase of mixing heights due to subgridscale orographic variations) (on or off). The default value is off.
Convection
Enables convection parametrization (on or off). The default value is off.
Age Spectra
Enables the calculation of age spectra (on or off). If it is on Ageclasses must be defined. The default value is off.
Output For Each Release
Specifies the list of height levels of the gridded output. The levels are given in metres units. The default value is an empty list.
Domain Fill
Specifies the list of height levels of the gridded output. The levels are given in metres units. The default value is an empty list.
Quasi Lagrangian
Specifies the list of height levels of the gridded output. The levels are given in metres units. The default value is an empty list.
Nested Output
Specifies the list of height levels of the gridded output. The levels are given in metres units. The default value is an empty list.
Write Initial Conditions
Specifies the list of height levels of the gridded output. The levels are given in metres units. The default value is an empty list.
12.IPOUT determines whether particle positions are outputted (in addition
to the gridded concentrations or mixing ratios) or not.
0=no output, 1 output every output interval, 2 only at end of the
simulation
16. If IPIN=1, a file "partposit_end" from a previous run must be available in
the output directory. Particle positions are read in and previous simulation
is continued. If IPIN=0, no particles from a previous run are used
17. IF IOUTPUTFOREACHRELEASE is set to 1, one output field for each location
in the RLEASE file is created. For backward calculation this should be
set to 1. For forward calculation both possibilities are applicable.
19. If MDOMAINFILL is set to 1, the first box specified in file RELEASES is used
as the domain where domain-filling trajectory calculations are to be done.
Particles are initialized uniformly distributed (according to the air mass
distribution) in that domain at the beginning of the simulation, and are
created at the boundaries throughout the simulation period.
20. IND_SOURCE switches between different units for concentrations at the source
NOTE that in backward simulations the release of computational particles
takes place at the "receptor" and the sampling of particles at the "source".
1=mass units (for bwd-runs = concentration)
2=mass mixing ratio units
21. IND_RECEPTOR switches between different units for concentrations at the receptor
1=mass units (concentrations)
2=mass mixing ratio units
22. MQUASILAG indicates whether particles shall be numbered consecutively (1) or
with their release location number (0). The first option allows tracking of
individual particles using the partposit output files
23. NESTED_OUTPUT decides whether model output shall be made also for a nested
output field (normally with higher resolution)
24. LINIT_COND determines whether, for backward runs only, the sensitivity to initial
conditions shall be calculated and written to output files
0=no output, 1 or 2 determines in which units the initial conditions are provided.