act.plotting.HistogramDisplay.plot_heatmap

HistogramDisplay.plot_heatmap(x_field, y_field, dsname=None, x_bins=None, y_bins=None, subplot_index=(0,), set_title=None, density=False, set_shading='auto', **kwargs)[source]

This procedure will plot a heatmap of a histogram from 2 variables.

Parameters:
  • x_field (str) – The name of the field to take the histogram of on the X axis.

  • y_field (str) – The name of the field to take the histogram of on the Y axis.

  • dsname (str or None) – The name of the datastream the field is contained in. Set to None to let ACT automatically determine this.

  • x_bins (array-like or None) – The histogram bin boundaries to use for the variable on the X axis. Set to None to use numpy’s default boundaries.

  • y_bins (array-like or None) – The histogram bin boundaries to use for the variable on the Y axis. Set to None to use numpy’s default boundaries.

  • subplot_index (tuple) – The subplot index to place the plot in

  • set_title (str) – The title of the plot.

  • density (bool) – Set to True to plot a p.d.f. instead of a frequency histogram.

  • set_shading (string) – Option to to set the matplotlib.pcolormesh shading parameter. Default to ‘auto’

  • Other keyword arguments will be passed into :func:`matplotlib.pyplot.pcolormesh`.

Returns:

return_dict (dict) – A dictionary containing the plot axis handle, bin boundaries, and generated histogram.