1
-------------------- P R O J . 4 --------------------
3
This is Release 4.4 of cartographic projection software.
5
PLEASE read the following information as well as READMEs in the src
8
For more information on PROJ.4 maintenance please see the web page at:
10
http://www.remotesensing.org/proj
12
---------------------------------------------------
17
FSF's configuration procedure is used to ease installation of the
20
The default destination path prefix for installed files is /usr/local.
21
Results from the installation script will be placed into subdirectories
22
bin, include, lib, man/man1 and man/man3. If this default path prefix
23
is proper, then execute:
27
If another path prefix is required, then execute:
29
./configure --prefix=/my/path
31
In either case, the directory of the prefix path must exist and be
32
writable by the installer.
34
After executing configure, execute:
39
The install target will create, if necessary, all required sub-directories.
44
PROJ.4 can be built with Microsoft Visual C/C++ using the makefile.vc
45
in the src directory. First edit the PROJ\SRC\makefile.vc and modify
46
the PROJ_LIB_DIR value at the top to point to the NAD subdirectory
47
of wherever you put the PROJ tree. If you unpacked it as C:\PROJ it
48
can remain unchanged. The use the makefile.vc to build the software:
52
C>\PROJ\SRC> nmake /f makefile.vc all
54
Note that you have to have the VC++ environment variables, and path
55
setup properly. This may involve running the VCVARS32.BAT script out
56
of the Visual C++ tree.
58
The makefile.vc builds proj.exe, proj.dll and proj.lib.
60
It should also be possible to build using the Unix instructions
61
and Cygwin32, but this hasn't been tested recently.
64
---------------------------------------------------
66
Distribution files and format.
67
------------------------------
69
Sources are distributed in one or more files. The principle elements
70
of the system are in a compress tar file named `PROJ.4.x.tar.gz' where
71
"x" will indicate level.sub-level of the release. For U.S. users
72
interested in NADCON datum shifting procedures, additional files
73
containing conversion matricies are distributed with the name
74
`PROJ.4.x.y.tar' where y is an uppercase letter starting with "A."
75
These supplementary files will contain compressed files and thus
76
the tar file is not compressed.
78
Interim reports on Rel. 4 proj are available in PostScript form as
79
*.ps.gz . New and old users are strongly recommended to carefully read
80
these manuals. They are supplements and NOT a replacement for the full
81
manual OF 90-284 (which new users should also obtain).
83
---------------------------------------------------
85
Principle new aspects of system:
86
--------------------------------
88
ANSI X3.159-1989 C code. Site must have ANSI C compiler and header files.
90
Several method of determining radius from specified ellipsoid.
92
Use of initialization files through +init=file:key. Default projection
93
specifications also may be defined in an ASCII file.
95
+inv option REMOVED and -I may be used in its place. Use of invproj
96
alias of proj still functions as per Rel.3.
98
+ellps=list and +proj=list REMOVED. Use respective -le and -lp.
100
+units= to specify cartesian coordinate system units. To get list
103
-v added to dump final cartographic parameters employed.
105
Addition of computing scale factors and angular distortion added through
106
-S option. Valuable for designing new projection parameter details.
108
-V option which verbosely lists projected point characteristics.
110
Programmers may use projection library with calls to pj_init,
111
pj_fwd, pj_inv and pj_transform.
113
Program nad2nad for conversion of data to and from NAD27 and NAD83
116
Program cs2cs for converting between coordinate systems, with optional
119
-------------------------------------------------------------
121
Things currently left undone:
122
----------------------------
124
proj_def.dat NOT fully in place. Needs additional settings for
125
many of the projections. Probably will not be completed until main
added
removed
README
