Versions Compared

Key

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



HTML
<p style="margin-top: 20.0px;">
The visualization package is available in the <a href="https://software.ecmwf.int/stash/projects/OIFS/repos/oifs40r1/browse/casestudies?at=refs%2Fheads%2Fevaluation" target="_blank"><span class="font_code">casestudies</span></a> directory in the <a href="https://software.ecmwf.int/stash/projects/OIFS/repos/oifs40r1/browse?at=refs%2Fheads%2Fevaluation" target="_blank"><span class="font_code">evaluation</span></a> branch of the <a href="https://software.ecmwf.int/stash/projects/OIFS/repos/oifs40r1/browse" target="_blank">OpenIFS repository (for cycle 40r1)</a>. It contains the following folders and file:
</p>


Panel
borderColor#cccccc
borderWidth1
borderStylesolid
titleContent of the visualization package

Folder or file      Description

HTML
<p><span style="font-family: Monospace;"><a href="https://software.ecmwf.int/stash/projects/OIFS/repos/oifs40r1/browse/casestudies/macros?at=evaluation" target="_blank">macros</a>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp: place of Metview visualization macros<br/>
<a href="https://software.ecmwf.int/stash/projects/OIFS/repos/oifs40r1/browse/casestudies/definitions?at=refs%2Fheads%2Fevaluation" target="_blank">definitions</a>&nbsp;&nbsp;&nbsp;&nbsp;: place of some external functions and macros used by the macros<br/>
input&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;: input directory for the input files (downloaded and prepared based on the <a href="https://software.ecmwf.int/wiki/display/OIFS/6.3+Data+pre-processing+for+visualization" target="_blank">earlier instructions</a>)<br/>
<a href="https://software.ecmwf.int/stash/projects/OIFS/repos/oifs40r1/browse/casestudies/figs/docs?at=refs%2Fheads%2Fevaluation" target="_blank">figs</a>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;: output directory for the figures<br/>
<a href="https://software.ecmwf.int/stash/projects/OIFS/repos/oifs40r1/browse/casestudies/README?at=refs%2Fheads%2Fevaluation" target="_blank">README</a>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;: description about the content of the visualization package</span></p>




Panel
bgColorwhite
titleBGColorlightlightgrey
titleOn this page...

Table of Contents
maxLevel4
indent20px


CSS Stylesheet
.cell_nopadding {
    padding: 3px;
    border: 0px;
}

.cell_leftmargin {
    padding-left: 30px;
}

.cell_top-bottom-border {
    border-top: 1px solid #3572b0;
    border-bottom: 1px solid #3572b0;
    border-left: 0px;
    border-right: 0px;
    padding: 3px;
}

.table_noborder {
    border: 0px;
}

.vertical {
    height: 100%;
}

.vertical td:first-child {
    position: relative;
    width: 35px;
    padding: 0;
    border: 2px solid #ddd;
}

.vertical_text {
    display: block;
    white-space: nowrap;
    -moz-transform: rotate(-90deg);
    -moz-transform-origin: center center;
    -webkit-transform: rotate(-90deg);
    -webkit-transform-origin: center center;
    -ms-transform: rotate(-90deg);
    -ms-transform-origin: center center;
    position: absolute;
    width:25px;
    color: #205081;
}

.table_line {
    padding: 0;
    height: 2px;
    border-left: 0px;
    border-right: 0px;
}

.table_line td:first-child {
    padding: 0;
    height: 2px;
    border-left: 0px;
    border-right: 0px;
}

.font_background_cyan {
    background-color: cyan;
}

.font_background_yellow {
    padding: 2px;
    background-color: #ffffb3;
}

.font_background_grey {
    padding: 2px;
    background-color: #dddddd;
}

.font_code_black {
    color: #000000;
    font-family: Monospace;
}

.font_code {
    font-family: Monospace;
}

.li_withspace {
    margin-bottom: 10px;
}

.img_withoutspace {
    margin-bottom: -12px;
} 


Using the Metview macros

