holoviz / hvplot

A high-level plotting API for pandas, dask, xarray, and networkx built on HoloViews
https://hvplot.holoviz.org
BSD 3-Clause "New" or "Revised" License
1.13k stars 109 forks source link

Document that hvPlot defaults to plotting 2D DataArrays with an Image and not a QuadMesh unlike xarray #958

Open maximlt opened 2 years ago

maximlt commented 2 years ago

xarray defaults to plotting 2D DataArrays with xarray.plot.pcolormesh (link):

We use xarray.plot.pcolormesh() as the default two-dimensional plot method because it is more flexible than xarray.plot.imshow(). However, for large arrays, imshow can be much faster than pcolormesh. If speed is important to you and you are plotting a regular mesh, consider using imshow.

hvPlot defaults to plotting in Image element, not a QuadMesh. This should be emphasized in the documentation.

jbednar commented 2 years ago

Sounds good. I think the current behavior is safe since I believe it will complain if it the grid is not regularly spaced.