Migrate multispectral user guide off datashader

Open
#3,458 0 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

Assessment

Difficulty
3/5
Estimated time
1-2 days
Newbie friendliness
72/100
Issue type
Refactor
Clarity
Mostly clear
Activity status
Quiet
Tech stack
matplotlib, numpy, python
Domain
data-visualization, documentation

Research direction

Start with docs/source/user_guide/multispectral.ipynb and inspect the cells that import datashader, call Canvas().raster(), and use transfer functions or Images. Replace those workflow pieces with the proposed Python plotting and resampling approach, update the prose, then re-execute the notebook. Done means it runs top to bottom without a datashader import and regenerates the expected plots and preview image.

Written by the indexing model from the issue text.

Description

area:spectral documentation user-guide-example

Reason or Problem

docs/source/user_guide/multispectral.ipynb imports datashader, uses Canvas().raster() to resample bands, and renders with the transfer functions and the Images helper.

Canvas().raster() is raster resampling, not vector rasterization, so arr.xrs.rasterize does not replace it directly.

Proposal

  • Remove the datashader imports.
  • Replace the Canvas().raster() resampling step with a plain xarray/numpy resample, or drop it if it was only cosmetic.
  • Replace the transfer functions, Images, and datashader colormaps with matplotlib.
  • Update the prose cells that describe the datashader workflow.
  • Re-execute the notebook so outputs and the preview image regenerate cleanly.

Done when

  • The notebook runs top to bottom with no datashader import and produces the expected plots.

Part of removing datashader as a dependency; final packaging removal is tracked in #3450.

Dominant language
Python
Stars
972
Forks
92
Avg merge
2d 12h
Merged PRs (30d)
7

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

More from xarray-contrib/xarray-spatial

All issues in xarray-contrib/xarray-spatial

Similar issues

More Python issues

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.