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