hvplot 0.11.0a1__tar.gz → 0.11.0a2__tar.gz

{hvplot-0.11.0a1 → hvplot-0.11.0a2}/.github/workflows/docs.yaml

@@ -50,8 +50,6 @@ jobs:
         run: |
           echo "Deploying from ref ${GITHUB_REF#refs/*/}"
           echo "tag=${GITHUB_REF#refs/*/}" >> $GITHUB_OUTPUT
-      - name: bokeh sampledata
-        run: bokeh sampledata
       - name: install dev nbsite
         run: pip install --pre -U nbsite
       - name: conda info
@@ -115,8 +113,6 @@ jobs:
         run: |
           echo "Deploying from ref ${GITHUB_REF#refs/*/}"
           echo "tag=${GITHUB_REF#refs/*/}" >> $GITHUB_OUTPUT
-      - name: bokeh sampledata
-        run: bokeh sampledata
       - name: build docs
         run: sphinx-build -b html doc builtdocs
       - name: report failure

{hvplot-0.11.0a1 → hvplot-0.11.0a2}/.github/workflows/test.yaml

@@ -132,13 +132,14 @@ jobs:
       - name: conda list
         run: conda list
       - name: bokeh sampledata
+        if: ${{ matrix.python-version == '3.9'}}
         run: bokeh sampledata
       - name: unit tests
         run: pytest -v hvplot --cov=hvplot --cov-append
       - name: unit tests geo
         run: pytest -v hvplot --geo --cov=hvplot --cov-append
       - name: examples tests
-        run: pytest -n auto --dist loadscope --nbval-lax -p no:python
+        run: pytest -n logical --dist loadscope --nbval-lax -p no:python
   pip_test:
     name: pip tests:${{ matrix.os }}:${{ matrix.python-version }}
     needs: [pre_commit, setup]
@@ -162,13 +163,14 @@ jobs:
       - name: pip list
         run: pip list
       - name: bokeh sampledata
+        if: ${{ matrix.python-version == '3.9'}}
         run: bokeh sampledata
       - name: unit tests
         run: pytest -v hvplot --cov=hvplot --cov-append
       - name: unit tests geo
         run: pytest -v hvplot --geo --cov=hvplot --cov-append
       - name: examples tests
-        run: pytest -n auto --dist loadscope --nbval-lax -p no:python
+        run: pytest -n logical --dist loadscope --nbval-lax -p no:python
       - name: Upload coverage reports to Codecov
         if: github.event_name == 'push' || github.event_name == 'pull_request'
         uses: codecov/codecov-action@v4

