Network.plot(projection='global', resolution='l', continent_fill_color='0.9', water_fill_color='1.0', marker='v', size=225, label=True, color='#b15928', time=None, show=True, outfile=None, method=None, fig=None, **kwargs)[source]

Creates a preview map of all stations in current network object.

  • projection (str, optional)

    The map projection. Currently supported are:

    • "global" (Will plot the whole world.)
    • "ortho" (Will center around the mean lat/long.)
    • "local" (Will plot around local events)

    Defaults to “global”

  • resolution (str, optional)

    Resolution of the boundary database to use. Will be based directly to the basemap module. Possible values are:

    • "c" (crude)
    • "l" (low)
    • "i" (intermediate)
    • "h" (high)
    • "f" (full)

    Defaults to "l"

  • continent_fill_color (Valid matplotlib color, optional) Color of the continents. Defaults to "0.9" which is a light gray.
  • water_fill_color (Valid matplotlib color, optional) Color of all water bodies. Defaults to "white".
  • marker (str) Marker symbol (see matplotlib.pyplot.scatter()).
  • label (bool) Whether to label stations with “network.station” or not.
  • color (str) Face color of marker symbol (see matplotlib.pyplot.scatter()). Defaults to the first color from the single-element “Paired” color map.
  • time (UTCDateTime) Only plot stations available at given point in time.
  • show (bool) Whether to show the figure after plotting or not. Can be used to do further customization of the plot before showing it.
  • outfile (str) Output file path to directly save the resulting image (e.g. "/tmp/image.png"). Overrides the show option, image will not be displayed interactively. The given path/file name is also used to automatically determine the output format. Supported file formats depend on your matplotlib backend. Most backends support png, pdf, ps, eps and svg. Defaults to None.
  • method (str)

    Method to use for plotting. Possible values are:

    • 'basemap' to use the Basemap library
    • 'cartopy' to use the Cartopy library
    • None to use the best available library

    Defaults to None.

  • fig (matplotlib.figure.Figure) Figure instance to reuse, returned from a previous inventory/catalog plot call with method=basemap. If a previous basemap plot is reused, any kwargs regarding the basemap plot setup will be ignored (i.e. projection, resolution, continent_fill_color, water_fill_color). Note that multiple plots using colorbars likely are problematic, but e.g. one station plot (without colorbar) and one event plot (with colorbar) together should work well.

Figure instance with the plot.


Mollweide projection for global overview:

>>> from obspy import read_inventory
>>> net = read_inventory()[0]
>>> net.plot(label=False)  

(Source code, png, hires.png)


Orthographic projection:

>>> net.plot(projection="ortho")  

(Source code, png, hires.png)


Local (Albers equal area) projection:

>>> net.plot(projection="local")  

(Source code, png, hires.png)