Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

This tutorial can only work at ECMWF because it uses large local data files.
Note
titleRequirements

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.

(tick)

startEta

Model level of starting points.

(tick)

startLat

Latitude of starting points.

(tick)

startLon

Longitude of starting points.

(tick)

startPres

Pressure of starting points.

(tick)

startPv

Potential vorticity of starting points.

(tick)

startTheta

Potential temperature of starting points.

(tick)

startTime

Time of starting points.

(tick)

startZ

Height (above sea ) of starting points.

(tick)

startZAboveGround

Height (above ground) of starting points.

(tick)

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
multiple_output
multiple_output
Multiple Outputs

...

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.

...