{hvplot-0.11.0a1 → hvplot-0.11.0a2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: hvplot
-Version: 0.11.0a1
+Version: 0.11.0a2
 Summary: A high-level plotting API for the PyData ecosystem built on HoloViews.
 Author-email: Philipp Rudiger <developers@holoviz.org>
 Maintainer-email: HoloViz developers <developers@holoviz.org>
@@ -44,12 +44,16 @@ Requires-Dist: pytest; extra == "tests-core"
 Requires-Dist: ruff; extra == "tests-core"
 Requires-Dist: scipy; extra == "tests-core"
 Requires-Dist: xarray; extra == "tests-core"
+Requires-Dist: bokeh_sampledata; python_version >= "3.10" and extra == "tests-core"
+Requires-Dist: psutil; extra == "tests-core"
 Provides-Extra: tests
 Requires-Dist: hvplot[tests-core]; extra == "tests"
 Requires-Dist: fugue[sql]; extra == "tests"
 Requires-Dist: hvplot[fugue-sql]; extra == "tests"
 Requires-Dist: ibis-framework[duckdb]; extra == "tests"
 Requires-Dist: polars; extra == "tests"
+Requires-Dist: dask; extra == "tests"
+Requires-Dist: spatialpandas; extra == "tests"
 Provides-Extra: fugue-sql
 Requires-Dist: qpd>=0.4.4; extra == "fugue-sql"
 Requires-Dist: fugue-sql-antlr>=0.2.0; extra == "fugue-sql"
@@ -92,6 +96,7 @@ Requires-Dist: streamz>=0.3.0; extra == "examples"
 Requires-Dist: xarray>=0.18.2; extra == "examples"
 Requires-Dist: xyzservices>=2022.9.0; extra == "examples"
 Requires-Dist: geodatasets>=2023.12.0; extra == "examples"
+Requires-Dist: bokeh_sampledata; python_version >= "3.10" and extra == "examples"
 Provides-Extra: tests-nb
 Requires-Dist: pytest-xdist; extra == "tests-nb"
 Requires-Dist: nbval; extra == "tests-nb"

{hvplot-0.11.0a1 → hvplot-0.11.0a2}/doc/conftest.py

@@ -1,7 +1,11 @@
-import dask
 from importlib.util import find_spec
+
+import dask
+
+from packaging.version import Version
 from bokeh.io.webdriver import webdriver_control
 
+
 collect_ignore_glob = [
     'user_guide/Streaming.ipynb',
 ]
@@ -45,3 +49,19 @@ finally:
 # From Dask 2024.3.0 they now use `dask_expr` by default
 # https://github.com/dask/dask/issues/10995
 dask.config.set({'dataframe.query-planning': False})
+
+
+# https://github.com/pydata/xarray/pull/9182
+try:
+    import xarray as xr
+except ImportError:
+    pass
+else:
+    import numpy as np
+
+    if Version(np.__version__) >= Version('2.0.0') and Version(xr.__version__) <= Version(
+        '2024.6.0'
+    ):
+        collect_ignore_glob += [
+            'user_guide/Gridded_Data.ipynb',
+        ]

{hvplot-0.11.0a1 → hvplot-0.11.0a2}/doc/getting_started/installation.md

@@ -13,7 +13,7 @@ or with `pip`:
 
     pip install hvplot
 
-For versions of `jupyterlab>=3.0` the necessary extension is automatically bundled in the `pyviz_comms` package, which must be >=2.0. However note that for version of `jupyterlab<3.0` you must also manually install the JupyterLab extension with:
+Note that `hvplot` needs to run in a Jupyter environment to automatically show output plots. However, if you are using a raw Python or IPython console, it is still possible to [show the plots](https://hvplot.holoviz.org/user_guide/Viewing.html#python-command-prompt-scripts) with `hvplot.show()` or [save the plots](https://hvplot.holoviz.org/user_guide/Viewing.html#saving-plots) even if you cannot view them interactively. For versions of `jupyterlab>=3.0` the necessary extension is automatically bundled in the `pyviz_comms` package, which must be >=2.0. However note that for version of `jupyterlab<3.0` you must also manually install the JupyterLab extension with:
 
     conda install jupyterlab
     jupyter labextension install @pyviz/jupyterlab_pyviz

hvplot-0.11.0a2/doc/reference/xarray/vectorfield.ipynb

@@ -0,0 +1,230 @@
+{
+ "cells": [
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "# Vectorfield"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "import hvplot.xarray  # noqa"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "`vectorfield` accepts 2d arrays of magnitude and angle on a grid and produces an array of vectors. x and y can be 2d or 1d coordinates. "
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "import numpy as np\n",
+    "import xarray as xr\n",
+    "import holoviews as hv\n",
+    "import cartopy.crs as ccrs"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "def sample_data(shape=(20, 30)):\n",
+    "    \"\"\"\n",
+    "    Return ``(x, y, u, v, crs)`` of some vector data\n",
+    "    computed mathematically. The returned crs will be a rotated\n",
+    "    pole CRS, meaning that the vectors will be unevenly spaced in\n",
+    "    regular PlateCarree space.\n",
+    "\n",
+    "    \"\"\"\n",
+    "    crs = ccrs.RotatedPole(pole_longitude=177.5, pole_latitude=37.5)\n",
+    "\n",
+    "    x = np.linspace(311.9, 391.1, shape[1])\n",
+    "    y = np.linspace(-23.6, 24.8, shape[0])\n",
+    "\n",
+    "    x2d, y2d = np.meshgrid(x, y)\n",
+    "    u = 10 * (2 * np.cos(2 * np.deg2rad(x2d) + 3 * np.deg2rad(y2d + 30)) ** 2)\n",
+    "    v = 20 * np.cos(6 * np.deg2rad(x2d))\n",
+    "\n",
+    "    return x, y, u, v, crs\n",
+    "\n",
+    "xs, ys, U, V, crs = sample_data()\n",
+    "\n",
+    "mag = np.sqrt(U**2 + V**2)\n",
+    "angle = (np.pi/2.) - np.arctan2(U/mag, V/mag)\n",
+    "\n",
+    "ds = xr.Dataset({'mag': xr.DataArray(mag, dims=('y', 'x'), coords={'y': ys, 'x': xs}),\n",
+    "                 'angle': xr.DataArray(angle, dims=('y', 'x'), coords={'y': ys, 'x': xs})}, \n",
+    "                attrs={'crs': crs})\n",
+    "ds"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "ds.hvplot.vectorfield(x='x', y='y', angle='angle', mag='mag', hover=False).opts(magnitude='mag')"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "## Geographic Data\n",
+    "If a dataset has an attr called `crs` which is a cartopy object or a proj4 string, then just by setting the option `geo=True` will use the correct crs."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "ds.hvplot.vectorfield(x='x', y='y', angle='angle', mag='mag',\n",
+    "                      hover=False, geo=True, tiles=\"CartoLight\")"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "If you set `coastline` or `features` it will keep the original crs and transform the features to the data crs."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "ds.hvplot.vectorfield(x='x', y='y', angle='angle', mag='mag',\n",
+    "                      hover=False, geo=True, coastline=True)"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "## Large Data"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "The visualization of vector fields from large datasets often presents a challenge.  Direct plotting methods can quickly consume excessive memory, leading to crashes or unresponsive applications. To address this issue, we introduce a dynamic downsampling technique that enables interactive exploration of vector fields without sacrificing performance. We first create a `sample_data` that contains 4,000,000 points."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "xs, ys, U, V, crs = sample_data(shape=(2000, 2000))\n",
+    "\n",
+    "mag = np.sqrt(U**2 + V**2)\n",
+    "angle = (np.pi/2.) - np.arctan2(U/mag, V/mag)\n",
+    "\n",
+    "ds = xr.Dataset({'mag': xr.DataArray(mag, dims=('y', 'x'), coords={'y': ys, 'x': xs}),\n",
+    "                 'angle': xr.DataArray(angle, dims=('y', 'x'), coords={'y': ys, 'x': xs})}, \n",
+    "                attrs={'crs': crs})\n",
+    "ds"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "If we just try to call `ds.hvplot.vectorfield` this is probably returning `MemoryError`. The alternative is to dynamically downsample the data based on the visible range. This helps manage memory consumption when dealing with large datasets, especially when plotting vector fields. We are going to use HoloViews to create a view (`hv.DynamicMap`) whose content is dynamically updated based on the data range displayed (tracked by the `hv.streams.RangeXY` stream), [find out more about these concepts](https://holoviews.org/user_guide/Custom_Interactivity.html)."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "def downsample_quiver(x_range=None, y_range=None, nmax=10):\n",
+    "    \"\"\"\n",
+    "    Creates a HoloViews vector field plot from a dataset, dynamically downsampling \n",
+    "    data based on the visible range to optimize memory usage.\n",
+    "\n",
+    "    Args:\n",
+    "        x_range (tuple, optional): Range of x values to include. Defaults to None (full range).\n",
+    "        y_range (tuple, optional): Range of y values to include. Defaults to None (full range).\n",
+    "        nmax (int, optional): Maximum number of points along each axis after coarsening. \n",
+    "                              Defaults to 10.\n",
+    "\n",
+    "    Returns:\n",
+    "        HoloViews DynamicMap: A dynamic vector field plot that updates based on the visible range.\n",
+    "    \"\"\"\n",
+    "\n",
+    "    if x_range is None or y_range is None:\n",
+    "        # No range provided, downsample the entire dataset for initial display\n",
+    "        xs, ys = ds.x.size, ds.y.size        # Get dataset dimensions\n",
+    "        ix, iy = xs // nmax, ys // nmax      # Calculate downsampling intervals\n",
+    "\n",
+    "        ix = max(1, ix)                     # Ensure interval is at least 1\n",
+    "        iy = max(1, iy)\n",
+    "\n",
+    "        sub = ds.coarsen(x=ix, y=iy, side=\"center\", boundary=\"trim\").mean()  # Downsample\n",
+    "    else:\n",
+    "        # Select data within the specified range\n",
+    "        sub = ds.sel(x=slice(*x_range), y=slice(*y_range))\n",
+    "\n",
+    "        # Downsample the selected data\n",
+    "        xs, ys = sub.x.size, sub.y.size\n",
+    "        ix, iy = xs // nmax, ys // nmax\n",
+    "        ix = max(1, ix)\n",
+    "        iy = max(1, iy)\n",
+    "        sub = sub.coarsen(x=ix, y=iy, side=\"center\", boundary=\"trim\").mean()\n",
+    "\n",
+    "    # Create the vector field plot\n",
+    "    quiver = sub.hvplot.vectorfield(\n",
+    "        x=\"x\",\n",
+    "        y=\"y\",\n",
+    "        mag=\"mag\",\n",
+    "        angle=\"angle\",\n",
+    "        hover=False,\n",
+    "    ).opts(magnitude=\"mag\")\n",
+    "\n",
+    "    return quiver"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# Create interactive plot components\n",
+    "range_xy = hv.streams.RangeXY()               # Stream to capture range changes\n",
+    "filtered = hv.DynamicMap(downsample_quiver, streams=[range_xy])  # Dynamic plot\n",
+    "filtered                                      # Display the plot"
+   ]
+  }
+ ],
+ "metadata": {
+  "language_info": {
+   "name": "python",
+   "pygments_lexer": "ipython3"
+  }
+ },
+ "nbformat": 4,
+ "nbformat_minor": 4
+}

