Installation of Terrain Correction Codes

Run-time Libraries

Prior to using the terrain correction routines, the appropriate run-time libraries should be obtained and installed. The proper libraries to use depend largely upon ones operating system. Roughly speaking, one should install either the RSX or the RSXNT run-time libraries if executing uder Win95 or WinNT, and one should install the EMX run-time libraries if executing under OS/2. If executing under MS-DOS or PC-DOS, one should install the RSX libraries if using a DPMI memory server and the EMX libraries if using a VCPI memory server. Note that HIMEM.SYS, a commonly-used memory extender provided by Microsoft, is a DPMI memory server.

Two versions of the executables are distributed, one designed for use with OS/2 or DOS, but which also executes under Win95 or WinNT, and another designed for use with Win95 or WinNT only. These will be termed the OS/2 and the Win32 versions, respectively. The advantage of using the Win32 version is mainly that, when executing under WinNT, the OS/2 version restricts file names to the DOS 8.3-type file names (although under Win95 this restriction is absent); the Win32 version has no such resrictions. Additionally, the Win32-specific version should be somewhat faster under the more generic version.

Under Win95 or WinNT, either the RSX run-time libraries can be used or the RSXNT run-time libraries. Under OS/2, the EMX run-time libraries should be used. Installation of the run-time libraries is quite straightforward; after downloading the appropriate run-time library, follow the installation instructions in order to be able ti use the library. Normally all one needs to do is to insure that appropriate run-time library in in ones PATH.

The following table shows which executables and run-time libraries to use, depending upon ones operating system and which executable version is to be used.
Operating System Version Run-time Library Remarks
Win95/98/Me Win32 RSXNT Executes in either a DOS window or from Run menu 
Win95/98/Me OS/2 RSX Executes in either a DOS window or from Run menu 
WinNT/2000 Win32 RSXNT Executes in Command Prompt Window or from Run menu 
WinNT/2000 OS/2 RSX Executes in Command Prompt Window or from Run menu; limited to 8.3-type file names 
OS/2 OS/2 EMX Executes from an OS/2 command prompt 
DOS OS/2 EMX or RSX Use EMX if using a VCPI memory server; use RSX if using a DPMI memory server, such as HIMEM.SYS.
The run-time libraries should be installed according to the installation instructions accompanying the particular library. Typically, though, installation is simply a matter of putting the appropriate dynamically-linked library (DLL) in ones PATH environment variable (for Win95/98 or WinNT), or placing the DLL in ones LIBPATH (OS/2), or putting RSX.EXE or EMX.EXE in ones PATH (DOS).

Executable Codes

There are four routines in the terrain correction package. The three main routines are called InnerTC, LaserTC, and RasterTC; in addition, a version of a routine called OuterTC, written by Don Plouff of the U. S. Geological Survey, is distributed. The routines, along with documentation, are distributed in a single zip archive. This archive should be unzipped using InfoZIP's unzip utility. A Win32 version is available here. PKUNZIP can be used to unzip the archive, as well; however, if PKUNZIP is used, one should used the -d option in order to recreate the directory structure present in the archive.

Unzipping the archive will produce the sudirectories doc, os2, and win32. All the documentation for the routines is in the doc subdirectory. The OS/2 and Win32 versions of the routines are in the directories named as such.

To execute any of the TC codes, first install the appropriate run-time library support. Then the routines may be executed by simply typing the name of the routine at a command prompt while in the directory containing the routine. The directory containing the TC codes can also be added to ones PATH environment variable, which will permit the routines to be executed from any directory simply by typing the name of the routine.

See the documentation for the individual routines for specific instructions on how to use the terrain correction codes.