/proj.4

PROJ.4 - Cartographic Projections Library

Primary LanguageCOtherNOASSERTION

   -------------------- 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.