|
| 1 | +Version 0.23 (April 10, 2024) |
| 2 | +============================= |
| 3 | + |
| 4 | +Cartopy has been relicensed from LGPL-3 to BSD-3-Clause. All contributions |
| 5 | +to Cartopy are now under the BSD-3-Clause license. |
| 6 | + |
| 7 | +Python 3.12 and Numpy 2 are now supported and the new minimum supported versions |
| 8 | +of dependencies that have been updated are: |
| 9 | + |
| 10 | +* Matplotlib v3.5 |
| 11 | +* Pyshp v2.3 |
| 12 | + |
| 13 | +There are several updates to the geometry and feature handling, |
| 14 | +making these more compatible with the Matplotlib semantics. |
| 15 | + |
| 16 | +Features |
| 17 | +-------- |
| 18 | + |
| 19 | +* Xianxiang Li added the ability to modify the properties of the stock images (:pull:`2230`) |
| 20 | + |
| 21 | +* @lgolston updated the shapefile readers and added documentation. (:pull:`2236`) |
| 22 | + |
| 23 | +* Ruth Comer turned the ``GridLiner`` into a Matplotlib ``Artist`` making it easier to |
| 24 | + add and remove gridlines and fewer internal draws for better performance. (:pull:`2249`, :pull:`2252`) |
| 25 | + |
| 26 | +* The cartopy feature download script (useful for downloading Natural Earth Features |
| 27 | + for offline use) can be invoked within the package directly |
| 28 | + using :code:`python -m cartopy.feature.download`, or through the installed command |
| 29 | + line interface using :code:`cartopy-feature-download`. (:pull:`2263`) |
| 30 | + |
| 31 | +* The Stamen Maps API is no longer available. There is a new class ``StadiaMaps`` |
| 32 | + that can be used to access the Stadia Maps API which contains the |
| 33 | + Stamen styled tiles. (:pull:`2269`) |
| 34 | + |
| 35 | +* Greg Lucas made it easier to handle projections on non-earth bodies that |
| 36 | + would error previously. (:pull:`2283`) |
| 37 | + |
| 38 | +* Kevin Dungs added the ability to use Levels 5 and 6 in GSHHS features |
| 39 | + for Antarctica. (:pull:`2317`) |
| 40 | + |
| 41 | +* Ruth Comer changed a single geometry that is split into two across a boundary |
| 42 | + to be drawn as a compound path rather than two independent paths. This makes |
| 43 | + it easier to style the geometry consistently. (:pull:`2325`) |
| 44 | + |
| 45 | +* Ruth Comer has converted the ``FeatureArtist`` into a Matplotlib ``Collection``. |
| 46 | + This makes it easier to set properties on the features and enables arrays to |
| 47 | + be used to style a set of features. (:pull:`2323`) |
| 48 | + A new example demonstrating this has been added to the gallery |
| 49 | + :ref:`sphx_glr_gallery_scalar_data_geometry_data.py` |
| 50 | + |
| 51 | +Deprecations and Removals |
| 52 | +------------------------- |
| 53 | + |
| 54 | +* The ``cartopy.mpl.style`` module has been deprecated with no replacement |
| 55 | + and will be removed in a future release. Users should combine and merge styles |
| 56 | + themselves now. |
| 57 | +* The **auto_update** keyword argument to ``gridlines`` and ``GridLiner`` is |
| 58 | + deprecated and will be removed in a future release. In the future the gridlines |
| 59 | + will always be updated when the plot is drawn. |
| 60 | +* The gridliner labelling options |
| 61 | + ``cartopy.mpl.gridliner.Gridliner.xlabels_top``, |
| 62 | + ``cartopy.mpl.gridliner.Gridliner.xlabels_bottom``, |
| 63 | + ``cartopy.mpl.gridliner.Gridliner.ylabels_left``, and |
| 64 | + ``cartopy.mpl.gridliner.Gridliner.ylabels_right`` have been removed. |
| 65 | + Instead, use :attr:`cartopy.mpl.gridliner.Gridliner.top_labels`, |
| 66 | + :attr:`cartopy.mpl.gridliner.Gridliner.bottom_labels`, |
| 67 | + :attr:`cartopy.mpl.gridliner.Gridliner.left_labels`, or |
| 68 | + :attr:`cartopy.mpl.gridliner.Gridliner.right_labels`. |
0 commit comments