{hvplot-0.11.0a1 → hvplot-0.11.0a2}/doc/user_guide/Customization.ipynb

@@ -66,6 +66,16 @@
     "    hover_cols (default=[]): list or str\n",
     "        Additional columns to add to the hover tool or 'all' which will\n",
     "        includes all columns (including indexes if use_index is True).\n",
+    "    hover_tooltips list[str] or list[tuple]:\n",
+    "        A list of dimensions to be displayed in the hover tooltip. See\n",
+    "        [HoloViews docs](https://holoviews.org/user_guide/Plotting_with_Bokeh.html#hover-tools)\n",
+    "        or [Bokeh docs](https://docs.bokeh.org/en/latest/docs/user_guide/interaction/tools.html#hovertool)\n",
+    "        for more info on structuring.\n",
+    "    hover_formatters:\n",
+    "        A dict of formatting options for the hover tooltip.\n",
+    "    hover_mode (default='mouse'):\n",
+    "        The hover mode determines how the hover tool is activated;\n",
+    "        select from 'mouse', 'vline', or 'hline'.\n",
     "    invert (default=False): boolean\n",
     "        Swaps x- and y-axis\n",
     "    frame_width/frame_height: int\n",
@@ -104,6 +114,10 @@
     "    rot: number\n",
     "        Rotates the axis ticks along the x-axis by the specified\n",
     "        number of degrees.\n",
