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