ContourPy is a Python library for calculating contours of 2D quadrilateral grids. It is written in C++11 and wrapped using pybind11.
It contains the 2005 and 2014 algorithms used in Matplotlib as well as a newer algorithm that includes more features and is available in both serial and multithreaded versions. It provides an easy way for Python libraries to use contouring algorithms without having to include Matplotlib as a dependency.
Advantages of the new algorithm compared to Matplotlib's default algorithm of 2014 - 2022:
- Improved performance in many situations (see
benchmarks
). - Multiple return types for both contour lines and filled contours, with different complexity and performance tradeoffs (see
line_type
andfill_type
). - Multiple ways to specify chunk sizes and/or counts (see
chunks
). - Supports treating quads a four triangles for more detailed contours (see
quad_as_tri
). - Supports alternative forms of interpolation of z-values (currently only logarithmic) (see
z_interp
). - Multithreaded option (this should be considered experimental) (see
threads
).
installation usage quickstart user_guide/index
api/index changelog
benchmarks/index description config