Debian Codegraph @

README

raw
1 August 1998
2
3 ******** Disclaimer ********
4
5 The General Cartographic Transformation Package (GCTP) is a system of
6 software routines designed to permit the transformation of coordinate
7 pairs from one map projection to another. The GCTP is the standard
8 computer software used by the National Mapping Division for map
9 projection computations.
10
11 Because of requirements internal to the EROS Data Center, the GCTP software
12 was converted from FORTRAN to the C programming language, and several new
13 projections were added. During the conversion process, the software was
14 tested on the following UNIX systems: Data General running DG/UX Release
15 5.4R2.01 AViiON, SUN running SunOS Release 4.1.3, and Silicon Graphics
16 running IRIX Release 5.3 IP7. In addition, the software has also been
17 verified against the current National Mapping Division (NMD) GCTP
18 software. This new version, GCTPC, is being made available informally
19 on a 'user-beware' basis. EDC assumes no responsibility for the accuracy
20 of the routines in this package.
21
22 Because of decreasing budgets and impacts on software development staff,
23 EDC will not be responsible for supporting this software package. The
24 user is responsible for using the package correctly. A set of validation
25 data is provided so that each user/facility may perform its' own testing
26 of the programs. A description of this data set and instructions for its
27 use are in the test/README file. EDC will welcome any questions, comments,
28 or suggestions, and will respond on a time-available basis based on our
29 interests and requirements. Communications concerning the GCTPC package
30 may be directed to this email address:
31
32 [email protected]
33
34 --------------------------------------------------------------------------------
35
36 The GCTPC Directory Structure is as follows:
37
38 gctpc
39
40 - README
41 - Announce.txt contains information on retrieving and installing
42 GCTPC
43
44 gctpc/doc:
45
46 - Documentation for GCTPC
47
48 gctpc/source:
49
50 - Code for the GCTPC library. A Makefile exists that has been
51 tested on Data General, SUN, and Silicon Graphics systems.
52
53 gctpc/test:
54
55 - Test procedures
56
57 Note: README files located in each directory contain additional information.
58
59
60 Periodic updates and corrections will be put in this directory for access
61 by the science community. Descriptions of these updates will be added to
62 this file.
63
64 Change Log:
65
66 Version Date Comments
67 ------- ----- ----------------------------------------------------------
68 c.1.0 11/93 Initial C version. Includes all previous GCTP projections
69 and Space Oblique Mercator (SOM), Robinson, and Alaska
70 Conformal. The projections Hammer, Interrupted Goode
71 Homolosine, Mollweide, Interrupted Mollweide, Wagner IV,
72 Wagner VII, and Oblated Equal Area have been added.
73
74 c.1.1 1/95 The argument OUTDATUM was added to the GCTP call to add
75 The option to convert from one ellipsoid to another.
76 The ability for UTM to be processed with any ellipsoid code
77 was added. It previously only supported Clarke 1866.
78 Affected source files include: gctp.c, inv_init.c,
79 and for_init.c.
80
81 Modifications have been made to the documentation for
82 clarification. Affected documents include: AppendixA.txt,
83 for_init.ps, gctp.ps, and inv_init.ps. in the document
84 gctp.ps, the 12th spheroid code was changed from WALBECK
85 to WGS 84.
86
87 c.1.2 2/95 Changed the perror call in imolwfor.c and wivfor.c to
88 p_error.
89
90 Files utmfor.c and utminv.c were developed from tmfor.c
91 and tminv.c consecutively. The UTM portion has been
92 taken out of tmfor.c and tminv.c. This change was due
93 to errors that occurred when the utm and tm projection
94 were run in the same direction (forward or inverse) in
95 the same application.
96
97 Both changes to this version are internal and have no
98 impact on the method of application. No changes have
99 been made to documentation.
100
101 c.1.3 2/96 A modification was made to the function alberinv.c.
102 An error was brought to our attention that parenthesis
103 around the argument "1.0 + e3" was missing in the
104 assignment of the variable con on line 149. This
105 error was found by comparing the C code to the FORTRAN
106 version. The parenthesis have been added to the source.
107 This did not change the results of our tests, therefore,
108 the test data files have not been changed.
109
110 A correction was made to the document xxxinv.ps. The
111 input and output names were switched in the parameter
112 descriptions. Also, an explanation was added to xxxfor.ps
113 (xxxinv.ps) indicating that for_init (inv_init) must be
114 called before calling xxxfor (xxxinv). Small changes
115 were made to gctp.ps, inv_init.ps, and for_init.ps for
116 documentation consistency.
117
118 In the file sphdz.c, the name of spheroid code number 12
119 was incorrectly listed as Walbeck in the comment section.
120 This is actually WGS 84 and has been changed accordingly.
121
122 c.1.4 5/97 The email address for GCTPC support has been changed from
123 [email protected] to [email protected]
124
125 c.2.0 3/98 Version 2.0 of GCTPC will be named gctpc20.tar on the
126 anonymous ftp site which is different from the previous
127 version which was called gctpc.tar.
128
129 Fixed an error with the State Plane projection where no
130 initialization was being done if the spheroid changed.
131 Also, added an error check if the spheroid code is not
132 0 (Clarke 1866) or 8 (GRS 80). State Plane will only
133 support these two spheroid codes to correspond with NAD27
134 and NAD83. An error code number 23 has been added to represent
135 this error.
136
137 New spheroids have been added to the list of standard
138 spheroids. This has been done because of the increasing
139 demand for datum conversions.
140
141 In the init function in report.c, changed successful return
142 value from 0 to OK. In polyinv.c, Changed the error returned
143 to be the same as the flag returned from phi4z instead of
144 74. A list of the error codes and their corresponding messages
145 were added to the doc directory in file error.codes.
146
147 The word "datum" has been switched to "spheroid" within the
148 code were appropriate.
149
150 Took out unnessary line, ranlib, from the Makefile.
151
152 Source code comments were added in various files.
153
154 Added a file in the doc directory called error_codes.txt. This
155 file lists all the error code numbers and what they
156 represent.
157
158 Removed test data from the tm, snsoid, equidc, stereo, and
159 som test directories. This reduces the size of the package
160 from 40.5 megabytes to 38.5 megabytes. As time permits,
161 more work will be done in this area.
162
163 Corrected an error in the phi2z functions in the cproj.c file.
164 the variable flag was being assigned incorrectly.
165
166 Added outspheroid to the br_gctp call.
167
168 Added function prototypes to the proj.h file. Added proj.h
169 cproj.h. Added the function types to each function that was
170 defaulted to int. This was done to eliminate warning messages
171 when compiling with certain flags. I was able to compile with
172 flags "-xansi -32 -mips2 -O2 -fullwarn" with only a few
173 warnings from gctp.c and br_gctp.c.
174
175 Added #include <stdlib.h> and #include <ctype.h> to testproj.c
176 and took out #define NULL 0.
177
178 An error occured on the SUN systems with the sincos subroutine.
179 I took out the "ifndef" statement in the cproj.c file to allow
180 SUN systems to compile and run the sincos subroutine.
181