+    "    subcoordinate_y: bool or dict\n",
+    "       Whether to enable sub-coordinate y systems for this plot. Accepts also a\n",
+    "       dictionary of related options to pass down to HoloViews,\n",
+    "       e.g. `{'subcoordinate_scale': 2}`.\n",
     "    shared_axes (default=True): boolean\n",
     "        Whether to link axes between plots\n",
     "    transforms (default={}): dict\n",
@@ -229,7 +243,7 @@
     "    projection (default=None):\n",
     "        Coordinate reference system of the plot (output projection) specified as a string or integer EPSG code, a CRS or Proj pyproj object, a Cartopy CRS object or class name, a WKT string, or a proj.4 string. Defaults to PlateCarree.\n",
     "    tiles (default=False):\n",
-    "        Whether to overlay the plot on a tile source. Tiles sources\n",
+    "        Whether to overlay the plot on a tile source. If coordinate values fall within lat/lon bounds, auto-projects to EPSG:3857 unless `projection=False`. Tiles sources\n",
     "        can be selected by name or a tiles object or class can be passed,\n",
     "        the default is 'Wikipedia'.\n",
     "    tiles_opts (default=None): dict\n",

{hvplot-0.11.0a1 → hvplot-0.11.0a2}/doc/user_guide/Geographic_Data.ipynb

@@ -60,7 +60,7 @@
    "source": [
     "## Tiled web map\n",
     "\n",
-    "A [tiled web map](https://en.wikipedia.org/wiki/Tiled_web_map), or tile map, is an interactive map displayed on a web browser that is divided into small, pre-rendered image tiles, allowing for efficient loading and seamless navigation across various zoom levels and geographic areas. hvPlot allows to add a tile map as a basemap to a plot with the `tiles` parameter. Importantly, `tiles` is a parameter that can be used **without installing GeoViews if the data is already projected in Web Mercator**.\n",
+    "A [tiled web map](https://en.wikipedia.org/wiki/Tiled_web_map), or tile map, is an interactive map displayed on a web browser that is divided into small, pre-rendered image tiles, allowing for efficient loading and seamless navigation across various zoom levels and geographic areas. hvPlot allows to add a tile map as a basemap to a plot with the `tiles` parameter. Importantly, `tiles` is a parameter that can be used **without installing GeoViews**.\n",
     "\n",
     "We'll display this dataframe of all US airports (including military bases overseas), the points are expressed in latitude/longitude coordinates:"
    ]
