Current release: version 3.4.0, released 2025-04-28
Note: stated dates of releases correspond to the date a given version was tagged on GitHub. Up until 2024 some detail may be missing, with some numbered versions not listed on, or available from, from the GitHub repository, due to the history of being developed elsewhere.
- Modularise the codebase, which has no user-facing implications except
that functionality is available via sub-modules as well as at the top-level
e.g.
cfp.conis available also ascfp.contour.con,cfp.gopenis alsocfp.graphic.graphic.gopenetc. (#11) - Make the internal API obsolete - it is no longer exposed to the user (but similar functionality can be added upon request).
- Update the API reference to group and categorise all routines.
- Add missing space between variable name and units in colour bar titles (#115)
- Update any (documentation) examples which extract a
Fieldfrom aFieldlistof length greater than one to useselect_by_identityinstead of indexing, for clarity (#119)
- Move of codebase home from old repository location of
github.com/ajheaps/cf-plottogithub.com/NCAS-CMS/cf-plot- the former URL will redirect for the time being but cannot be guaranteed to do so in future - Move of home for documentation: now and going forward hosted permanently at
ncas-cms.github.io/cf-plot/with the previous documentation at root URLajheaps.github.io/cf-plot/frozen (no longer updated so do not consult) - Documentation overhaul including new responsive theme, hierarchical structuring, improved navigation, listing of all examples grouped by theme with reorganisation of gallery view, updates for informational pages, and more
- New feature:
trajmethod can now natively plot single trajectories (i.e. one-dimensional paths, having no trajectory dimension) encoded as discrete sampling geometries (#84) - Fix bug whereby
concontour plot withverbose=Truewould result in anUnboundLocalError(#54) - Fix bug whereby plots such as with
conusing the 'merc' Mercator projection would be cropped to small portion of the y axis (#65) - Fix bug whereby the colour bar would be mostly cutoff from the foot of
the figure for plots such as
concontour plots when using certain projections such as 'ortho', 'merc', and 'lcc' after a call to e.g.cfp.mapset(proj='ortho')(#70) - Fix bug whereby
concontour plot in the 'UKCP' projection would result in anIndexErrorforblockfill=True(#91) or otherwise anUnboundLocalError(#60) or anAttributeError(#59) dependent on other configuration - Fix bug whereby
conwould result in a blank plot for rotated pole data requested for display on its native grid through setting ofcfp.mapset(proj="rotated")(see #86) - Fix bug whereby values at the colour bar extremes in blockfill plots (
conwithblockfill=True) withblockfill_fast=Nonedefault would always be shown in white (see #98) - Fix bug whereby blockfill plots (
conwithblockfill=True) of UGRID data in either polar projection (proj="npstere"orproj="spstere") could display blacked out areas (see #99) - Make consistent the defaults for
feature_zorderandrotated_grid_thicknessplotting variables as configurable throughsetvars(#73) - Set new minimum version of dependency:
'cf-python >= 3.17.0' - Set new minimum version of dependency:
'cartopy >= 0.17.0' - Removed explicit (listed) dependency to
matplotlibsince this is required already by existing dependency Cartopy - Removed explicit (listed) dependency to
scipysince this is required already by existing dependency cf-python
- UGRID support added
- Rolling bug fix versions
- UGRID support
- Port to Python 3 and Mac OSX
- Trajectories
- Support for the UKCP grid
- Change from Basemap to Cartopy mapping
- Rolling set of small additions and bug fixes
- Code base changes
- Rolling update of features
- Graph plots
- Rolling update of features
- Rotated pole plots
- Bug/feature fix
- PDF user guide
- Bug/feature fix
- Hovmoller plots
- Error handling
- Data interface improvements
vectfor vector plotting
stipplefor significance plots
cscalefor colour scales
gopen,gclose,gposopening and closing of output files/plot positioning
- latitude-height plots
gset,axesfor setting plot limits and plotting axes
- Initial release (first version on GitHub).