PROJ.4 - Cartographic Projections Library
C C++ CMake M4 Shell Java Other
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.
cmake Upgrade http:// to https:// where feasible Jun 2, 2018
docs Add version of introduction to eqearth docs Aug 17, 2018
examples pj_obs_api_mini_demo.c: fix typo: en -> enu for PJ_COORD May 6, 2018
jniwrap Upgrade http:// to https:// where feasible Jun 2, 2018
m4 use shortened URL from StackExchange websites Jun 2, 2018
man Upgrade http:// to https:// where feasible Jun 2, 2018
nad nad/ add null.lla to EXTRA_DIST Aug 11, 2018
scripts Merge pull request #1038 from kbevers/howtorelease Jun 10, 2018
src Implementation of Equal Earth projection (#1090) Aug 17, 2018
test Implementation of Equal Earth projection (#1090) Aug 17, 2018
travis Add Dockerfile for osgeo/proj-docs image Aug 13, 2018
.gitignore Start a `customstyle` for bibliographic references Jun 14, 2018
.travis.yml CI environment: adapt for C++11 capable environments May 30, 2018
AUTHORS Add myself to AUTHORS Aug 29, 2017
CITATION Upgrade http:// to https:// where feasible Jun 2, 2018
CMakeLists.txt Raise version number to 5.2.0 in CMake config Jun 20, 2018 Upgrade http:// to https:// where feasible Jun 2, 2018
COPYING put under MIT license Mar 27, 2000
ChangeLog Add a scripts/ script and correct reported errors Dec 12, 2016
Dockerfile base osgeo/proj automated Docker image on Ubuntu 18.04 Aug 13, 2018
HOWTO-RELEASE Move news to its own page in docs. Jun 27, 2018
INSTALL New Jul 21, 2008 Add a CITATION file (fixes #309) Apr 12, 2018
NEWS Add missing note about removing org_proj4_Projections.h May 24, 2018 Use "PROJ" instead of "proj.4" in list badge Jul 6, 2018
appveyor.yml Add pj_phi2_test (#1039 & #1045) Jun 18, 2018 BLD: Remove Sep 10, 2015 bump version numbers to 5.2.0 Jun 8, 2018 Remove unused $Id$ keywords. May 31, 2015
nmake.opt Remove the last remains of the internal selftest Nov 29, 2017 added pkg-config support (#3) Jul 23, 2011


Travis Status AppVeyor Status Coveralls Status Gitter Mailing List

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

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

The PROJ.4 mailing list can be found at:

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.


Building with CMake

cd proj
mkdir build
cd build
cmake ..
cmake --build .

On Windows, one may need to specify generator:

cmake -G "Visual Studio 15 2017" ..

Tests are run with


The test suite requires that the proj-datumgrid package is installed in PROJ_LIB.

Building on Unix/Linux

FSF's configuration procedure is used to ease installation of the PROJ system.

The default destination path prefix for installed files is /usr/local. Results from the installation script will be placed into subdirectories bin, include, lib, man/man1 and man/man3. If this default path prefix is proper, then execute:


See the note below if you are building PROJ directly from the git repository.

If another path prefix is required, then execute:

./configure --prefix=/my/path

In either case, the directory of the prefix path must exist and be writable by the installer. After executing configure, execute:

make install

The install target will create, if necessary, all required sub-directories.

Tests are run with

make check

The test suite requires that the proj-datumgrid package is installed in PROJ_LIB.

Building from the git repository

If you are building from the git repository you have to first run


which will generate a configure script that can be used as described above.

Building on Windows with NMAKE

PROJ can be built with Microsoft Visual C/C++ using the in the PROJ directory. First edit the PROJ\nmake.opt and modify the INSTDIR value at the top to point to the directory where the PROJ tree shall be installed. If you want to install into C:\PROJ, it can remain unchanged. Then use the to build the software e.g.:

C:\> cd proj
C:\PROJ> nmake /f
C:\PROJ> nmake /f install-all

Note that you have to have the VC++ environment variables, and path setup properly. This may involve running the VCVARS32.BAT script out of the Visual C++ tree.

The builds proj.exe, proj.dll and proj.lib.

On Windows you have to set the PROJ_LIB environment variable to make sure that PROJ can find the resource files that it needs. For the default install directory you can set PROJ_LIB with:

C:\> set PROJ_LIB=C:\PROJ\share

Distribution files and format

Sources are distributed in one or more files. The principle elements of the system are in a compress tar file named proj-x.y.z.tar.gz where "x" will indicate major release number, "y" indicates minor release number and "z" indicates the patch number of the release.

In addition to the PROJ software package, distributions of datum conversion grid files and PROJ parameter files are also available. The grid package is distributed under the name, where "x" is the major release version and "y" the minor release version numbers. Similarly regional packages are distributed. The regional packages contain resources that are not essential to the functionality of PROJ but still of value to users in the region specific to the package. All grids that were in proj-datumgrids-1.6 remain in proj-datumgrids-1.7; the regional datumgrid files contain grids for datums not previously supported (prior to PROJ 5.0.0).

The resource packages can be downloaded from the PROJ.4 website.

More info on the contents of the various resource packages can be found at the proj-datumgrid GitHub repository.

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

Citing PROJ in publications