Panel
borderColor#cccccc
borderWidth1
borderStylesolid
titleThe available Metview macros

File name                  Description

HTML
<span style="font-family: Monospace;">
<p style="margin-top: 10.0px;margin-bottom: 10.0px;">
<a href="https://software.ecmwf.int/stash/projects/OIFS/repos/oifs40r1/browse/casestudies/macros/plot_IC.mv?at=evaluation" target="_blank">plot_IC.mv</a>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp: Metview macro to visualize the initial conditions for 2 T255L91 experiments and the difference between them<br/>
<a href="https://software.ecmwf.int/stash/projects/OIFS/repos/oifs40r1/browse/casestudies/macros/plot_forecastrun.mv?at=evaluation" target="_blank">plot_forecastrun.mv</a>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;: Metview macro to visualize the results of forecast experiments<br/>
<a href="https://software.ecmwf.int/stash/projects/OIFS/repos/oifs40r1/browse/casestudies/macros/plot_ERAI_ERA5.mv?at=evaluation" target="_blank">plot_ERAI_ERA5.mv</a>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;: Metview macro to visualize the ERA-Interim or ERA5 data
</p>
<p style="margin-top: 10.0px;margin-bottom: 10.0px;">
<a href="https://software.ecmwf.int/stash/projects/OIFS/repos/oifs40r1/browse/casestudies/macros/dialog_plot_IC?at=refs%2Fheads%2Fevaluation" target="_blank">dialog_plot_IC</a>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;: Metview dialogue box (in macro language) to <a href="https://software.ecmwf.int/stash/projects/OIFS/repos/oifs40r1/browse/casestudies/macros/plot_IC.mv?at=evaluation" target="_blank">plot_IC.mv</a><br/>
<a href="https://software.ecmwf.int/stash/projects/OIFS/repos/oifs40r1/browse/casestudies/macros/dialog_plot_forecastrun?at=refs%2Fheads%2Fevaluation" target="_blank">dialog_plot_forecastrun</a>&nbsp;: Metview dialogue box (in macro language) to <a href="https://software.ecmwf.int/stash/projects/OIFS/repos/oifs40r1/browse/casestudies/macros/plot_forecastrun.mv?at=evaluation" target="_blank">plot_forecastrun.mv</a><br/>
<a href="https://software.ecmwf.int/stash/projects/OIFS/repos/oifs40r1/browse/casestudies/macros/dialog_plot_ERAI_ERA5?at=refs%2Fheads%2Fevaluation" target="_blank">dialog_plot_ERAI_ERA5</a>&nbsp;&nbsp;&nbsp;: Metview dialogue box (in macro language) to <a href="https://software.ecmwf.int/stash/projects/OIFS/repos/oifs40r1/browse/casestudies/macros/plot_ERAI_ERA5.mv?at=evaluation" target="_blank">plot_ERAI_ERA5.mv</a>
</p>
<p style="margin-top: 10.0px;margin-bottom: 10.0px;">
<a href="https://software.ecmwf.int/stash/projects/OIFS/repos/oifs40r1/browse/casestudies/macros/help_plot_IC?at=refs%2Fheads%2Fevaluation" target="_blank">help_plot_IC</a>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;: help file to <a href="https://software.ecmwf.int/stash/projects/OIFS/repos/oifs40r1/browse/casestudies/macros/plot_IC.mv?at=evaluation" target="_blank">plot_IC.mv</a><br/>
<a href="https://software.ecmwf.int/stash/projects/OIFS/repos/oifs40r1/browse/casestudies/macros/help_plot_forecastrun?at=refs%2Fheads%2Fevaluation" target="_blank">help_plot_forecastrun</a>&nbsp;&nbsp;&nbsp;: help file to <a href="https://software.ecmwf.int/stash/projects/OIFS/repos/oifs40r1/browse/casestudies/macros/plot_forecastrun.mv?at=evaluation" target="_blank">plot_forecastrun.mv</a><br/>
<a href="https://software.ecmwf.int/stash/projects/OIFS/repos/oifs40r1/browse/casestudies/macros/help_plot_ERAI_ERA5?at=refs%2Fheads%2Fevaluation" target="_blank">help_plot_ERAI_ERA5</a>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;: help file to <a href="https://software.ecmwf.int/stash/projects/OIFS/repos/oifs40r1/browse/casestudies/macros/plot_ERAI_ERA5.mv?at=evaluation" target="_blank">plot_ERAI_ERA5.mv</a>
</p>
<p style="margin-top: 10.0px;">
<a href="https://software.ecmwf.int/stash/projects/OIFS/repos/oifs40r1/browse/casestudies/macros/scr_run_macros?at=refs%2Fheads%2Fevaluation" target="_blank">scr_run_macros</a>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;: shell script to execute the Metview macros
</p>
</span>


