|
| 1 | +Version 0.26 (September 16, 2026) |
| 2 | +================================= |
| 3 | + |
| 4 | +The documentation is now hosted on Read The Docs at the following URL: |
| 5 | +https://cartopy.readthedocs.io/stable/ |
| 6 | + |
| 7 | +This release also includes a fix for compatibility with PROJ 9.8, several |
| 8 | +robustness fixes for gridline labels and polygon transforms, and a more |
| 9 | +reliable download location for GSHHS coastline data. |
| 10 | + |
| 11 | +Minimum supported versions of dependencies |
| 12 | + |
| 13 | +* Python 3.11 |
| 14 | +* Matplotlib 3.8 |
| 15 | +* Numpy 1.26 |
| 16 | +* Pyproj 3.6 |
| 17 | + |
| 18 | + |
| 19 | +🎉 Features |
| 20 | +----------- |
| 21 | + |
| 22 | +* Ruth Comer added the ``autolim`` keyword to the `.add_geometries` and `.add_feature` |
| 23 | + methods so that axes extents can get automatically updated when adding new features |
| 24 | + to an axes. (:pull:`2569`) |
| 25 | + |
| 26 | +* Thomas Guymer added ThunderForest tiles as another image tile provider. (:pull:`2575`) |
| 27 | + |
| 28 | +* Thomas Guymer exposed the ``regrid_shape`` and ``interpolation`` keyword arguments on |
| 29 | + `.background_img`, so high-resolution background images are no longer forced to be |
| 30 | + downsampled to 750 pixels. (:pull:`2609`) |
| 31 | + |
| 32 | +* Do Ngoc Khanh exposed the ``gamma`` parameter of the Oblique Mercator projection. (:pull:`2627`, :pull:`2733`) |
| 33 | + |
| 34 | +* Greg Lucas vectorized the coordinate extraction in `.shapely_to_path`, |
| 35 | + giving a 50-100x speedup for geometries with many points. (:pull:`2693`) |
| 36 | + |
| 37 | +* Image tile downloaders now auto-detect whether each tile is RGB or RGBA from its |
| 38 | + image data instead of assuming a fixed format, thanks to Greg Lucas. (:pull:`2738`) |
| 39 | + |
| 40 | +* Elliott Sales de Andrade enabled building and testing free-threaded wheels and |
| 41 | + wheels for Python 3.15. (:pull:`2720`) |
| 42 | + |
| 43 | + |
| 44 | +🐛 Bug Fixes |
| 45 | +------------ |
| 46 | + |
| 47 | +* Greg Lucas fixed an issue with small anti-meridian crossing polygons during projection. (:pull:`2594`) |
| 48 | + |
| 49 | +* Thomas Guymer fixed an issue with potential cache name clashes based on different styles. (:pull:`2603`) |
| 50 | + |
| 51 | +* Raphael Quast fixed a bug with polygons that had no paths to return an empty path |
| 52 | + rather than raising an error. (:pull:`2619`) |
| 53 | + |
| 54 | +* Greg Lucas fixed an issue when projecting a geometry with an empty point. (:pull:`2640`) |
| 55 | + |
| 56 | +* Elliott Sales de Andrade fixed hard-coded limits and thresholds that produced |
| 57 | + incorrect projections when a projection's Globe had a non-default radius. (:pull:`1607`) |
| 58 | + |
| 59 | +* Guillermo N. Leiro Arroyo fixed gridline labels on curved projection boundaries (e.g. |
| 60 | + Robinson) ignoring `.right_labels`/`.left_labels` visibility settings. (:pull:`2649`) |
| 61 | + |
| 62 | +* Guillermo N. Leiro Arroyo fixed shared `.GeoAxes` (via ``sharex``/``sharey``) not propagating |
| 63 | + interactive zoom to sibling subplots after features were added. (:pull:`2652`) |
| 64 | + |
| 65 | +* Ryan May fixed compatibility with PROJ 9.8, which changed how the equidistant |
| 66 | + cylindrical projection handles ellipsoids and broke the assumptions `.PlateCarree` |
| 67 | + relied on. (:pull:`2653`) |
| 68 | + |
| 69 | +* Greg Lucas replaced the ring orientation check with a more robust shoelace-formula |
| 70 | + calculation that handles self-intersecting rings correctly. (:pull:`2665`) |
| 71 | + |
| 72 | +* Ruth Comer fixed the gridliner title adjustment logic incorrectly accounting for |
| 73 | + invisible labels. (:pull:`2667`) |
| 74 | + |
| 75 | +* Guillermo N. Leiro Arroyo fixed gridline labels being hidden by false-positive overlap |
| 76 | + detection at a rotation of 90 degrees. (:pull:`2668`) |
| 77 | + |
| 78 | +* Greg Lucas fixed a memory leak where the wrapped collection of a ``GeoQuadMesh`` was not |
| 79 | + removed along with the mesh itself. (:pull:`2676`) |
| 80 | + |
| 81 | +* Katelyn FitzGerald updated `.LatitudeLocator` to follow an upstream Matplotlib change |
| 82 | + that made `matplotlib.ticker.MaxNLocator` keywords explicit. (:pull:`2690`) |
| 83 | + |
| 84 | +* Greg Lucas fixed `.path_to_shapely` misclassifying closed triangle paths as line |
| 85 | + strings instead of polygons. (:pull:`2692`) |
| 86 | + |
| 87 | +* Ruth Comer skipped title positioning calculations entirely when an axes has no |
| 88 | + titles set. (:pull:`2702`) |
| 89 | + |
| 90 | +* David Vadnais fixed deepcopy/pickling of CRS subclasses created from WKT. (:pull:`2727`) |
| 91 | + |
| 92 | +* Ruth Comer fixed transforms of filled paths by using the shoelace formula to |
| 93 | + determine input polygon orientation. (:pull:`2741`) |
| 94 | + |
| 95 | +* Greg Lucas fixed boundary clipping on non-data transform axes. (:pull:`2734`) |
| 96 | + |
| 97 | + |
| 98 | +📚 Documentation |
| 99 | +---------------- |
| 100 | + |
| 101 | +* Sadie L. Bartholomew added an example map from The Simpson's. (:pull:`2583`) |
| 102 | + |
| 103 | +* Moritz Schreiber added a copy button to the examples. (:pull:`2592`) |
| 104 | + |
| 105 | +* Ruth Comer switched our documentation hosting to ReadTheDocs. (:pull:`2558`) |
| 106 | + |
| 107 | +* David Vadnais corrected inaccurate documentation for `.PlateCarree`. (:pull:`2726`) |
| 108 | + |
| 109 | +* David Vadnais updated the docstring for `.NearsidePerspective`. (:pull:`2730`) |
| 110 | + |
| 111 | +* Greg Lucas fixed the effects_of_the_ellipse example so it demonstrates a genuine |
| 112 | + ellipse mismatch. (:pull:`2736`) |
| 113 | + |
| 114 | + |
| 115 | +🛠️ Maintenance |
| 116 | +-------------- |
| 117 | + |
| 118 | +* Clément Robert enabled Python 3.14 wheels. (:pull:`2556`) |
| 119 | + |
| 120 | +* Clément Robert added Windows32 and musllinux wheels. (:pull:`2581`) |
| 121 | + |
| 122 | +* Will Hart disabled Cython profiling/line tracing by default behind the existing |
| 123 | + ``CYTHON_COVERAGE`` flag, since it was breaking the VS Code Python debugger. (:pull:`2613`) |
| 124 | + |
| 125 | +* Ruth Comer bumped the minimum required versions of dependencies. (:pull:`2623`) |
| 126 | + |
| 127 | +* Elliott Sales de Andrade fixed the CI installation of dependencies. (:pull:`2626`) |
| 128 | + |
| 129 | +* Josh Cunningham added ARM manylinux wheels to the release process. (:pull:`2628`) |
| 130 | + |
| 131 | +* Ryan May added CI upload of conda image test failures as an artifact. (:pull:`2636`) |
| 132 | + |
| 133 | +* Greg Lucas upgraded deprecated ruff pre-commit configurations. (:pull:`2638`) |
| 134 | + |
| 135 | +* Greg Lucas updated the test suite's check for pykdtree/scipy availability. (:pull:`2639`) |
| 136 | + |
| 137 | +* Greg Lucas moved GSHHS coastline data downloads to a more reliable location, and |
| 138 | + later to a GitHub mirror. (:pull:`2659`, :pull:`2664`) |
| 139 | + |
| 140 | +* Greg Lucas filtered expected warnings out of the test suite. (:pull:`2660`) |
| 141 | + |
| 142 | +* Ruth Comer stopped accessing the private ``Formatter.locs`` attribute. (:pull:`2672`) |
| 143 | + |
| 144 | +* Elliott Sales de Andrade removed ``wheel`` from the build requirements. (:pull:`2683`) |
| 145 | + |
| 146 | +* Elliott Sales de Andrade removed checks for old, no-longer-supported Shapely |
| 147 | + versions. (:pull:`2684`) |
| 148 | + |
| 149 | +* Elliott Sales de Andrade updated test figures for Matplotlib 3.11. (:pull:`2685`) |
| 150 | + |
| 151 | +* Elliott Sales de Andrade fixed deprecation warnings raised with NumPy 2.5.0. (:pull:`2686`) |
| 152 | + |
| 153 | +* Ruth Comer explicitly added pip to the conda test environment. (:pull:`2687`) |
| 154 | + |
| 155 | +* Elliott Sales de Andrade dropped use of internal backwards-compatibility |
| 156 | + modules. (:pull:`2698`) |
| 157 | + |
| 158 | +* Elliott Sales de Andrade dropped unnecessary explicit baseline image names from the |
| 159 | + test suite. (:pull:`2699`) |
| 160 | + |
| 161 | +* Elliott Sales de Andrade updated linting to use prek, yamllint, and zizmor. (:pull:`2700`) |
| 162 | + |
| 163 | +* Elliott Sales de Andrade enabled ruff's preview rule set. (:pull:`2701`) |
| 164 | + |
| 165 | +* Elliott Sales de Andrade set the default shell to bash in all CI jobs. (:pull:`2717`) |
| 166 | + |
| 167 | +* Elliott Sales de Andrade disabled pickling for the internal `.LineAccumulator`. (:pull:`2723`) |
| 168 | + |
| 169 | +* Greg Lucas updated the license header check to recognise files in a git |
| 170 | + worktree. (:pull:`2732`) |
| 171 | + |
| 172 | + |
| 173 | +🚫 Deprecations and Removals |
| 174 | +---------------------------- |
| 175 | + |
| 176 | +* ``LONGITUDE_FORMATTER`` and ``LATITUDE_FORMATTER`` are deprecated. |
| 177 | + Use `.LongitudeFormatter` and `.LatitudeFormatter` instead. (:pull:`2744`) |
0 commit comments