tscan.login - Sets up TeraScan user, pass, reference data, and satellite data environments

Description

tscan.login defines the environment variables that describe the TeraScan software as installed. This file should be sourced by the user's .login file in order to run TeraScan functions. tscan.login is normally maintained in the TeraScan pass directory ($PASSDIR).

The following directory environment variables are defined:

TSCANROOT

TeraScan software root directory. TeraScan binary, library, include, and man page directories are assumed to be subdirectories of $TSCANROOT.

REFDATA

TeraScan reference data directory. This directory contains a number of databases required by TeraScan functions, such as coastlines, topography, and color palettes. Normally this directory is a subdirectory of $TSCANROOT. However, due to the size of some of the databases, $REFDATA may be moved to another file system.

SATDATA

TeraScan satellite data directory. This directory primarily contains per-satellite ephemeris and sensor definitions. It normally is a subdirectory of $REFDATA. But because it grows with addition of daily updates of satellite ephemeris, $SATDATA may be moved to another file system.

PASSDIR

TeraScan pass data directory. This directory contains files related to scheduling, receiving, and archiving satellite data, as well as site-specific information. It normally is a subdirectory of TSCANROOT. However, because it grows with the daily addition of satellite pass archive records, $PASSDIR may be moved to another file system.

PATH

The user's command execution path. $TSCANROOT/bin and PASSDIR/postprocs are appended to the user's previously defined $PATH.

The following environment variables defined in tscan.login apply to both processing-only and pass-receiving TeraScan systems:

SESSIONLOG

A log file containing the user's interaction with TeraScan command line functions. Normally this file is $HOME/SESSIONLOG. If SESSIONLOG is not defined, or if it is set to /dev/null, then session logging is disabled.

TAPE

The default archive device. This should be a no-rewind tape device, and should have a corresponding entry in the file $PASSDIR/devtable. The default varies from one machine type to the next. Under Solaris, TAPE is typically set to /dev/rmt/0n. For machines using APUNIX HP DAT drivers, TAPE is typically set to /dev/ncht0 or /dev/nrht0.

ORBDATEDIFF

Maximum acceptable age for satellite orbital elements. Orbital elements older than ORBDATEDIFF days will not be used to calculate satellite earth location. In TeraScan releases after 2.6, this check will simply generate a warning as opposed to forcing satellite earth location to fail. The default ORBDATADIFF is 30 days.

SEE ALSO

terascan, tscan.rc.local, systemclock.


Last Update: $Date: 2000/03/16 22:02:22 $