@@ -78,7 +78,11 @@
    "cell_type": "markdown",
    "metadata": {},
    "source": [
-    "We'll first start by displaying the airports **without GeoViews**. To do so, we must convert the coordinates to Web Mercator, which can be easily achieved using the `lon_lat_to_easting_northing` function provided by HoloViews, that doesn't require installing any of the usual geo dependencies like `pyproj` or `cartopy`."
+    "We'll first start by displaying the airports **without GeoViews** with tiles by setting `tiles=True`. \n",
+    "\n",
+    "Under the hood, hvPlot projects lat/lon to easting/northing (EPSG:4326 to EPSG:3857) coordinates without additional package dependencies if it detects that the values falls within expected lat/lon ranges.\n",
+    "\n",
+    "Note, **this feature is only available after `hvplot>0.10.0`**; older versions, `hvplot<=0.10.0`, require manual projection (see below)."
    ]
   },
   {
@@ -87,17 +91,14 @@
    "metadata": {},
    "outputs": [],
    "source": [
-    "from holoviews.util.transform import lon_lat_to_easting_northing\n",
-    "\n",
-    "airports['x'], airports['y'] = lon_lat_to_easting_northing(airports.Longitude, airports.Latitude)\n",
-    "airports[['Latitude', 'Longitude', 'x', 'y']].head(3)"
+    "airports.hvplot.points('Longitude', 'Latitude', tiles=True, color='red', alpha=0.2)"
    ]
   },
   {
    "cell_type": "markdown",
    "metadata": {},
    "source": [
-    "We can now easily display the airports on a basemap by setting `tiles` to `True`."
+    "If you do not want it to be auto-projected under the hood for any reason, set `projection=False`, **but note it will not be properly placed on the tiles** without manual intervention. In doing so, the data will be plotted around the [null island location](https://en.wikipedia.org/wiki/Null_Island), roughly 600km off the coast of West Africa. `padding` was added to demonstrate this."
    ]
   },
   {
@@ -106,14 +107,14 @@
    "metadata": {},
    "outputs": [],
    "source": [
-    "airports.hvplot.points('x', 'y', tiles=True, color='red', alpha=0.2)"
+    "airports.hvplot.points('Longitude', 'Latitude', tiles=True, projection=False, color='red', alpha=0.2, padding=10000)"
    ]
   },
   {
    "cell_type": "markdown",
    "metadata": {},
    "source": [
-    "A common mistake is to display data referenced in WGS84 on a tile basemap without projecting the data to Web Mercator. In doing so, the data will be plotted around the [null island location](https://en.wikipedia.org/wiki/Null_Island), roughly 600km off the coast of West Africa."
+    "To manually project use the `lon_lat_to_easting_northing` function provided by HoloViews, that doesn't require installing any of the usual geo dependencies like `pyproj` or `cartopy`."
    ]
   },
   {
@@ -122,10 +123,11 @@
    "metadata": {},
    "outputs": [],
    "source": [
-    "airports.hvplot.points(\n",
-    "    'Longitude', 'Latitude', tiles=True, color='red', alpha=0.2,\n",
-    "    xlim=(-1000000, 1000000), ylim=(-1000000, 1000000)\n",
-    ")"
+    "from holoviews.util.transform import lon_lat_to_easting_northing\n",
+    "\n",
+    "airports['x'], airports['y'] = lon_lat_to_easting_northing(airports.Longitude, airports.Latitude)\n",
+    "airports[['Latitude', 'Longitude', 'x', 'y']].head(3)\n",
+    "airports.hvplot.points('x', 'y', tiles=True, color='red', alpha=0.2)"
    ]
   },
   {
@@ -415,7 +417,7 @@
     "- `global_extent` (default=False): Whether to expand the plot extent to span the whole globe\n",
     "- `project` (default=False): Whether to project the data before plotting (adds initial overhead but avoids projecting data when plot is dynamically updated)\n",
     "- `projection` (default=None): Coordinate reference system of the plot (output projection) specified as a string or integer EPSG code, a CRS or Proj pyproj object, a Cartopy CRS object or class name, a WKT string, or a proj.4 string. Defaults to PlateCarree.\n",
-    "- `tiles` (default=False): Whether to overlay the plot on a tile source. Accept the following values:\n",
+    "- `tiles` (default=False): Whether to overlay the plot on a tile source. If coordinate values fall within lat/lon bounds, auto-projects to EPSG:3857 unless `projection=False`. Accepts the following values:\n",
     "    - `True`: OpenStreetMap layer\n",
     "    - `xyzservices.TileProvider` instance (requires [`xyzservices`](https://xyzservices.readthedocs.io/) to be installed)\n",
     "    - a map string name based on one of the default layers made available by [HoloViews](https://holoviews.org/reference/elements/bokeh/Tiles.html) ('CartoDark', 'CartoLight', 'EsriImagery', 'EsriNatGeo', 'EsriUSATopo', 'EsriTerrain', 'EsriStreet', 'EsriReference', 'OSM', 'OpenTopoMap') or [GeoViews](https://geoviews.org/user_guide/Working_with_Bokeh.html) ('CartoDark', 'CartoEco', 'CartoLight', 'CartoMidnight', 'EsriImagery', 'EsriNatGeo', 'EsriUSATopo', 'EsriTerrain', 'EsriReference', 'EsriOceanBase', 'EsriOceanReference', 'EsriWorldPhysical', 'EsriWorldShadedRelief', 'EsriWorldTopo', 'EsriWorldDarkGrayBase', 'EsriWorldDarkGrayReference', 'EsriWorldLightGrayBase', 'EsriWorldLightGrayReference', 'EsriWorldHillshadeDark', 'EsriWorldHillshade', 'EsriAntarcticImagery', 'EsriArcticImagery', 'EsriArcticOceanBase', 'EsriArcticOceanReference', 'EsriWorldBoundariesAndPlaces', 'EsriWorldBoundariesAndPlacesAlternate', 'EsriWorldTransportation', 'EsriDelormeWorldBaseMap', 'EsriWorldNavigationCharts', 'EsriWorldStreetMap', 'OSM', 'OpenTopoMap'). Note that Stamen tile sources require a Stadia account when not running locally; see [stadiamaps.com](https://stadiamaps.com/).\n",

{hvplot-0.11.0a1 → hvplot-0.11.0a2}/doc/user_guide/Plotting_with_Matplotlib.ipynb

@@ -635,6 +635,45 @@
     " crime.hvplot.table(['Year', 'Population', 'Violent Crime rate'], width=420))"
    ]
   },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "We can further enhance the plot by using a `step`s chart instead of a `bar` chart to avoid visual clutter and better represent the continuous nature of time series data. Additionally, we can display a table summarizing decade-averaged statistics to provide a quick overview of the data. The `sublabel` format and size can be customized, and if not needed, can be removed by setting `sublabel_format=\"\"` in [opts](https://holoviews.org/user_guide/Applying_Customizations.html)."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "tabledata = (\n",
