Changelog#

v1.2.0 (2023-11-03)#

ContourPy 1.2.0 is a significant release with a number of new features. There is a new format for contour lines called LineType.ChunkCombinedNan that is designed to work directly with Bokeh and HoloViews. There are also new functions for manipulating contour lines and filled contours (convert_filled, convert_lines, dechunk_filled and dechunk_lines).

Calling ContourGenerator.filled() with two identical levels now raises a ValueError whereas previously it gave different results depending on algorithm name.

This release supports Python 3.9 to 3.12, and is the first release to ship musllinux aarch64 wheels.

Enhancements:

  • Support strings as well as enums in renderer functions (#284)

  • Add new functions dechunk_filled and dechunk_lines (#290)

  • Add new functions convert_filled and convert_lines (#291, #293, #294, #312, #313)

  • Add new LineType.ChunkCombinedNan (#296, #301, #308)

  • Raise if call filled() with lower_level==upper_level (#317)

Code improvements:

  • Code quality improvements (#282, #310)

  • Improvements to array checking functions (#298)

  • Better use of dtypes and casting when calling numpy functions (#300, #306, #308, #314)

  • Update type annotations for matplotlib 3.8 (#303)

  • Extra validation when dechunking and converting contour lines and filled contours (#316)

Documentation improvements:

  • Use versionadded sphinx directive (#285)

  • Remove threaded experimental warnings (#297)

  • Extract benchmark ratios when generating benchmark plots (#302)

  • Document new functions and conversion to Shapely geometries (#318)

Build, testing and CI improvements:

  • Add new CI run using NumPy nightly wheels (#280)

  • Test contour levels that are +/-np.inf (#283)

  • Improved PyPy CI (#287, #307)

  • Use better names for enums when reporting parameterised tests (#292)

  • Improved mpl debug renderer tests (#295)

  • Support musllinux aarch64 (#305)

  • Run test suite in parallel (#311)

  • Miscellaneous build and CI improvements (#279, #281, #288, #315, #319)

v1.1.1 (2023-09-16)#

This release adds support for CPython 3.12 and reinstates the release of Windows 32-bit wheels following NumPy’s intention to continue doing so. There is a new keyword argument webdriver to the BokehRenderer save functions to reuse the same Selenium WebDriver instance across multiple calls.

This release supports Python 3.8 to 3.12.

Thanks to new contributor @shadchin and existing contributors @eli-schwartz and @ianthomas23.

Enhancements:

  • Add webdriver kwarg to Bokeh export functions (#261)

  • Add --driver-path pytest option to specify chrome driver path (#264)

Code improvements:

  • Sync constant name with C++ code (#258)

  • Improved validation in internal chunk functions (#266)

Documentation improvements:

  • Exclude prompts when using sphinx copybutton (#269)

Build system and CI improvements:

  • Support CPython 3.12 (#254, #272)

  • Reinstate Windows 32-bit testing and wheels (#274, #275)

  • Update build and CI dependencies (#256, #257, #259)

  • Don’t require ninja to come from PyPI (#260)

  • Re-enable bokeh tests in CI (#263)

  • Add tests for saving to PNG and SVG using Matplotlib and Bokeh renderers (#267)

  • Pin numpy to less than 2.0 (#268)

  • Remove ninja build requirements (#270)

v1.1.0 (2023-06-13)#

This release features a change in the build system from distutils, which is scheduled for removal in Python 3.12, to meson and meson-python. It includes the building of wheels for ppc64le and s390x (on x86_64 only) and removes building of all 32-bit wheels and macOS universal2 wheels.

Note

Windows 32-bit wheels were retroactively released for v1.1.0 on 2023-09-15 following NumPy’s decision to keep releasing Win32 wheels.

This release supports Python 3.8 to 3.11.

Thanks to new contributor @eli-schwartz.

Build system improvements:

  • New meson build system (#183, #226, #232, #249, #250)

  • Drop building universal2 wheels (#225)

  • Add build_config to store and show build configuration info (#227)

  • Build ppc64le and s390x wheels (#246)

Code improvements:

  • Rearrange functions alphabetically (#219)

  • Remove unused mpl2005 and mpl2014 code (#234, #237)

  • Improve mpl2014 chunk count error handling (#238)

Documentation improvements:

  • Improve API docs (#220, #221, #222)

  • Update benchmarks (#233)

  • Add meson-specific build docs (#245)

  • Add simpler README for PyPI (#247)

CI improvements:

  • Replace flake8 with ruff (#211)

  • Building and testing on cirrus CI (#213)

  • Run mypy in CI (#230)

  • Set up code coverage in CI (#235, #236, #183)

  • New internal API, codebase and debug renderer tests (#239, #241, #244)

  • Use correct version of chromium for Bokeh image tests (#243)

  • Add tests for musllinux (on x86_64), ppc64le and s390x (#246)

v1.0.7 (2023-01-13)#

This release adds type annotations and moves project metadata to pyproject.toml (PEP 621). Documentation now uses the Sphinx Furo theme, supporting dark and light modes. There are no functional changes.

Type annotations:

Documentation improvements:

  • Support dark mode (#185, #188)

  • Use sphinx copy button (#189)

  • Add conda monthly download badges to README (#192)

  • Furo sphinx theme (#195)

Code improvements:

  • Improved if statement (#186)

  • Test nonfinite z and decreasing zlevel for filled (#190)

  • Add abstract base class Renderer (#198)

  • Replace mpl scatter call with plot instead (#203)

  • Use absolute imports (#204)

  • Minor improvement to get_boundary_start_point (#205)

Build system and CI improvements:

v1.0.6 (2022-10-30)#

This release features major improvements to the robustness of the threaded algorithm on both CPython and PyPy.

Thanks to new contributors @mgorny and @Zac-HD.

Threaded algorithm improvements:

  • Correctly acquire and release GIL in multithreaded code (#172)

  • Update benchmarks in line with recent changes (#174)

CI improvements:

  • Add PyPy 3.9 to CI (#173)

  • Use numpy debug build in debug CI run (#175)

v1.0.5 (2022-09-02)#

This release includes performance improvements for threaded and serial chunked algorithms, and is the first release to support CPython 3.11.

Performance improvements:

  • Shorter threaded lock (#154)

  • Init cache by chunk if more than 1 chunk (#155)

  • Update benchmark documentation and plots (#156)

CPython 3.11 support:

  • Add python 3.11 release candidate to CI (#151)

  • Build CPython 3.11 wheels (#152)

v1.0.4 (2022-07-31)#

This release puts all C++ code within a namespace to avoid symbol conflicts such as on IBM AIX.

  • Add namespace (#144)

  • Allow install of test dependencies without codebase deps (#147)

v1.0.3 (2022-06-12)#

  • Remove unnecessary code duplication (#130)

  • ContourGenerator base class (#131)

  • Mark tests that need mpl (#133)

  • Fix for PyPy np.resize bug (#135)

  • Initialise mpl backend when first needed (#137)

  • Add isort to pytest (#138)

v1.0.2 (2022-04-08)#

  • Add tests that do not write text to images (#124)

v1.0.1 (2022-03-02)#

  • Add docs and tests to sdist (#119)

  • Relax numpy version requirement (#120)

v1.0.0 (2022-02-19)#

Finalised API for version 1.0 release.

  • Synonym functions for backward compatibility with Matplotlib (#111)

  • Add benchmarks to docs (#112)

  • Updated readmes, added security policy and code of conduct (#113)

  • Improved name to class mapping (#114)

  • Convert np.nan/np.inf in z to masked array (#115)

v0.0.5 (2022-02-13)#

  • All ContourGenerator classes implement the same readonly properties (#91)

  • Support string to enum conversion in contour_generator (#92)

  • Default line/fill type for serial/threaded (#96)

  • Check for negative z if using log interp (#97)

  • contour_generator args vs kwargs (#99)

  • String to enum moved from C++ to python (#100)

  • Don’t store mask in mpl2005 (#101)

  • Sphinx documentation (#102)

  • Fixed missing SW corner mask starts (#105)

  • Finalise enum spellings (#106)

  • Complete mask render function (#107)

  • Test filled compare slow (#108)

v0.0.4 (2021-11-07)#

  • Build on Python 3.10 (#76)

v0.0.3 (2021-10-01)#

  • Improvements to build on older MSVC (#85)

v0.0.2 (2021-09-30)#

  • Include license file in sdist (#81)

v0.0.1 (2021-09-20)#

  • Initial release.