PROJ.4 - Cartographic Projections Library
C CMake HTML Python Java C++ Other
Latest commit adf4248 Feb 15, 2017 @kbevers kbevers committed on GitHub Merge pull request #491 from cffk/geod-1.47
Issue #490 update from geodesic routines from GeographicLib 1.47.
Permalink
Failed to load latest commit information.
cmake Fixed a cmake option message that was being truncated due to being sp… Mar 7, 2016
com Fix permissions of some files. Jun 28, 2015
docs Added doc page for Miller projection Feb 3, 2017
examples Horner and helmert (#456) Dec 15, 2016
html Add a scripts/fix_typos.sh script and correct reported errors Dec 12, 2016
jniwrap Add a scripts/fix_typos.sh script and correct reported errors Dec 12, 2016
m4 BLD: Remove generated files. Sep 10, 2015
man Issue #490 update from geodesic routines from GeographicLib 1.47. Feb 15, 2017
nad Update to EPSG v9.0 database (#477) Jan 10, 2017
scripts Add a scripts/fix_typos.sh script and correct reported errors Dec 12, 2016
src Issue #490 update from geodesic routines from GeographicLib 1.47. Feb 15, 2017
test/gigs Add a scripts/fix_typos.sh script and correct reported errors Dec 12, 2016
travis .travis.yml: add multi config setup Jan 19, 2017
wince/msvc80 - API Extension to include fwd3d / inv3d Oct 23, 2015
.gitignore start working on sphinx version of proj4.org Feb 24, 2016
.travis.yml .travis.yml: add multi config setup Jan 19, 2017
AUTHORS update AUTHORS with myself and Charles Feb 23, 2015
CMakeLists.txt Add a scripts/fix_typos.sh script and correct reported errors Dec 12, 2016
COPYING put under MIT license Mar 27, 2000
ChangeLog Add a scripts/fix_typos.sh script and correct reported errors Dec 12, 2016
Dockerfile update Dockerfile to xenial Sep 8, 2016
HOWTO-RELEASE start working on sphinx version of proj4.org Feb 24, 2016
INSTALL New Jul 21, 2008
Makefile.am one more CMake-related fixup #243 Sep 13, 2014
NEWS update 4.9.3 release notes Sep 6, 2016
README Update README Oct 5, 2016
appveyor.yml Changed self-test build behaviour from opt-out to opt-in Aug 22, 2016
autogen.sh BLD: Remove proj_config.h.in. Sep 10, 2015
configure.ac Upgrade geodesic library from GeographicLib 1.46. Feb 15, 2016
makefile.vc Remove unused $Id$ keywords. May 31, 2015
nmake.opt Added missing debug flag in nmake-debug configuration Feb 13, 2017
proj.pc.in added pkg-config support (#3) Jul 23, 2011
proj.spec Add BuildRequires and run autogen.sh (PR #434) Oct 25, 2016

README

   -------------------- P R O J . 4 --------------------

PROJ.4 is a cartographic projection software.

PLEASE read the following information as well as READMEs in the src
and nad directories.

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

  http://proj4.org/

   ---------------------------------------------------

Installation:
-------------

FSF's configuration procedure is used to ease installation of the
PROJ.4 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:

	./configure

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
        make install

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

Windows Build
-------------

PROJ.4 can be built with Microsoft Visual C/C++ using the makefile.vc
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 makefile.vc to build the software:

eg. 
C:\> cd proj
C:\PROJ> nmake /f makefile.vc
C:\PROJ> nmake /f makefile.vc 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 makefile.vc builds proj.exe, proj.dll and proj.lib. 

It should also be possible to build using the Unix instructions
and Cygwin32, but this hasn't been tested recently. 


   ---------------------------------------------------

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.4.x.tar.gz' where
"x" will indicate level.sub-level of the release.  For U.S. users
interested in NADCON datum shifting procedures, additional files
containing conversion matricies are distributed with the name
`PROJ.4.x.y.tar' where y is an uppercase letter starting with "A."
These supplementary files will contain compressed files and thus
the tar file is not compressed.

Interim reports on Rel. 4 proj are available in PostScript form as
*.ps.gz .  New and old users are strongly recommended to carefully read
these manuals.  They are supplements and NOT a replacement for the full
manual OF 90-284 (which new users should also obtain).

   ---------------------------------------------------

Principle new aspects of system:
--------------------------------

ANSI X3.159-1989 C code.  Site must have ANSI C compiler and header files.

Several method of determining radius from specified ellipsoid.

Use of initialization files through +init=file:key.  Default projection
specifications also may be defined in an ASCII file.

+inv option REMOVED and -I may be used in its place.  Use of invproj
alias of proj still functions as per Rel.3.

+ellps=list and +proj=list REMOVED.  Use respective -le and -lp.

+units= to specify cartesian coordinate system units.  To get list
use -lu.

-v added to dump final cartographic parameters employed.

Addition of computing scale factors and angular distortion added through
-S option.  Valuable for designing new projection parameter details.

-V option which verbosely lists projected point characteristics.

Programmers may use projection library with calls to pj_init,
pj_fwd, pj_inv and pj_transform.

Program nad2nad for conversion of data to and from NAD27 and NAD83
datums.

Program cs2cs for converting between coordinate systems, with optional
datum translation.

-------------------------------------------------------------

Things currently left undone:
----------------------------

proj_def.dat NOT fully in place.  Needs additional settings for
many of the projections.  Probably will not be completed until main
manual rewritten.