+    "    crime.assign(\n",
+    "        **{\n",
+    "            \"Decade\": (crime.Year // 10) * 10,  # Calculate decade for each year\n",
+    "            \"Population [mi]\": crime.Population / 1e6,  # Population in millions\n",
+    "        }\n",
+    "    )\n",
+    "    .groupby(\"Decade\")  # Group data by decade\n",
+    "    .mean()  # Calculate mean values for each decade group\n",
+    "    [[\"Population [mi]\", \"Violent Crime rate\"]]  # Select desired columns\n",
+    "    .astype(\"int\")  # Convert selected columns to integers\n",
+    ")"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "(\n",
+    "    crime.hvplot.step(x='Year', y='Violent Crime rate', rot=90, width=550)+\n",
+    "    tabledata.hvplot.table(['Decade', 'Population [mi]', 'Violent Crime rate'], width=15, height=10)\n",
+    ").opts(sublabel_format=\"{alpha})\", sublabel_size=14)"
+   ]
+  },
   {
    "cell_type": "markdown",
    "metadata": {},

{hvplot-0.11.0a1 → hvplot-0.11.0a2}/doc/user_guide/Timeseries_Data.ipynb

@@ -20,6 +20,7 @@
    "metadata": {},
    "outputs": [],
    "source": [
+    "import numpy as np\n",
     "import hvplot.pandas  # noqa\n",
     "from bokeh.sampledata.sea_surface_temperature import sea_surface_temperature as sst\n",
     "\n",
@@ -84,6 +85,32 @@
     "sst.hvplot(autorange=\"y\")"
    ]
   },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "### Subcoordinate y-axis\n",