The visualization can be done by the Metview macros (*.mv files) in two ways: (1) interactively using a dialogue box or (2) in batch mode.

(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
titleSpecifications of data to be visualized

case study in dialog_plot_IC: Xaver (2013/12) or Desmond (2015/12);

experiment in dialog_plot_forecastrun: the 4-digit experiment ID number of forecast experiment;

reference in dialog_plot_ERAI_ERA5: ERA-Interim or ERA5;


Expand
titleSettings of the surface and upper level parameters

surface parameters in dialog_plot_IC: 3 variables are available for visualisation, soil level temperature 2, surface pressure, (model) orography;

model level parameters in dialog_plot_IC: 4 variables are available for visualisation, temperature, wind, specific humidity, cloud cover;

model levels for model level variables: from 1 (uppest) to 91 (lowest);

surface parameters in dialog_plot_forecastrun and dialog_plot_ERAI_ERA5: 4 variables are available, 2-meter temperature, mean sea level pressure, precipitation, 10-meter wind gust;

pressure level parameters in dialog_plot_forecastrun and dialog_plot_ERAI_ERA5: 5 variables are available, temperature at 850 hPa, geopotential at 500 hPa, wind at 250 and 100 hPa, relative humidity at 700 hPa;

pressure levels for pressure level variables: 850, 700, 500, 250, 100 hPa;

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).

Note

Please note that to visualise different atmospheric variables on different levels (e.g., temperature at 850 hPa and humidity at 700 hPa), the macro has to be run separately with the two settings.



Expand
titleDate settings

experiment start date in dialog_plot_IC and dialog_plot_forecastrun: initial date of experiment in format yyyymmdd;

verification date in dialog_plot_forecastrun and dialog_plot_ERAI_ERA5: verification date in format yyyymmdd (20131204 or 20131205 for Xaver case, 20151204 or 20151205 for Desmond case);


Expand
titleArea settings

area can be selected with providing corners of a rectangle (the default is Europe with 25/-35/75/50 for S/W/N/E, respectively) and also using the mouse. Note that colour settings are prepared only for the default area, colours for any further region have to be fit manually;


Expand
titleDirectory settings

input directory: location of the input files;

figure directory: location of the output figures.

(2) Batch mode

In batch mode the macro can be executed following the next syntax:

Panel
% 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:

Panel
% 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.

External functions and macros

HTML
<p>
The prepared Metview macros use some external functions, macros and colour definitions which are placed in the <a href="https://software.ecmwf.int/stash/projects/OIFS/repos/oifs40r1/browse/definitions?at=refs%2Fheads%2Fevaluation" target="_blank"><span class="font_code">definitions</span></a> directory.
</p>

The prepared Metview macros use some external functions, macros and colour definitions which are placed in the definitions directory.

Panel
borderColor#cccccc
borderWidth1
borderStylesolid
titleThe external functions located in definitions directory

File name               Description

build_layout_2plus1  : layout definition with 2 left panels and 1 right panel
build_layout_single  : layout definition a single panel

titlemain            : title style for the main plot
titlemain_2L         : 2-line title style for the main plot
titlepanels          : title style for the individual panels

