(1) Interactive dialogue box
After opening Metview, with right mouse click on the macro icon and then selecting the Execute option from the menu, a dialogue box pops up showing the possible settings:
| Expand | ||
|---|---|---|
| ||
|
| Expand | ||
|---|---|---|
| ||
Multiple variables (both surface and model/pressure level ones) can be selected at the same time. In case of choosing any model or pressure level parameters, selecting also (at least) one model or pressure level should not be forgotten (multiple options are possible also here).
|
| Expand | ||
|---|---|---|
| ||
|
| Expand | ||
|---|---|---|
| ||
|
| Expand | ||
|---|---|---|
| ||
|
(2) Batch mode
In batch mode the macro can be executed following the next syntax:
| Code Block |
|---|
% metview -b macro option1 option2 option3 ... |
where macro is the macro to be run (plot_IC.mv, plot_forecastrun.mv or plot_ERAI_ERA5.mv); option1, option2 etc. are the settings listed above. A detailed help together with some useful examples is provided with simple execution of the macro:
| Code Block |
|---|
% metview -b macro |
The shell script scr_run_macros executes the macros from the UNIX/Linux shell and it can be tailored for the own needs.
| Anchor | ||||
|---|---|---|---|---|
|
| HTML |
|---|
<p> The prepared Metview macros use some external functions, macros and colour definitions which are placed in the <a href="http://download.ecmwf.int/test-data/openifs/reference_casestudies/programs/metview/definitions/" target="_blank"><span class="font_code">definitions</span></a> directory. </p> |
| Panel | ||||||||
|---|---|---|---|---|---|---|---|---|
| ||||||||
File name
|
To reach these functions and colour definitions, the path of the definitions directory has to be added to the METVIEW_MACRO_PATH (e.g., in .bashrc).
| Note |
|---|
Please note that there is an include statement in the plot_forecastrun.mv and the plot_ERAI_ERA5.mv macros and further 2 ones in the plot_IC.mv, taking the two colour definitions (base_visdef and diff_range) from this directory. The path of the definitions directory has to be set in the downloaded macros according to the local working tree (it is necessary because using dynamic path with include is not possible in the macro language). |
Input data
The input data are requested with the following content, format and name convention:
- Macro plot_IC.mv expects the ICM* files as input: ICMGG${expID}INIT_${date}, ICMGG${expID}INIUA_${date}, ICMSH${expID}INIT_${date}, where
expID is the 4-digit experiment ID;
date is day in format yyyymmdd.
The files have to be placed in the ${INPUTDIR}/${expID} folder, where INPUTDIR is the input directory specified when calling the macro. - Macros plot_forecastrun.mv expects grib files as input with the following file names: ${variable}_${date}.grib, where
variable can be t2, mslp, p, gust, t850, q700, z500, u250, u100;
date is day in format yyyymmdd.
The files have to be placed in the ${INPUTDIR}/${expID} folder, where INPUTDIR is the input directory specified when calling the macro. - Macro plot_ERAI_ERA5.mv expects grib files as input with the following file names: ${referenceID}_${variable}_${period}.grib, where
referenceID is ei for ERA-Interim and ea for ERA5;
variable can be t2, mslp, p, gust, t850, q700, z500, u250, u100;
period is the investigated time period in format of yyyymmdd-yyyymmdd (e.g., 20151201-20151206 for Desmond).
The files have to be placed in the ${INPUTDIR}/reference folder, where INPUTDIR is the input directory specified when calling the macro.
| Note |
|---|
Please note that the Metview macros expect only specifying ${INPUTDIR}/ as input directory without adding any further subdirectories (i.e, ${expID} or reference folders) into the command line. |
| Column | ||
|---|---|---|
| ||
Output figuresAll the macros produce figures in single-page .ps files (see Figure 1) with the following file names:
The .ps files can be transformed in raster format, e.g., into .png files using the convert command. (Please note that convert requires the ImageMagick software to be installed.) Setting the resolution to 120 DPI generates sharp images with limited file size:
Running the Metview macros results in a large number of figures. To have an overview on them, based on the .png files a catalogue can be prepared which contains all relevant plots for the selected variable and a given investigation aspect (e.g., to study the impact of resolution changes in the forecast) in a concise format (click below and see Figure 2 for illustration). To quickly generate such an album, 2 possibilities are provided for the users: (1) the Macro functionality of Microsoft Office Word and (2) HTML templates. |
| Column | ||
|---|---|---|
| ||
| Column | ||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||
|
| Expand | |||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| |||||||||||||||||||||||||||||
The provided Word macros (in MS Office 2013) create a table with figures for a given meteorological variable in each evaluation time step (i.e., in every 3 hours between 00 UTC 5 December and 00 UTC 6 December) from all the relevant case study.
|
| Expand | ||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||||||||||||||||||||||||||
|
| Excerpt Include | ||||||
|---|---|---|---|---|---|---|
|
...