+    "\n",
+    "hvPlot enables you to create overlays where each element has its own distinct y-axis subcoordinate system, which is particularly useful to analyse multiple timeseries. To activate this feature that automatically distributes overlay elements along the y-axis, set the `subcoordinate_y` keyword to `True`. `subcoordinate_y` also accepts a dictionary of related options, for example set `subcoordinate_y={'subcoordinate_scale': 2}` to increase the scale of each sub-plot, resulting in each curve's vertical range overlapping 50% with its adjacent elements. Additionally, the y-axis wheel-zoom will apply to each curve's respective sub-coordinate y-axis, rather than the global coordinate frame. More information about this feature can be found in [HoloViews' documentation](https://holoviews.org/user_guide/Customizing_Plots.html#subcoordinate-y-axis)."
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "For demonstration purposes, we'll temporarily add a new column of 'sensors' that splits up the temperature data into several series."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "sensor = np.random.choice(['s1', 's2', 's3', 's4'], size=len(sst))\n",
+    "sst.assign(sensor=sensor).hvplot(by='sensor', subcoordinate_y=True)"
+   ]
+  },
   {
    "cell_type": "markdown",
    "metadata": {},

{hvplot-0.11.0a1 → hvplot-0.11.0a2}/envs/py3.10-tests.yaml

@@ -15,6 +15,7 @@ channels:
 dependencies:
   - python=3.10
   - bokeh>=3.1
+  - bokeh_sampledata
   - cartopy
   - colorcet>=2
   - dask
@@ -50,6 +51,7 @@ dependencies:
   - pooch
   - pooch>=1.6.0
   - pre-commit
+  - psutil
   - pygraphviz
   - pyproj
   - pytest
@@ -65,6 +67,7 @@ dependencies:
   - scipy>=1.5.3
   - selenium>=3.141.0
   - setuptools_scm>=6
+  - spatialpandas
   - spatialpandas>=0.4.3
   - sqlglot
   - streamz>=0.3.0

{hvplot-0.11.0a1 → hvplot-0.11.0a2}/envs/py3.11-docs.yaml

@@ -15,6 +15,7 @@ channels:
 dependencies:
   - python=3.11
   - bokeh>=3.1
+  - bokeh_sampledata
   - cartopy
   - colorcet>=2
   - dask>=2021.3.0

{hvplot-0.11.0a1 → hvplot-0.11.0a2}/envs/py3.11-tests.yaml

@@ -15,6 +15,7 @@ channels:
 dependencies:
   - python=3.11
   - bokeh>=3.1
+  - bokeh_sampledata
   - cartopy
   - colorcet>=2
   - dask
@@ -50,6 +51,7 @@ dependencies:
   - pooch
   - pooch>=1.6.0
   - pre-commit
+  - psutil
   - pygraphviz
   - pyproj
   - pytest
@@ -65,6 +67,7 @@ dependencies:
   - scipy>=1.5.3
   - selenium>=3.141.0
   - setuptools_scm>=6
+  - spatialpandas
   - spatialpandas>=0.4.3
   - sqlglot
   - streamz>=0.3.0

{hvplot-0.11.0a1 → hvplot-0.11.0a2}/envs/py3.12-tests.yaml

@@ -15,6 +15,7 @@ channels:
 dependencies:
   - python=3.12
   - bokeh>=3.1
+  - bokeh_sampledata
   - cartopy
   - colorcet>=2
   - dask
@@ -50,6 +51,7 @@ dependencies:
   - pooch
   - pooch>=1.6.0
   - pre-commit
+  - psutil
   - pygraphviz
   - pyproj
   - pytest
@@ -65,6 +67,7 @@ dependencies:
   - scipy>=1.5.3
   - selenium>=3.141.0
   - setuptools_scm>=6
+  - spatialpandas
   - spatialpandas>=0.4.3
   - sqlglot
   - streamz>=0.3.0