csep.utils.plots.plot_catalog

csep.utils.plots.plot_catalog(catalog, ax=None, show=False, extent=None, set_global=False, plot_args=None)[source]

Plot catalog in a region

Parameters
  • catalog (CSEPCatalog) – Catalog object to be plotted

  • ax (matplotlib.pyplot.ax) – Previously defined ax object (e.g from plot_spatial_dataset)

  • show (bool) – Flag if the figure is displayed

  • extent (list) – default 1.05-catalog.region.get_bbox()

  • set_global (bool) – Display the complete globe as basemap

  • plot_args (dict) –

    matplotlib and cartopy plot arguments. The dictionary keys are str, whose items can be:

    • figsize

      tuple/list - default [6.4, 4.8]

    • title

      str - default catalog.name

    • title_size

      int - default 10

    • filename

      str - File to save figure. default None

    • projection

      cartopy.crs.Projection - default cartopy.crs.PlateCarree. Note: this can be ‘fast’ to apply an approximate transformation of axes.

    • basemap

      str/None. Possible values are: stock_img, stamen_terrain, stamen_terrain-background, google-satellite, ESRI_terrain, ESRI_imagery, ESRI_relief, ESRI_topo, ESRI_terrain, or webservice link. Default is None

    • coastline

      bool - Flag to plot coastline. default True,

    • grid

      bool - default True

    • grid_labels

      bool - default True

    • grid_fontsize

      float - default 10.0

    • marker

      str - Marker type

    • markersize

      float - Constant size for all earthquakes

    • markercolor

      str - Color for all earthquakes

    • borders

      bool - Flag to plot country borders. default False,

    • region_border

      bool - Flag to plot the catalog region border. default True,

    • alpha

      float - Transparency for the earthquakes scatter

    • mag_scale

      float - Scaling of the scatter

    • legend

      bool - Flag to display the legend box

    • legend_loc

      int/str - Position of the legend

    • mag_ticks

      list - Ticks to display in the legend

    • labelspacing

      int - Separation between legend ticks

    • tile_scaling

      str/int. Zoom level (1-12) of the basemap tiles. If ‘auto’, is automatically derived from extent

    • linewidth

      float - Line width of borders and coast lines. default 1.5,

    • linecolor

      str - Color of borders and coast lines. default ‘black’,

Returns

matplotlib.pyplot.ax object