    -------------------- P R O J . 4 --------------------
                      @(#)README	4.7 93/11/10 GIE REL"

This is Release 4 of cartographic projection software and replaces
Release 3 proj.

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

PLEASE send information on any problems encountered or general inquiries to

	gie@charon.er.usgs.gov (128.128.40.24)

or call Gerald I. Evenden at (508)563-6766 or write to same at:

	P.O. Box 1027
	N. Falmouth, MA 02556-1027

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

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

An interim report on Rel. 4 proj available in PostScript form
as PROJ.4.x.ps.Z .  New and old users are strongly recommended to
carefully read this manual.  This is a supplement and NOT a replacement
for the full manual OF-90-284 (which new users should also obtain).

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

Please destroy any previous alpha or beta versions of Release 4.
There are variants in all pre-release version that may be incompatible
with the current version.

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

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

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

Default ellipsoid removed from proj.  User MUST specify ellipsoid or
Earth's radius or use "proj_def.dat" file.

+R=radius may be used instead of +a=radius (+es=0 or implicit).

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 and
pj_fwd and/or pj_inv.

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

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

Installation:

Machines that have currently successfully compiled and executed proj and
where the "install" script may be used:

	dec  -- DEC Ultrix, also use sh5 or ksh.
	sun4.1 -- Sun OS4.1.1 (GNU's gcc or other ANSI compiler required)
	DG   -- AViiON
	plain -- fully ANSI or POSIX OK as far as PROJ concerned:
		solaris, (Sun native c compiler) from Andrew J.P. Maclean
			University of Western Sydney, Australia, a.maclean@uws.edu.au.
		DELL SYSVr4
		Silicon Graphics
		MS/PC-DOS - with Microsoft C 5.0
		SCO, Xin Zhuang, zhuang@access.digex.net

The first or key word listed above should be the first argument to
executing "install", followed by directories for "bin", "lib",
"lib_name" and includes.  For example:
	
	install DG /usr/local/bin /usr/local/lib proj /usr/local/include

The author would appreciate hearing of other systems where proj has
been installed and any notes as to problems and options taken.

Thank-you.

Installers on other systems study options specified in "install"
script and read README in ./src.

  ________________________________________________________________

New projections:

	alsk - Alaska modified stereographic
	gs50 - 50 United States, modified stereographic.
		Not known if used by anyone and NOT recommended.
	lee_os - Lee Oblate Stereographic of Pacific.
	mill_os - Miller Oblate Stereographic of Eur-Africa.
	lsat - LANDSAT 1-5 form of space oblique mercator
	tpeqd - Two point equidistant
	nzgm - New Zealand Grid Map
	ob_tran - General oblique/transverse transformation for most
			projections

  ________________________________________________________________

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

Replacement for nad27/nad83 scripts for listing State zones and their
numbers.

Updating of OF manual.

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