NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
PyPI
PyPI, #726 most downloaded on PyPI
Python interface to PROJ (cartographic projections and coordinate transformations library)
Latest stable
3.8.0
Last release 2 months ago
05 Sep 2026
Ships fairly regularly
a new release about every 5 months
Nearly every release is documented
notes for 52 of 54 stable releases
Nothing withdrawn
no release was ever pulled
20 years old
70 releases · first in 2006
Drag across the ruler to compare, or tap a release to open it.
DEP: Minimum supported Python version 3.12 by @snowman2 in #1629
MANIFEST.in by @neutrinoceros in #1576Geod.npts method and some crs dict typings by @jack-volantautonomy in #1594Full Changelog: 3.7.2...3.8.0
Your coding agent can read these notes before it upgrades. Set up the MCP server →
MANIFEST.in by @neutrinoceros in https://github.com/pyproj4/pyproj/pull/1576Geod.npts method and some crs dict typings by @jack-volantautonomy in https://github.com/pyproj4/pyproj/pull/1594Full Changelog: https://github.com/pyproj4/pyproj/compare/3.7.2...3.8.0
Nothing published for this version
Bump pypa/cibuildwheel from 2.22 to 2.23 by @dependabot [bot] in #1479
Full Changelog: 3.7.1...3.7.2
Full Changelog: https://github.com/pyproj4/pyproj/compare/3.7.1...3.7.2
Nothing published for this version
Nothing published for this version
WHL: Wheels contain PROJ 9.5.1 by @snowman2 in #1477
Full Changelog: 3.7.0...3.7.1
Full Changelog: https://github.com/pyproj4/pyproj/compare/3.7.0...3.7.1
Nothing published for this version
ENH: Add is_deprecated and get_non_deprecated() to CRS by @jjimenezshaw in #1383
Dependencies:
Enhancements:
Bug fixes:
Maintenance:
Full Changelog: 3.6.1...3.7.0
Dependencies:
Enhancements:
Bug fixes:
Maintenance:
Full Changelog: https://github.com/pyproj4/pyproj/compare/3.6.1...3.7.0
Nothing published for this version
WHL: Update to PROJ 9.3 by @snowman2 in #1334
Full Changelog: 3.6.0...3.6.1
Full Changelog: https://github.com/pyproj4/pyproj/compare/3.6.0...3.6.1
Nothing published for this version
WHL: Wheels contain PROJ 9.2.1 by @snowman2 in #1291
allow_superseded kwargs to TransformerGroup by @dmahr1 in #1269Full Changelog: 3.5.0...3.6.0
allow_superseded kwargs to TransformerGroup by @dmahr1 in https://github.com/pyproj4/pyproj/pull/1269Full Changelog: https://github.com/pyproj4/pyproj/compare/3.5.0...3.6.0
Nothing published for this version
WHL: PROJ 9.2 in wheels in https://github.com/pyproj4/pyproj/pull/1243
Full Changelog: https://github.com/pyproj4/pyproj/compare/3.4.1...3.5.0
Nothing published for this version
WHL: Add win32 to build_wheels matrix by @molinav in https://github.com/pyproj4/pyproj/pull/1169
Full Changelog: https://github.com/pyproj4/pyproj/compare/3.4.0...3.4.1
Nothing published for this version
CLN: Remove deprecated 'skip_equivalent' kwarg from transformers and 'errcheck' kwarg from CRS.from_cf by @snowman2 in https://github.com/pyproj4/pypr…
Full Changelog: https://github.com/pyproj4/pyproj/compare/3.3.1...3.4.0
Nothing published for this version
Nothing published for this version
DOC: minor fix to crs doc-strings by @bjlittle in https://github.com/pyproj4/pyproj/pull/1004
Full Changelog: https://github.com/pyproj4/pyproj/compare/3.3.0...3.3.1
DEP: Minimum supported Python version 3.8 (issue #930)
pyproj.transformer.Transformer.transform_bounds (pull #961)pyproj.transformer.Transformer.transform_bounds (pull #962)pyproj.transformer.Transformer.source_crs & pyproj.transformer.Transformer.target_crs (pull #976)pyproj.crs.coordinate_operation.PoleRotationNetCDFCFConversion (issue #948)pyproj.database.get_database_metadata (issue #990)pyproj.show_versions (issue #990)A total of 3 people contributed patches to this release. People with a "+" by their names contributed a patch for the first time.
Other contributions:
REF: declare specific python types in cython (pull #928)
pyproj.crs.CRS.list_authority (pull #943)Thanks to everyone who contributed to this release as well as to those who help with the distribution!
REF: Handle deprecation of proj_context_set_autoclose_database (issue #866)
# Changes - WHL: Wheels contain PROJ 8.1.1 - DOC: Add new pyproj logo (issue #700) - REF: Handle deprecation of proj_context_set_autoclose_database (issue #866) - REF: Make CRS methods inheritable (issue #847) - ENH: Added pyproj.crs.CRS.is_derived (pull #902) - ENH: Added pyproj.crs.GeocentricCRS (pull #903) - ENH: Added pyproj.crs.CRS.list_authority (issue #918) - ENH: Added inplace kwarg to pyproj.transformer.Transformer.transform (issue #906) - PERF: Disable unnecessary copy in dtype conversion for buffer (pull #904) - DOC: Improve FAQ text about CRS formats (issue #789) - BUG: Add PyPy cython array implementation (issue #854) - BUG: Fix spelling for
pyproj.crs.coordinate_operation.AzimuthalEquidistantConversion and pyproj.crs.coordinate_operation.LambertAzimuthalEqualAreaConversion (issue #882)
BUG: Make datum name match exact in pyproj.database.query_utm_crs_info (pull #887)
BUG: Update pyproj.enums.GeodIntermediateFlag for future Python compatibility (issue #855)
BUG: Hide unnecessary PROJ ERROR from proj_crs_get_coordoperation (issue #873)
BUG: Fix pickling for CRS builder classes (issue #897)
CLN: Remove ignore_axis_order kwarg from pyproj.crs.CRS.is_exact_same as it was added by accident (pull #904)
CLN: remove numeric/numarrays support (pull #908)
LNT: Add pylint & address issues (pull #909)
DEP: Remove distutils dependency (pull #917)
# Acknowledgements
Thanks to everyone who contributed to this release! The detailed bug reports are definitely appreciated. Additionally, thanks to those who help with the distribution!
A total of 2 people contributed patches to this release. People with a "+" by their names contributed a patch for the first time.
Brendan Jurd + (Made the new logo!)
Alan D. Snow
Other contributions:
Bas Couwenberg - testing the builds with Debian.
Jos de Kloe - testing the builds with Fedora.
Christoph Gohlke - testing the builds on Windows & providing Window's wheels.
Joris Van den Bossche - PR reviews.
REF: Skip transformations if noop & deprecate skip_equivalent (pull #824)
# Changes
DEP: Minimum supported Python version 3.7 (issue #790)
REF: Multithread safe CRS, Proj, & Transformer (issue #782)
BUG: Disallow NaN values with AreaOfInterest & BBox (issue #788)
ENH: Pretty format PROJ string support (issue #764)
ENH: Added pyproj.transformer.Transformer.to_proj4 (pull #798)
ENH: Added authority, accuracy, and allow_ballpark kwargs to pyproj.transformer.Transformer.from_crs (issue #754)
ENH: Added support for "AUTH:CODE" input to pyproj.transformer.Transformer.from_pipeline (issue #755)
ENH: Added pyproj.crs.CRS.to_3d (pull #808)
ENH: Added pyproj.transformer.Transformer.transform_bounds (issue #809)
ENH: Added pyproj.crs.CRS.is_compound (pull #823)
ENH: Added initial_idx and terminal_index kwargs to pyproj.Geod.npts (pull #841)
ENH: Added pyproj.Geod.inv_intermediate & pyproj.Geod.fwd_intermediate (pull #841)
REF: Skip transformations if noop & deprecate skip_equivalent (pull #824)
# Acknowledgements
Thanks to everyone who contributed to this release! The detailed bug reports are definitely appreciated. Additionally, thanks to those who help with the distribution!
A total of 3 people contributed patches to this release. People with a "+" by their names contributed a patch for the first time.
David Hoese +
Idan Miara +
Alan D. Snow
Other contributions:
Joris Van den Bossche - PR review & idea to make pyproj threadsafe, Bas Couwenberg - testing the builds with Debian.
Use proj_context_errno_string in PROJ 8+ due to deprecation (issue #760)
proj_context_errno_string in PROJ 8+ due to deprecation (issue #760)Thanks to everyone who contributed to this release! The detailed bug reports are definitely appreciated. Additionally, thanks to those who help with the distribution!
A total of 2 people contributed patches to this release.
Micah Cochran Alan D. Snow
Other contributions:
Joris Van den Bossche - PR review, Bas Couwenberg - testing the builds with Debian.
DST: Do not include test package in wheels
Thanks to everyone who contributed to this release and to those who help with the distribution!
A total of 2 people contributed patches to this release. People with a "+" by their names contributed a patch for the first time.
Minimum supported Python version 3.6 (issue #499)
__array__ method (pandas.Series, xarray.DataArray, dask.array.Array) (issue #573)pyproj.datadir.get_user_data_dir() (pull #636)pyproj.transformer.Transformer.is_network_enabled (issue #629)pyproj.transformer.TransformerGroup.download_grids() (pull #643)pyproj.database.get_units_map() & cleanup pyproj.database.get_codes() (issue #619)Proj & Transformer.from_pipeline & use less gil (issue #612)__eq__ when comparing CRS sub-classes (i.e. PrimeMeridian, Datum, Ellipsoid, etc.) (issue #606)proj_is_equivalent_to_with_ctx in the place of proj_is_equivalent_to internally (issue #666)pyproj.database.query_crs_info() (pull #703)pyproj.database.query_utm_crs_info() (pull #712)Proj to inherit from Transformer (issue #624)pyproj.database, pyproj.aoi, and pyproj.list modules (pull #703)Geod (pull #686)Thanks to everyone who contributed to this release! The detailed bug reports are definitely appreciated. Additionally, thanks to those who help with the distribution!
A total of 8 people contributed patches to this release. People with a "+" by their names contributed a patch for the first time.
Other contributions:
post1 release with a MANIFEST.in catchNothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
- WHL: Wheels contain PROJ version is 7.0.1
WHL: Wheels contain PROJ version is 7.0.1
BUG: Allow *_name to be added in CRS.to_cf (issue #585)
BUG: Fix building prime meridian in pyproj.crs.CRS.from_cf() (pull #588)
BUG: Fix check for numpy bool True kwarg (pull #590)
DOC: Update pyproj.Proj docstrings for clarity (issue #584)
Added pyproj.proj_version
BUG: Fix pyproj.Proj.get_factors() (issue #600)
BUG: fix unequal (!=) with non-CRS type (pull #596)
- ENH: Added pyproj.Proj.get_factors() (issue #503)
ENH: Added pyproj.Proj.get_factors() (issue #503)
ENH: Added type hints (issue #369)
BUG: Don’t use CRS classes for defaults in CRS child class init signatures (issue #554)
ENH: Updated pyproj.crs.CRS.axis_info to pull all relevant axis information from CRS (issue #557)
ENH: Added pyproj.transformer.Transform.eq() (issue #559)
ENH: Added pyproj.crs.CRS.utm_zone (issue #561)
BUG: Modify CRS dict test to accommodate numpy bool types. (issue #564)
BUG: Fix pipeline transformations to match cct (issue #565)
BUG: Don’t silently ignore kwargs when projparams are specified (Proj & CRS) (issue #565)
- Remove deprecated PyObject_AsWriteBuffer (issue #495)
WHL: Wheels contain PROJ version is 6.3.1
Remove deprecated PyObject_AsWriteBuffer (issue #495)
ENH: Added pyproj.crs.CRS.equals() with ignore_axis_order kwarg (issue #493)
ENH: Added pyproj.crs.CoordinateSystem.from_json() , pyproj.crs.CoordinateSystem.from_json_dict() , and pyproj.crs.CoordinateSystem.from_string() (pull #501)
ENH: Added pyproj.crs.CoordinateSystem to pyproj.crs namespace (pull #501)
ENH: Added pyproj.crs.CoordinateSystem.from_user_input() , pyproj.crs.CoordinateOperation.from_user_input() , pyproj.crs.Datum.from_user_input() , pyproj.crs.PrimeMeridian.from_user_input() , pyproj.crs.Ellipsoid.from_user_input() (pull #502)
ENH: Added pyproj.crs.CoordinateSystem.from_name() , pyproj.crs.CoordinateOperation.from_name() , pyproj.crs.Datum.from_name() , pyproj.crs.PrimeMeridian.from_name() , pyproj.crs.Ellipsoid.from_name() (pull #505)
BUG: Fix getting pyproj.crs.Ellipsoid.semi_minor_metre when not computed (issue #457)
ENH: Added support for custom CRS (issue #389)
ENH: Added enumeration for WKT2_2019 (issue #526)
ENH: Update from_cf/to_cf to use WKT instead of PROJ strings for internal management (issue #515)
Nothing published for this version
- Elevate +init= warning to FutureWarning (pull #486)
Elevate +init= warning to FutureWarning (pull #486)
Add UserWarning to pyproj.crs.CRS.to_proj4() (pull #486)
BUG: Fix for 32-bit i686 platforms (issue #481)
Return ‘inf’ in Proj instead of 1.e30 (pull #491)
- WHL: Wheels contain PROJ version is 6.2.1 (issue #456)
WHL: Wheels contain PROJ version is 6.2.1 (issue #456)
WHL: Wheels for Linux x86_64 use manylinux2010 (pyproj4/pyproj-wheels/pull/18)
BUG: Fix setting lat_ts for mercator projection in pyproj.crs.CRS.from_cf() and pyproj.crs.CRS.to_cf() (issue #461)
BUG: latlon -> longlat in CRS.from_cf() for o_proj so behavior consistent in PROJ 6.2.0 and 6.2.1 (pull #472)
ENH: Add repr for pyproj.crs.CoordinateOperation and for pyproj.transformer.TransformerGroup (pull #464)
- Minimum PROJ version is 6.2.0 (issue #411)
Minimum PROJ version is 6.2.0 (issue #411)
Removed global pyproj context (issue #418)
Added support for PROJ JSON in pyproj.crs objects and pyproj.Transformer (pull #432)
Moved doctests code out of pyproj.init (issue #417)
Added version information to python -m pyproj (pull #429)
Added scope & remarks to pyproj.crs objects and pyproj.Transformer (issue #441)
Added operations to pyproj.crs.CoordinateOperation objects and pyproj.Transformer (issue #441)
Added pyproj.get_authorities() and pyproj.get_codes() (issue #440)
Release gil in core cython/PROJ code (issue #386)
BUG: Added checks for uninitialized pyproj.crs objects to prevent core dumping (issue #433)
BUG: Added fix for get_transform_crs when checking type (pull #439)
DOC: Build docs with python3 (pull #428)
- Added cleanup for internal PROJ errors (issue #413)
Added cleanup for internal PROJ errors (issue #413)
Delay checking for pyproj data directory until importing pyproj (issue #415)
Address issue where PROJ core dumps on proj_create with +init= when global context does not have data directory set (issue #415 & issue #368)
- Removed deprecated functions Proj.proj_version , CRS.is_valid , and CRS.to_geodetic() (pull #371)
Minimum supported Python version 3.5 (issue #331)
Added support for calculating geodesic area ( pyproj.Geod.polygon_area_perimeter() ) and added interface to calculate total length of a line ( pyproj.Geod.line_length() & pyproj.Geod.line_lengths() ) (issue #210).
Added support for calculating geodesic area and line lengths with shapely geometries ( pyproj.Geod.geometry_area_perimeter() & pyproj.Geod.geometry_length() ) (pull #366)
Added pyproj.transformer.TransformerGroup to make all transformations available (issue #381)
Added option for area_of_interest for pyproj.transformer.Transformer.from_crs() , pyproj.transformer.Transformer.from_proj() and pyproj.transformer.TransformerGroup
Added pyproj.transformer.Transformer.area_of_use (issue #385)
Added pyproj.crs.CoordinateOperation.area_of_use (issue #385)
Updated to only have one PJ_CONTEXT per pyproj session (issue #374)
Always return latlon with Proj (issue #356)
Remove aenum dependency (issue #339)
Removed deprecated functions Proj.proj_version , CRS.is_valid , and CRS.to_geodetic() (pull #371)
Search on sys.prefix for the PROJ data directory (issue #387)
- Add deprecation warning when using +init= syntax (pull #358)
Update wheels to PROJ 6.1.1
Add deprecation warning when using +init= syntax (pull #358)
Added pyproj.crs.is_proj() (pull #359)
Fixed case in pyproj.crs.CRS.to_dict() with pyproj.crs.CRS.to_proj4() returning None (pull #359)
Keep no_defs in input PROJ string as it does not hurt/help anything in current code (pull #359)
Made public properties on C classes readonly (pull #359)
Update data dir exception handling to prevent ignoring errors (pull #361)
pyproj.crs.CRS.to_cf() export transverse mercator parameters for UTM zones (pull #362)
- Deprecate Proj.proj_version (pull #337)
Added pyproj.show_versions() (issue #334)
Added fix for whitepace around ‘=’ in PROJ strings (issue #345)
Update version check in setup.py (issue #323)
Add “stable” doc site pointing to latest release (issue #347, pull #348)
Deprecate Proj.proj_version (pull #337)
Test fixes (pull #333, pull #335)
- Undo deprecation of pyproj.transformer.Transformer.from_crs() (issue #275)
Minimum PROJ version is now 6.1.0
Updated CRS repr (issue #264)
Add Datum, CoordinateSystem, CoordinateOperation classes, (issue #262)
Added pyproj.crs.CRS.to_cf() and pyproj.crs.CRS.from_cf() for converting to/from Climate and Forecast (CF) 1.8 grid mappings (pull #244)
Added pyproj.crs.CRS.to_dict() (issue #226)
Added pyproj.crs.CRS.to_authority() (pull #294)
Added pyproj.crs.CRS.is_vertical and pyproj.crs.CRS.is_engineering (issue #316)
Added pyproj.crs.CRS.target_crs (pull #328)
Provide option to “pretty print” WKT in pyproj.crs.CRS.to_wkt (issue #258)
Add support for Bound and Compound CRS for pyproj.crs.CRS.is_geographic , pyproj.crs.CRS.is_projected (issue #274)
Add support for Bound CRS for pyproj.crs.CRS.is_geocentric (issue #374)
Add support for comparison with CRS a non-crs type supported by pyproj.crs.CRS.from_user_input() (issue #312)
Added support for ITRF, compound EPSG, and urn projection strings in CRS (pull #289)
Better handle Compound CRS (issue #265)
Disallow creation of non-CRS object (eg pipeline) in CRS class (issue #267)
Added check in pyproj.crs.CRS.to_epsg() for when proj_list is null (issue #257)
Fix comparing classes of non-instance types (issue #310)
Added always_xy option to Transformer so the transform method will always accept as input and return as output coordinates using the traditional GIS order, that is longitude, latitudecfor geographic CRS and easting, northing for most projected CRS (issue #225)
Provide direction option in pyproj.transformer.Transformer.transform() (issue #266)
Add check for valid initialization of Transformer and ensure it is a transformer (issue #321)
Added pyproj.transformer.Transformer.to_wkt() as well as attributes related to PJ_PROJ_INFO (pull #322)
Undo deprecation of pyproj.transformer.Transformer.from_crs() (issue #275)
Fix false positive errors raised in transformer (issue #249)
Fix pyproj.Proj initialization from DerivedGeographicCRS (issue #270)
Add interface to get the projection/ellps/prime_meridian/units lists (issue #251)
Docs/Build/Test fixes (pull #278, pull #245, pull #248, pull #247, issue #253, pull #252)
- Added support for time transformations (issue #208)
Added support for time transformations (issue #208)
Fixed projection equivalence testing for transformations (pull #231).
Switch to pytest for testing (pull #230)
Various testing fixes (pull #223, #222, #221, #220)
Convert PROJ error messages from bytes to strings (pull #219)
Fix data dir path separator to be (;) for windows and (:) for linux (pull #234)
- Updated to use the CRS definition for Proj instances in transforms (issue #207)
Updated to use the CRS definition for Proj instances in transforms (issue #207)
Add option to skip transformation operation if input and output projections are equivalent and always skip if the input and output projections are exact (issue #128)
Update setup.py method for checking PROJ version (pull #211)
Add internal proj error log messages to exceptions (pull #215)
- Restore behavior of 1.9.6 when illegal projection transformation requested (return inf instead of raising an exception, issue #202). kwarg errcheck
Restore behavior of 1.9.6 when illegal projection transformation requested (return inf instead of raising an exception, issue #202). kwarg errcheck added to pyproj.transformer.transform() and pyproj.transformer.itransform() (default False ). When errcheck=True an exception is raised.
- Added pyproj.transformer.Transformer to make repetitive transformations more efficient (issue #187)
Added pyproj.transformer.Transformer to make repetitive transformations more efficient (issue #187)
Added fix for using local datumgrids with transform (issue #191)
Added pyproj.transformer.Transformer.from_pipeline() to support pipeline transformations.
Added fix for conversion between radians/degrees for transformations (issues #192 & #195)
- add filter for boolean values in dict2string so “no_rot=True” works (issue #183).
add filter for boolean values in dict2string so “no_rot=True” works (issue #183).
make sure .pxd files included in source tarball.
add radians flag back in for transform/itransform (issue #185).
- Ensure data path set properly for TransProj (pull request #179, addressed issue #176).
Ensure data path set properly for TransProj (pull request #179, addressed issue #176).
- Update to PROJ version 6.0.0 & removed support for older PROJ versions.
Update to PROJ version 6.0.0 & removed support for older PROJ versions.
Added pyproj.CRS class.
Updated pyproj.Proj & pyproj.transform to accept any input from CRS.from_user_input.
Removed internal PROJ source code.
Changed default for preserve_units to be True in pyproj.Proj class initialization.
Modified logic for searching for the PROJ data directory to not conflict with older versions of PROJ.
Added pyproject.toml.
- fix segfault when inverse projection not defined (issue #43, pull request
fix segfault when inverse projection not defined (issue #43, pull request #44).
supports python 3.7
- fix for issue #42 (compilation error with microsoft visual studio).
fix for issue #42 (compilation error with microsoft visual studio).
- update proj4 source to latest github master (commit 953cc00fd87425395cabe37641cda905c4b587c1).
update proj4 source to latest github master (commit 953cc00fd87425395cabe37641cda905c4b587c1).
port of basemap fix for input arrays in fortran order
restore inverse Hammer patch that was lost when proj4 source code was updated.
- migrate to github from googlecode.
migrate to github from googlecode.
update proj4 source code from svn r2595 (version 4.9.0RC2).
include runtime_library_dirs in setup-proj.py.
added to_latlong method (issue 51).
fix back azimuth when lon1 and lon2 are identical.
- Geod now uses C code adapted from geographiclib now included in proj4 source, instead of pure python code directly from geographiclib.
Geod now uses C code adapted from geographiclib now included in proj4 source, instead of pure python code directly from geographiclib.
make radians=True work with Geod.npts (issue 47).
allow PROJ_DIR env var to control location of proj data (issue 40).
- updated proj4 src to 4.8.0 - includes two new map projections (natearth and isea).
updated proj4 src to 4.8.0 - includes two new map projections (natearth and isea).
- use pure python geographiclib for geodesic computation codes instead of proj4.
use pure python geographiclib for geodesic computation codes instead of proj4.
don’t use global variable pj_errno for return codes, use pj_ctx_get_errno instead.
use new projCtx structure for thread safety in proj lib.
update C source and data from proj4 svn (r2140).
add pj_list and pj_ellps module level variables (a dict mapping short names to longer descriptions, e.g. pyproj.pj_list[‘aea’] = ‘Albers Equal Area’).
One column per quarter.