#!/usr/bin/env python # coding: utf-8 #
# #
# # # Vorticity at various pressure levels # This notebook will provide you guidance how to explore and plot ECMWF open dataset to produce the map from the ECMWF open charts web product. # The original product can be found on this link: https://charts.ecmwf.int/products/medium-vorticity # #
#
#
#
# The full list of available Open data products can be found [here](https://www.ecmwf.int/en/forecasts/datasets/open-data), and more information can be found in the [User documentation](https://confluence.ecmwf.int/display/DAC/ECMWF+open+data%3A+real-time+forecasts+from+IFS+and+AIFS). # # Access to ECMWF Open data is governed by the Creative Commons CC-BY-4.0 licence and associated [Terms of Use](https://apps.ecmwf.int/datasets/licences/general/). # # In applying this licence, ECMWF does not waive the privileges and immunities granted to it by virtue of its status as an intergovernmental organisation nor does it submit to any jurisdiction # # To find out how to obtain the access to the full forecast dataset at higher resolution please visit our [Access page](https://www.ecmwf.int/en/forecasts/accessing-forecasts). # ## Retrieve Data # This product takes in input 1 parameter : # # * [Vorticity (relative)](https://codes.ecmwf.int/grib/param-db/138) # In this example, we will use: # - [**ecmwf.opendata**](https://github.com/ecmwf/ecmwf-opendata) Client to download the data # - [**Metview**](https://metview.readthedocs.io/en/latest/) library to read, process and plot the data # First we need to install them in the current Jupyter kernel: #
# Note: If you are running the notebook on MyBinder or already have the libraries installed, go directly to importing the libraries. #
#
# Note: If you don't have these libraries installed, click on three dots below, uncomment the code and run the next cell. #
# In[1]: #!pip install ecmwf-opendata metview metview-python # In[2]: import metview as mv from ecmwf.opendata import Client # In[3]: client = Client("ecmwf", beta=False) # In[4]: parameters = ['vo'] filename = 'medium-vorticity.grib' filename # Setting date to 0 will download today's data. # Removing date and time altogether from the request will download the latest data. # Try commenting out date and time to download latest forecast! # In[5]: client.retrieve( date=0, time=0, step=12, stream="oper", type="fc", levtype="pl", levelist=[1000,925,850,700,500,300,250,200,50], param=parameters, target=filename ) # ## Reading and processing the data # Now we can use **Metview's read() function** to read the file. # In[6]: data = mv.read(filename) # The **describe()** function will give us the overview of the dataset. # In[7]: data.describe() # And an overview of one parameter # In[8]: data.describe('vo') # We can use **ls()** function to list all the fields in the file we downloaded. # In[9]: data.ls() # The grib file contains all the levels, and we will use the **select()** method to filter one of them. # In[10]: vo700 = data.select(level = 700) vo700.describe() # In order to match the units in the Open charts plot, we need to multiply the data with 100000. # # In[11]: vo700 *= 100000 # ## Plotting the data # And finally, we can plot the data on the map. # In[12]: # define coastlines coast = mv.mcoast( map_coastline_colour="charcoal", map_coastline_resolution="medium", map_coastline_land_shade="on", map_coastline_land_shade_colour="cream", map_coastline_sea_shade="off", map_boundaries="on", map_boundaries_colour= "charcoal", map_boundaries_thickness = 1, map_disputed_boundaries = "off", map_grid_colour="tan", map_label_height=0.35, ) # define view view = mv.geoview( area_mode="name", area_name="europe", coastlines=coast ) #define styles vo_shade = mv.mcont(legend= "on", contour_automatics_settings = "style_name", contour_style_name = "sh_blured_fM50t50lst_cell") title = mv.mtext( text_lines=["Vorticity at various pressure levels, level hPa ", "START TIME: ", " VALID TIME: , STEP: "], text_font_size=0.4, text_colour = 'charcoal') ecmwf_text = mv.mtext( text_lines = ["© European Centre for Medium-Range Weather Forecasts (ECMWF)", "Source: www.ecmwf.int Licence: CC-BY-4.0 and ECMWF Terms of Use", "https://apps.ecmwf.int/datasets/licences/general/"], text_justification = 'center', text_font_size = 0.3, text_mode = "positional", text_box_x_position = 6., text_box_y_position = -0.2, text_box_x_length = 8, text_box_y_length = 2, text_colour = 'charcoal') # generate plot mv.setoutput('jupyter', plot_widget=False) mv.plot(view, vo700, vo_shade, title, ecmwf_text) # To generate the png file you can run the following cell. # In[13]: png = mv.png_output( output_name = "medium-vorticity", # specify relative or full path output_title = "medium-vorticity", # title used by a viewer output_width = 1000, # set width in pixels ) mv.setoutput(png) mv.plot(view, vo700, vo_shade, title, ecmwf_text) # Note that plot produced using open data dataset will slightly differ from one from Open Charts. This is due to different resolution of the data. # Open data is on 0.25x0.25 resolution, while high resolution data is 0.1x0.1 grid.