Class hvPlot

hvplot/plotting/core.py:1633–1988

The plotting method: `df.hvplot(...)` creates a plot similarly to the familiar Pandas `df.plot` method. For more detailed options use a specific plotting method, e.g. `df.hvplot.line`. Reference: https://hvplot.holoviz.org/ref/api/index.html Plotting options: https://hvplot.h

class hvPlot(hvPlotTabular):
    """
    The plotting method: `df.hvplot(...)` creates a plot similarly to the familiar Pandas
    `df.plot` method.

    For more detailed options use a specific plotting method, e.g. `df.hvplot.line`.

    Reference: https://hvplot.holoviz.org/ref/api/index.html

    Plotting options: https://hvplot.holoviz.org/ref/plotting_options/index.html

    Parameters
    ----------
    x : string, optional
        Field name(s) to draw x-positions from. If not specified, the index is
        used.
    y : string or list, optional
        Field name(s) to draw y-positions from. If not specified, all numerical
        fields are used.
    kind : string, optional
        The kind of plot to generate, e.g. 'area', 'bar', 'line', 'scatter' etc. To see the
        available plots run `print(df.hvplot.__all__)`.
    **kwds : optional
        Additional keywords arguments are documented in :ref:`plot-options`.

    Returns
    -------
    A Holoviews object. You can `print` the object to study its composition and run `hv.help` on
    the object to learn more about its parameters and options.

    Examples
    --------

    .. code-block::

        import hvplot.pandas
        import pandas as pd

        df = pd.DataFrame(
            {
                "actual": [100, 150, 125, 140, 145, 135, 123],
                "forecast": [90, 160, 125, 150, 141, 141, 120],
                "numerical": [1.1, 1.9, 3.2, 3.8, 4.3, 5.0, 5.5],
                "date": pd.date_range("2022-01-03", "2022-01-09"),
                "string": ["Mon", "Tue", "Wed", "Thu", "Fri", "Sat", "Sun"],
            },
        )
        line = df.hvplot.line(
            x="numerical",
            y=["actual", "forecast"],
            ylabel="value",
            legend="bottom",
            height=500,
            color=["steelblue", "teal"],
            alpha=0.7,
            line_width=5,
        )
        line