raphaelquast/EOmaps: EOmaps v4.0

A new major release that brings some nice new features, a lot of updates and some outstanding api-changes.

🌩 changes

    ❗ There are breaking changes to EOmaps v3.x ❗

    🌞 For a quick-guide on how to port existing scripts to v4.x see: ⚙️ port script from v3.x to v4.x

🌳 NEW

• ⭐ The Sentinel-2 cloudless WebMap service can now be used via m.add_wms.s2_cloudless

• 🌟 It is now possible to set "coordinate-only" datasets!

  • This is particularly useful if you want to manually assign colors

    m.set_data(None, [1,2,3], [1,2,3])
    m.plot_map(fc=["r", "g", "b"])
    

    ### 🚀 there's a new plot shape! m.set_shape.raster A fast way to plot 2D datasets. <details><summary>[click to show] 🔸 details </summary>

• it's quite similar to plt.imshow (e.g. a QuadMesh is used to speed up plotting of 2D datasets)

• the differences to shade_raster are:
  • the whole dataset is always plotted (so for very very large datasets shade_raster is much faster!)
  • it supports manual color specifications (shade_raster does not)
• the differences between rectangles and raster are:
  • raster does not take the curvature of the edges into account
  • raster determines the pixel-size based on neighboring pixels, rectangles allows arbitrary pixel-dimensions

🌈 there have been some major improvements for manual color specifications!

    Checkout the 🌎 Customizing the plot section of the docs for details!

    Colors can now be set manually with all shapes (except shade shapes) using m.plot_map(fc=[...]) (or facecolor= or color=)!

☁️ minor (non-breaking) changes

• the default radius_crs for the mark callback is now determined based on the radius_crs assigned in the plot-shape ... this definition allows using m.cb.pick.attach.mark(buffer=3) directly without having to worry about the crs (previously in, e.g. the input-crs was used by default)
• the background patch of the compass is now by default set to None

🔨 fixes

• fix issues with manual color specifications for various plot-shapes (e.g. when providing explicit color-arrays via m.plot_map(color=[...]) )
• fix issues with shapes close to crs-bounds
• support estimation of different x- and y- radius for 2D datasets
• warn if datapoints are masked or if datapoints are outside the CRS-bounds
• cache shape transformers (so they are not re-initialized all the time)