csep.utils.plots.plot_catalog

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

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