.. note:: This tutorial was generated from an IPython notebook that can be
          downloaded `here <../../notebooks/plotting.ipynb>`_.

.. _plotting:



Plotting
========

Every region has a plotting function, that draws the outline of all (or
selected) regions on a cartopy map. We use the predefined SREX regions
as example.

Import regionmask and check the version:

.. code:: python

    import regionmask
    
    regionmask.__version__




.. parsed-literal::

    '0.5.0+dev'



Plot all regions
----------------

Do the default plot.

.. code:: python

    regionmask.defined_regions.srex.plot();



.. image:: plotting_files/plotting_5_0.png


Plot only a Subset of Regions
-----------------------------

.. code:: python

    # load cartopy
    import cartopy.crs as ccrs
    
    # regions can be selected by number, abbreviation or long name
    regions = [11, "CEU", "S. Europe/Mediterranean"]
    
    # choose a good projection for regional maps
    proj = ccrs.LambertConformal(central_longitude=15)
    
    # do the plot
    ax = regionmask.defined_regions.srex.plot(
        regions=regions, add_ocean=False, resolution="50m", proj=proj, label="abbrev"
    )
    
    # fine tune the extent
    ax.set_extent([-15, 45, 28, 76], crs=ccrs.PlateCarree())



.. image:: plotting_files/plotting_7_0.png


Plotting the region outlines only (no map)
------------------------------------------

.. code:: python

    regionmask.defined_regions.srex.plot_regions();



.. image:: plotting_files/plotting_9_0.png


.. note:: This does *not* create a cartopy axes.

To achieve this, you need to explicitely create the axes:

.. code:: python

    import matplotlib.pyplot as plt
    
    f, ax = plt.subplots(subplot_kw=dict(projection=ccrs.PlateCarree()))
    
    regionmask.defined_regions.srex.plot_regions(ax=ax, line_kws=dict(lw=1));



.. image:: plotting_files/plotting_12_0.png