Repository files navigation

PROJ is a generic coordinate transformation software, that transformscoordinates from one coordinate reference system (CRS) to another.This includes cartographic projections as well as geodetic transformations.

For more information on the PROJ project please see the web page at:

https://proj.org/

The PROJ mailing list can be found at:

https://lists.osgeo.org/mailman/listinfo/proj/

See the NEWS file for changes between versions.

The following command line utilities are included in the PROJ package:

• proj: for cartographic projection of geodetic coordinates.
• cs2cs: for transformation from one CRS to another CRS.
• geod: for geodesic (great circle) computations.
• cct: for generic Coordinate Conversions and Transformations.
• gie: the Geospatial Integrity Investigation Environment.
• projinfo: for geodetic object and coordinate operation queries.
• projsync: for synchronizing PROJ datum and transformation support data.

More information on the utilities can be found on thePROJ website.

Consult theInstallation page of the officialdocumentation.For builds on the master branch,install.rstmight be more up-to-date.

Sources are distributed in one or more files. The principle elementsof the system are stored in a compressed tar file namedproj-x.y.z.tar.gz where"x" will indicate the major release number, "y" indicates the minor releasenumber, and "z" indicates the patch number of the release.

In addition to the PROJ software package, distributions of datumconversion grid files and PROJ parameter files are also available.The grid package is distributed under the nameproj-data-x.y.zip,where "x" is the major release version and "y" is the minor releaseversion numbers. The resource packages can be downloaded from thePROJ website.

More info on the contents of the proj-data package can befound at thePROJ-data GitHub repository.

The resource file packages should be extracted toPROJ_LIBwhere PROJ will find them after installation. The default location ofPROJ_LIB on UNIX-based systems is/usr/local/share/proj but it maybe changed to a different directory. On Windows you have to definePROJ_LIB yourself.

As an alternative to installing the data package on the local system,the resource files can be retrieved on-the-fly from thePROJ CDN. Anetwork-enabled PROJ build, willautomatically fetch resource files that are not present locally from theCDN.

SeeCITATION