...
Note | ||
---|---|---|
| ||
Please note that this tutorial requires Metview version 4.3.0 or later. | ||
Warning |
Table of Contents |
---|
Preparations
...
First, set the input data parameters:
Flextra Input Mode | Path |
Flextra Input Data Path | /scratch/graphics/cgr/flextra_data |
Flextra Available File Path | SAME_AS_INPUT_PATH |
The selected option ('Path') for parameter Flextra Input Mode indicates that we want to specify the input data and the AVAILABLE file by their paths. Because the AVAILABLE file is also located in the same directory as the input data we simply set parameter Flextra Available File Path to SAME_AS_INPUT_PATH (it is the default value). Otherwise the full path to the AVAILABLE file should have been typed in.
In the next step we will specify the starting dates of the group of trajectories we want to generate:
Flextra Run Mode | Normal |
Flextra Trajectory Direction | Forward |
Flextra Trajectory Length | 72 |
Flextra First Starting Date | 20120111 |
Flextra First Starting Time | 3 |
Flextra Last Starting Date | 20120111 |
Flextra Last Starting Time | 15 |
Flextra Starting Time Interval | 3 |
Flextra Output Interval Mode | Interval |
Flextra Output Interval Value | 3 |
Here we set the run mode to 'NORMAL' and defined a set of forward trajectories starting on 11 January 2012 at 3, 9,12 and 15 UTC. We set the length of the trajectories to 72 h and specified that the output data (i.e. trajectory waypoints) will be written out every three hours.
...
The last step is to define the starting point parameters:
Flextra Normal Types | 1 |
Flextra Normal Names | Katla |
Flextra Normal Latitudes | 63.63 |
Flextra Normal Longitudes | -19.05 |
Flextra Normal Levels | 1512 |
Flextra Normal Level Units | 1 |
With these settings we specified the trajectory type to be three-dimensional (see below for the list of IDs for trajectory types) and set the starting point to volcano Katla (on Iceland) with the height of 1512m.
...
First, we need to set the symbol plotting type:
Legend | On |
Symbol Type | Marker |
Symbol Table Mode | Advanced |
With these settings we will plot markers (symbols) in the plot. We also set Symbol Table Mode to 'Advanced' so that we can define value intervals to which a separate maker type, colour and size can be assigned. We will construct these intervals by using the trajectory IDs. In this way the points of a given trajectory will all belong to the same interval.
The next step is to set the line properties:
Symbol Connect Line | On |
Symbol Connect Automatic Line Colour | On |
This means that we will connect the points of a given trajectory and use the same colour for the lines as for the symbols they connect.
The intervals should be set carefully so that each trajectory ID (we have five trajectories with IDs ranging from one to five) should have a separate interval:
Symbol Advanced Table Selection Type | Interval |
Symbol Advanced Table Min Value | 1 |
Symbol Advanced Table Max Value | 6 |
Symbol Advanced Table Interval | 1 |
The settings above define the following intervals:
...
The last step is to specify the graphical properties we want to assign to the intervals:
Symbol Advanced Table Max Level Colour | Cyan |
Symbol Advanced Table Min Level Colour | Blue |
Symbol Advanced Table Colour Direction | Clockwise |
Symbol Advanced Table Marker List | 15/18/12/14/15 |
Symbol Advanced Table Height List | 0.4 |
With these settings we will automatically generate our colour palette from a colour wheel by interpolating in clockwise direction between Symbol Advanced Table Min Level Colour and Symbol Advanced Table Max Level Colour.
...
Copy your 'run_normal' FLEXTRA Run icon (either right-click + duplicate, or drag with the middle mouse button), and rename the duplicate 'run_normal_back' by clicking on its title. Open its editor and start editing the date and time related parameters (the input data parameters are already set correctly for us so we do not need to change them):
Flextra Run Mode | Normal |
Flextra Trajectory Direction | Backward |
Flextra Trajectory Length | 72 |
Flextra First Starting Date | 20120114 |
Flextra First Starting Time | 3 |
Flextra Last Starting Date | 20120114 |
Flextra Last Starting Time | 15 |
Flextra Starting Time Interval | 3 |
Flextra Output Interval Mode | Interval |
Flextra Output Interval Value | 3 |
Here we set the run mode to 'NORMAL' and defined a set of backward trajectories ending on 14 January 2012 at 3, 9,12 and 15 UTC. The trajectory length will be 72 h and the output data (i.e. trajectory waypoints) will be written out every three hours.
We finish the editing by setting the end point parameters:
Flextra Normal Types | 1 |
Flextra Normal Names | Reading |
Flextra Normal Latitudes | 51.45 |
Flextra Normal Longitudes | -0.97 |
Flextra Normal Levels | 1500 |
Flextra Normal Level Units | 1 |
We selected Reading as the end point and set the height to 1500 metres. We defined the trajectory type to be three-dimensional.
...
First, we need to set the input data parameters (in the same way as we did it in Part 3 ):
Flextra Input Mode | Path |
Flextra Input Data Path | /scratch/graphics/cgr/flextra_data |
Flextra Available File Path | SAME_AS_INPUT_PATH |
In the next step we will specify the run mode and some global parameters valid for all the trajectories:
Flextra Run Mode | Cet |
Flextra Trajectory Direction | Forward |
Flextra Trajectory Length | 72 |
Flextra First Starting Date | 20120111 |
Flextra First Starting Time | 3 |
Flextra Last Starting Date | 20120111 |
Flextra Last Starting Time | 3 |
Flextra Output Interval Mode | Interval |
Flextra Output Interval Value | 3 |
Here we set the run mode to 'CET' and defined a set of forward trajectories starting on 11 January 2012 at 3 UTC. The trajectory length will be 72 h and the output data (i.e. trajectory waypoints) will be written out every three hours. Please note that for simplicity we defined only one starting time (of course we could have defined multiple ones just like in the previous chapters).
We finish the editing by setting the starting point grid:
Flextra Cet Type | 3d |
Flextra Cet Name | Katla |
Flextra Cet Area | 63.63/-19.05/63.63/-19.05 |
Flextra Cet Dx | 1 |
Flextra Cet Dy | 1 |
Flextra Cet Top Level | 3000 |
Flextra Cet Bottom Level | 1500 |
Flextra Cet Dz | 500 |
Flextra Cet Level Units | Metres ASL |
With these settings we defined a horizontal grid with only one point (exactly at the position of volcano Katla) and specified four vertical layers from 1500 to 3000 m above seal level.
...
Create a new FLEXTRA Run icon and rename it 'run_flight' then open its editor.
First, we need to set the input data parameters (in the same way as we did it in Part 3 ):
Flextra Input Mode | Path |
Flextra Input Data Path | /scratch/graphics/cgr/flextra_data |
Flextra Available File Path | SAME_AS_INPUT_PATH |
In the next step we will specify the run mode and some global parameters valid for all the trajectories:
Flextra Run Mode | Flight |
Flextra Trajectory Direction | Forward |
Flextra Trajectory Length | 72 |
Flextra Output Interval Mode | Interval |
Flextra Output Interval Value | 3 |
Here we set the run mode to 'FLIGHT' and defined a set of forward trajectories with the length of 72 h. The output data (i.e. trajectory waypoints) will be written out every three hours. Please note that this time we did not define any starting dates because in FLIGHT mode each starting point has its own starting date (see below). So parameters like Flextra First Starting Date etc. are disabled.
We finish the editing by setting the starting points, dates and times:
Flextra Flight Type | 3d |
Flextra Flight Name | track |
Flextra Flight Latitudes | 60/50/40 |
Flextra Flight Longitudes | -15/0/15 |
Flextra Flight Levels | 5000/12000/5000 |
Flextra Flight Level Units | Metres ASL |
Flextra Flight Starting Dates | 20120111/20120111/20120111 |
Flextra Flight Starting Times | 3/6/9 |
Here we set the trajectory mode to 'FLIGHT' and defined an imaginary flight track called 'track' with 3 points each being valid at a different time.
...
Please find below the list of the metadata keys used by flextra_group_get():
Key | Description | Might get a nil value |
---|---|---|
cflSpace | Spatial CFL criterion. |
|
cflTime | Temporal CFL criterion. |
|
direction | Trajectory direction. |
|
dx | West-east resolution of the input grid. |
|
dy | North-south resolution of the input grid. |
|
east | Eastern border of the input grid. |
|
integration | Integration scheme. |
|
interpolation | Interpolation type. |
|
maxInterval | The maximum interval between input fields. |
|
name | The name of group (= 'startComment'). |
|
normalInterval | The normal interval between input fields. |
|
north | Northern border of the input grid. |
|
runComment | Label for the FLEXTRA run. |
|
south | Southern border of the input grid. |
|
startComment | The name of the trajectory group (= 'name'). |
|
startDate | Date of starting points. | |
startEta | Model level of starting points. | |
startLat | Latitude of starting points. | |
startLon | Longitude of starting points. | |
startPres | Pressure of starting points. | |
startPv | Potential vorticity of starting points. | |
startTheta | Potential temperature of starting points. | |
startTime | Time of starting points. | |
startZ | Height (above sea ) of starting points. | |
startZAboveGround | Height (above ground) of starting points. | |
trNum | Number of trajectories in the group. |
|
type | Trajectory type. |
|
west | Western border of the input grid. |
|
Step 2 - Accessing Individual Trajectory Data
...
Please find below the list of the metadata keys used by flextra_tr_get()
:
Key | Description | Return value |
---|---|---|
date | Date. | list of dates |
eta | Model level. | vector |
lat | Latitude. | vector |
lon | Longitude. | vector |
pres | Pressure. | vector |
pv | Potential vorticity. | vector |
startDate | Date of starting point. | string |
startEta | Model level of starting point. | string |
startLat | Latitude of starting point. | string |
startLon | Longitude of starting point. | string |
startPres | Pressure of starting point. | string |
startPv | Potential vorticity of starting point. | string |
startTheta | Potential temperature of starting point. | string |
startTime | Time of starting point. | string |
startZ | Height (above sea) of starting point | string |
startZAboveGround | Height (above ground) of starting point | string |
stopIndex | Stop index of computations. | string |
theta | Potential temperature. | vector |
z | Height above sea level. | vector |
zAboveGroundLevel | Height above ground level. | vector |
Anchor | ||||
---|---|---|---|---|
|
...
Open the editor of 'run_multi' and start editing the starting point parameters (now we will use the same input data and starting date settings as in the original icon so we do not need to change these settings):
Flextra Normal Types | 1/1 |
Flextra Normal Names | Katla/Stromboli |
Flextra Normal Latitudes | 63.63/38.79 |
Flextra Normal Longitudes | -19.05/15.21 |
Flextra Normal Levels | 1512/926 |
Flextra Normal Level Units | 1/1 |
Here we defined two starting points: volcano Katla (as in Part 3 ) and volcano Stromboli. We set the starting heights to the real heights of these volcanoes and again we defined the trajectory types to be three-dimensional.
...
First, open its editor and set the following parameters:
Flextra Prepare Mode | Forecast |
Flextra Date | -1 |
Flextra Time | 0 |
Flextra Step | 0/3/6 |
The selected option ('Forecast') for parameter Flextra Prepare Mode indicates that we want to generate the input data from a given forecast. We specified the run date (-1 means yesterday) and run time of the forecast and defined the forecast steps as well. We used a relative date here because MARS retrievals are much faster for current dates.
In the next step we define the area and grid:
Flextra Area | 60/-25/70/-15 |
Flextra Grid | 1/1 |
We also indicate that we want to reuse the already existing input data (the meaning of this parameter will be explained later in detail):
Flextra Reuse Input | On |
Last, we need to define the output directory:
Flextra Output Path | your_path_to_flextra_data |
Here you need to define the output directory where the GRIB files and the AVAILABLE file will be generated. Please note that the resulting files are rather small (around 1.5 Mb in total) so probably you do not need to worry about your quota.
...