plots.plot_cum_fmd#

seismostats.plots.plot_cum_fmd(magnitudes: ndarray, mc: float | None = None, fmd_bin: float | None = None, weights: ndarray | None = None, b_value: float | None = None, ax: Axes | None = None, color: str | None = None, color_line: str | None = None, size: int | None = None, grid: bool = False, bin_position: str = 'center', label: bool | str = True, label_line: bool | str = True) Axes#

Plots cumulative frequency magnitude distribution, optionally with a corresponding theoretical Gutenberg-Richter (GR) distribution. The GR distribution is plotted provided the b-value is given.

Parameters:
  • magnitudes – Array of magnitudes.

  • mc – Completeness magnitude of the theoretical GR distribution.

  • fmd_bin – Discretization of the magnitudes; important for the correct visualization of the data. Assumed 0 if not given. It is possible to provide a value that is larger than the actual discretization of the magnitudes.

  • weights – Weights for the magnitudes, defaults to None

  • b_value – The b-value of the theoretical GR distribution to plot.

  • ax – Axis where figure should be plotted.

  • color – Color of the data points. If None is chosen, it will be set to the default matplotlib color cycle.

  • color_line – Color of the GR line, if None is chosen, it will be the same as the data points.

  • size – Size of the data points.

  • grid – Indicates whether or not to include grid lines.

  • bin_position – Position of the bin, options are ‘center’ and ‘left’ accordingly, left edges of bins or center points are returned.

  • label – Label of the data points. If True, it will be set to “cumulative”. If a string is provided, it will be used as the label for the data points. If False, no label is shown.

  • label_line – If True, the GR line will be labeled as “GR fit”, together with the provided b-value. If a string is provided, it will be used as the label for the GR line. If False, no label is shown.

Returns:

ax – The ax object that was plotted on.