Add new .odc.explore() method for automatically plotting raster data on an interactive map

[robbibt]

This PR addresses #104 by adding a new .explore() method for automatically plotting raster data into an interactive map. This is designed to replicate the extremely useful .explore() method from Geopandas: https://geopandas.org/en/stable/docs/reference/api/geopandas.GeoDataFrame.explore.html

Essentially explore combines to_rgba and add_to from this repo into a single easy to use method.

Supports single band xr.DataArray inputs:

Automatically converts xr.Dataset inputs to RGB:

And easily passing in custom mapping params like basemaps:

[codecov]

Codecov Report

Attention: 2 lines in your changes are missing coverage. Please review.

Comparison is base (a9fbfc5) 97.91% compared to head (3bd9b9e) 97.88%.

Files	Patch %	Lines
odc/geo/_compress.py	85.71%	1 Missing ⚠️
odc/geo/_map.py	95.45%	1 Missing ⚠️

Additional details and impacted files

@@             Coverage Diff             @@
##           develop     #116      +/-   ##
===========================================
- Coverage    97.91%   97.88%   -0.04%     
===========================================
  Files           25       25              
  Lines         4315     4346      +31     
===========================================
+ Hits          4225     4254      +29     
- Misses          90       92       +2     

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

[github-actions]

🚀 Deployed on https://65b07f250ac7882d88ff8cd6--odc-geo-docs.netlify.app

[robbibt]

@Kirill888 Have made the following changes:

• Simplified .explore() by using existing reprojection functionality in .add_to()
• Added _verify_can_compress to catch unsuitable dims prior to Dask load in compress
• Removed error catching from _compress_image now those errors are caught upstream
• Added a new resample param to add_to() to control reprojection resampling method
• Added a more user friendly ModuleNotFoundError if Folium isn't installed
• Improved error messages for auto-band name guessing inside to_rgba()
• Minor error message wording and documentation improvements

[Kirill888]

@robbibt thanks, this is great. Let's put back those data shape checks into ._compress and it's good to merge after that.

[robbibt]

@robbibt thanks, this is great. Let's put back those data shape checks into ._compress and it's good to merge after that.

Awesome, thanks for the great feedback. Have made that change, can rebase merge once you approve.

What's the plan for the next odc-geo version release? I'd like to get mask, crop and explore into the DEA Sandbox and it would be much easier with a proper release.

[Kirill888]

thanks, good to merge