MCPcopy Create free account
hub / github.com/holoviz/hvplot / hist

Method hist

hvplot/plotting/core.py:1026–1105  ·  view source on GitHub ↗

A `histogram` displays an approximate representation of the distribution of continuous data. Reference: https://hvplot.holoviz.org/ref/api/manual/hvplot.hvPlot.hist.html Plotting options: https://hvplot.holoviz.org/ref/plotting_options/index.html Parameters

(
        self, y=None, by=None, bins=20, bin_range=None, normed=False, cumulative=False, **kwds
    )

Source from the content-addressed store, hash-verified

1024 return self(kind='violin', x=None, y=y, by=by, **dict(kwds, hover=False))
1025
1026 def hist(
1027 self, y=None, by=None, bins=20, bin_range=None, normed=False, cumulative=False, **kwds
1028 ):
1029 """
1030 A `histogram` displays an approximate representation of the distribution of continuous data.
1031
1032 Reference: https://hvplot.holoviz.org/ref/api/manual/hvplot.hvPlot.hist.html
1033
1034 Plotting options: https://hvplot.holoviz.org/ref/plotting_options/index.html
1035
1036 Parameters
1037 ----------
1038 y : string or sequence
1039 Field(s) in the *wide* data to compute the distribution(s) from.
1040 Please note the fields should contain continuous data. Not categorical.
1041 by : string or sequence
1042 Field(s) in the *long* data to group by.
1043 bins : int or string or np.ndarray or list or tuple, optional
1044 The number of bins in the histogram, or an explicit set of bin edges
1045 or a method to find the optimal set of bin edges, e.g. 'auto', 'fd',
1046 'scott' etc. For more documentation on these approaches see the
1047 :func:`numpy.histogram_bin_edges` documentation. Default is 20.
1048 bin_range: tuple, optional
1049 The lower and upper range of the bins.
1050 Default is the minimum and maximum values of the continuous data.
1051 normed : str or bool, optional
1052 Controls normalization behavior. If ``True`` or ``'integral'``, then
1053 ``density=True`` is passed to np.histogram, and the distribution
1054 is normalized such that the integral is unity. If ``False``,
1055 then the frequencies will be raw counts. If ``'height'``, then the
1056 frequencies are normalized such that the max bin height is unity.
1057 Default is False.
1058 cumulative: bool, optional
1059 If True, then a histogram is computed where each bin gives the counts
1060 in that bin plus all bins for smaller values. The last bin gives the
1061 total number of data points. Default is False.
1062 kwds : optional
1063 Additional keywords arguments are documented in :ref:`plot-options`.
1064 Run ``hvplot.help('hist')`` for the full method documentation.
1065
1066 Returns
1067 -------
1068 :class:`holoviews:holoviews.element.Histogram` / Panel object
1069 You can `print` the object to study its composition and run:
1070
1071 .. code-block::
1072
1073 import holoviews as hv
1074 hv.help(the_holoviews_object)
1075
1076 to learn more about its parameters and options.
1077
1078 See Also
1079 --------
1080 kde : Kernel Density Estimate plot.
1081 bivariate : 2D KDE plot.
1082 contour : Isolines plot for gridded data.
1083

Calls

no outgoing calls