persim.plot_diagrams

persim.plot_diagrams(diagrams, plot_only=None, title=None, xy_range=None, labels=None, colormap='default', size=20, ax_color=array([0., 0., 0.]), diagonal=True, lifetime=False, legend=True, show=False, ax=None)[source]

A helper function to plot persistence diagrams.

Parameters:

  • diagrams (ndarray (n_pairs, 2) or list of diagrams) – A diagram or list of diagrams. If diagram is a list of diagrams, then plot all on the same plot using different colors.

  • plot_only (list of numeric) – If specified, an array of only the diagrams that should be plotted.

  • title (string, default is None) – If title is defined, add it as title of the plot.

  • xy_range (list of numeric [xmin, xmax, ymin, ymax]) – User provided range of axes. This is useful for comparing multiple persistence diagrams.

  • labels (string or list of strings) – Legend labels for each diagram. If none are specified, we use H_0, H_1, H_2,… by default.

  • colormap (string, default is 'default') –

    Any of matplotlib color palettes. Some options are ‘default’, ‘seaborn’, ‘sequential’. See all available styles with

    import matplotlib as mpl
print(mpl.styles.available)

  • size (numeric, default is 20) – Pixel size of each point plotted.

  • ax_color (any valid matplotlib color type.) – See [https://matplotlib.org/api/colors_api.html](https://matplotlib.org/api/colors_api.html) for complete API.

  • diagonal (bool, default is True) – Plot the diagonal x=y line.

  • lifetime (bool, default is False. If True, diagonal is turned to False.) – Plot life time of each point instead of birth and death. Essentially, visualize (x, y-x).

  • legend (bool, default is True) – If true, show the legend.

  • show (bool, default is False) – Call plt.show() after plotting. If you are using self.plot() as part of a subplot, set show=False and call plt.show() only once at the end.