Method points

hvplot/plotting/core.py:1253–1313

A `points` plot visualizes positions in a 2D space. This is useful for example for geographic plots. Although the :meth:`hvplot.hvPlot.scatter` plot is superficially similar to the ``points`` plot (they can generate plots that look identical), the two plot t

(self, x=None, y=None, **kwds)

        return self(kind='dataset', **dict(kwds, columns=columns))

    def points(self, x=None, y=None, **kwds):
        """
        A `points` plot visualizes positions in a 2D space. This is useful for example for
        geographic plots.

        Although the :meth:`hvplot.hvPlot.scatter` plot is superficially
        similar to the ``points`` plot (they can generate plots that look
        identical), the two plot types are semantically quite different.
        The fundamental difference is that ``scatter`` is used to visualize
        data where the y variable is dependent, unlike ``points``.

        This difference means that ``points`` plots can most naturally
        overlay with other plots that express independent variables in
        two-dimensional space, such as raster types like
        :meth:`hvplot.hvPlot.image`. Conversely, ``scatter`` expresses a
        dependent relationship between x and y and thus most naturally
        overlay with chart types such as :meth:`hvplot.hvPlot.line`.

        Reference: https://hvplot.holoviz.org/ref/api/manual/hvplot.hvPlot.points.html

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

        Parameters
        ----------
        x : string, optional
            The coordinate variable along the x-axis. Default is the first numeric field.
        y : string, optional
            The coordinate variable along the y-axis. Default is the second numeric field.
        c : string, optional
            The dimension to color the points by
        s : int, optional, also available as 'size'
            The size of the marker
        marker : string, optional
            The marker shape specified above can be any supported by matplotlib, e.g. s, d, o etc.
            See https://matplotlib.org/stable/api/markers_api.html.
        scale: number, optional
            Scaling factor to apply to point scaling. Default is 1.
        logz : bool
            Whether to apply log scaling to the z-axis. Default is False.
        **kwds : optional
            Additional keywords arguments are documented in :ref:`plot-options`.
            Run ``hvplot.help('points')`` for the full method documentation.

        Returns
        -------
        :class:`holoviews:holoviews.element.Points` / Panel object
            You can `print` the object to study its composition and run:

            .. code-block::

                import holoviews as hv
                hv.help(the_holoviews_object)

            to learn more about its parameters and options.

        References
        ----------