legend_main          : legend definition for a single page
legend_shade         : legend definition for left panels
legend_diff          : legend definition for right panel (for the difference field)

base_visdef          : colour definitions for the different variables
diff_range           : dynamic colour definitions for the difference fields

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 are 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 raw ICM* files as input: ICMCL${expID}INIT_${date}, 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.
  • 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.
  • 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).


Column
width70%

Output figures

All the macros produce figures in single-page .ps files (see Figure 1) with the following file names:

  • plot_IC.mv: ${variable}_${level}_ERAI-ERA5_${date}+${timestep}.ps, where
    variable can be stl2, lnsp, z, t, cc, u, q;
    level can be 0 (in case of surface variables) or from 1 to 91;
    date
    is day in format yyyymmdd;
    timestep
    is forecast lead time in hours, e.g., 0, 3, 6 etc.
  • plot_forecastrun.mv: ${variable}_${level}_${expID}_${date}+${timestep}.ps, where
    variable can be t2, mslp, p, gust, t, q, z, u;
    level
    can be 0 (in case of surface variables) or 850, 700, 500, 250, 100;
    expID
    is the 4-digit experiment ID;
    date
    is day in format yyyymmdd;
    timestep
    is forecast lead time in hours in format hh, e.g., 00, 03, 06 etc.
  • plot_ERAI_ERA5.mv: ${variable}_${level}_${reference}_${date}${time}.ps, where
    variable can be t2, mslp, p, gust, t, q, z, u;
    level can be 0 (in case of surface variables) or 850, 700, 500, 250, 100;
    reference can be ERAI or ERA5;
    date is day in format yyyymmdd;
    time is hour in format (h)h, e.g., 0, 3, 6, 9, 12 etc.

Running the Metview macros results in a large number of figures. To have an overview on them, a catalogue can be prepared which contains all relevant plots for the selected variable and a given investigation aspect in a concise format (click below and see Figure 2 for illustration). To quickly generate this kind of album, the Macro functionality of Microsoft Office Word can be used.


Column
width30%


Align
alignright

Anchor
figure1
figure1

Figure 1: Exemplary output figure (here: 3-hourly 10-meter wind gust at 00 UTC on 5 December 2015 from the T255L91 OpenIFS forecasts initialized from ERA-Interim at 00 UTC on 4 December 2015).




Expand
titleClick here to see the steps needed to quickly create a catalogue:


Column
width70%
  1. Convert the .ps files into .png files (images with 120 DPI are sharp enough with limited file size): convert -density 120 psfile pngfile
  2. Choose a variable (e.g., T850) and open one of the .docx files in the figs/docs directory (initial_condition_t850_table.docx). Delete all figures from the table, but keep the table itself as it is.
  3. Click on the View macros menu item in Macros menu point on View tab (in MS Office 2013) and edit the macro aainsertpicsOIFS_initialconditions. The macro source code can be seen in the opening window. The directory paths and file names can be replaced here to paths and file names valid in the local environment. This replacement can be done automatically with CTRL+H. Afterwards the macro has to be saved.
  4. Then return to the the main document, position the cursor into the cell of the first picture and run the macro (with clicking on the View macros menu item in Macros menu point on View tab and running the macro aainsertpicsOIFS_initialconditions).
  5. Save the document at the end of the macro run. The same can be repeated for all the variables.
Info

To prepare similar document for comparison of impact of resolution and startdate, the corresponding *resolution.docx, *startdate.docx files and aainsertpicsOIFS_resolutions, aainsertpicsOIFS_startdates macros have to be used.


Info

There are separate macros for precipitation figures as in this case 24-hour amount is evaluated instead of precipitation between 2 time steps (see macros aainsertprecpics*).



Column
width30%


Align
alignright

Anchor
figure2
figure2

Figure 2: Illustration of the catalogue constructed from the output figures (here: 3-hourly 10-meter wind gust from ERA-Interim and ERA5 re-analyses and the T255L91 OpenIFS forecasts initialized from ERA-Interim on different dates).





Back to top