Eomaps

... just a minor bugfix release

This release represents a complete re-work compared to EOmaps v1.x.x !

🌼 A documentation is now available on readthedocs! [>>> check it out here](https://eomaps.readthedocs.io/)

🌳 new

🌴 WMS and WMTS capabilities
- ❗ requires optional dependency `owslib`
- WMTS (or WMS) layers can be added via:
- `m.add_wmts.<COLELCTION>.add_layer.<LAYER>(**kwargs)`
- `m.add_wmts.<COLELCTION>[<LAYER>](**kwargs)`
- pre-defined layers include interfaces to
- ESA Copernicus & WorldCover layers
- Sentinel-1 Global Backscatter Model
- EEA Discomap layers
- NASA GIBS
- Austrian basemaps (basemap.at & Vienna)
- ... and more!

🌵 re-arrange plot-axes via drag & drop
- press `alt` + `d` to activate / deactivate "axis-arrangement" mode
- use the mouse to select the axis you want to change
- use "left/right/up/down" or the mouse to move the selected layer
- use "alt+left/right/up/down" to move the layer quicker
- use "ctrl+up/down" to show/hide colorbars & histograms

🌲 share callback-events between multiple Maps objects
- e.g.: click on one map to trigger a callback on multiple connected maps!
- to connect maps-objects, provide a "parent"-object on initialization `m = Maps(parent=m0)`
- forward callback-triggers from one Maps object to others via:
`m.cb.click.forward_events(m1, m2, m3)`
- ... or join the callback-events "both-ways" via
`m.cb.click.share_events(m1, m2, m3)`

🌱... and some more:
- there's a new `MapsGrid` object to quickly initialize a grid of Maps-objects
`m1, m2, m3, m4 = MapsGrid(2, 2)`
- join zoom-limits between multiple axes (with the same crs)
`m.join_limits(m1, m2, m3)`

🦠changes
- `f`, `gs_ax` and `orientation` are now set on initialization of the Maps-object!
(they are no longer arguments of `m.plot_map()`)

- callbacks are now accessed differently
- instead of `m.cb.attach()` and `m.cb_click.attach` there's now
- `m.cb.click` : trigger callbacks when clicking anywhere on the map
- `m.cb.pick` : trigger callbacks when clicking on a point of the plotted dataset
- `m.cb.keypress` : trigger callbacks when pressing a key
- `m.cb.dynamic` : trigger callbacks on events (e.g. zoom)

🔨 fixes
- make sure shapes are properly copied on `m.copy()`
- make sure `geod_circles` only takes numbers as radius
- sharing callbacks now works across coordinate-systems!
- multiple temporary markers & annotations are now supported

🌳 New
- ⭐ The colorbar can now be used as a **dynamic shade indicator** with `m.add_colorbar(dynamic_shade_indicator=True)`
- it is dynamically updated based on the distribution of shaded pixels in the current field of view.
(only possible with `m.set_shape.shade_raster()` or `m.set_shape.shade_points()` )

<img src=https://user-images.githubusercontent.com/22773387/163251944-740c3e6a-a083-4749-a27c-f70be04742a0.gif width=75%/>
- ⭐ There is now a way to use `pick` callbacks on datasets **without plotting the data first**.
- To make a *"pick-only"* dataset, use `m.set_data(...)` to assign the dataset and then
call `m.make_dataset_pickable()` to initialize all required information to make the dataset pickable.
- This is useful if you want to indicate certain informations "on click" without plotting the data

⚙️ changes
- The default plot-shape is now determined based on the size of the assigned dataset.
- <500k datapoints: `m.set_shape.ellipses()`
- \>500k datapoints: `m.set_shape.shade_raster()`
- `Maps.from_file` and `m.new_layer_from_file` now no longer attempt multiple shapes for plotting in case the first attempt fails
(the default shape is used if no explicit shape-name is provided)

🔨 fixes
- Fix typo in `m.add_colorbar`
- Fix some typos in the docs
- Fix unnecessary dtype conversions in "shade_raster" and "shade_points"
- Avoid dtype conversions when reading NetCDFs and GeoTIFFs

🌳 new
- `m.set_shape.rectangles(radius, radius_crs, n)` now supports an additional `n` keyword to calculate intermediate points on the edges
(e.g. useful to draw "curved" projected rectangles)
🛸 fixes
- allow setting `n` also in the mark-callback

a minor bugfix release

🌳 new
- a new method `m.indicate_masked_points()` is added to indicate points that have been masked

🛸 fixes
- fix repr-string of the callback-container
- fix adding markers if "geod_circles" have been plotted
- avoid transforming "out-of-bounds" for rectangles
- don't create markers with radius="pixel" if the shape does not set a radius

🌍 checkout the [README](https://github.com/raphaelquast/EOmaps#readme), the [example-notebook](https://github.com/raphaelquast/maps/blob/master/examples/EOmaps_examples.ipynb) and the `docstrings` for usage-details!

- major updates and breaking changes compared to EOmaps v0.x.x

🌍 checkout the [README](https://github.com/raphaelquast/EOmaps#readme), the [example-notebook](https://github.com/raphaelquast/maps/blob/master/examples/EOmaps_examples.ipynb) or the `docstrings` for usage-details!