Scripting Aids and other TeraScan Functions
Scripting Aids
count - Determines the number of variable values meeting a given criteria, and prints that number to UNIX stdout. The number can be reported in one of three ways: count, percent of the total number of values, or percent of the number of good values. Percents are rounded to the nearest integer.
diskhogs - Removes the oldest files matching a given wildcard expression until the disk space occupied by all matching files no longer exceeds a given threshold. Maximum file count and file age criteria are optionally supported; matching files are removed until all criteria are met. File age is determined either by the last modify time, or by the pass_date and start_time dataset attributes. The dry_run parameter allows the user to see what files would be deleted without actually deleting them.
getconfig  - Scripting tool that reads settings from $PASSDIR/system.config.
smath - Shell scripting tool that allows shell scripts to do real valued arithmetic.
logrun - Post-process logging tool.
nearestfile - Finds nearest qualified files and report to UNIX stdout.
testcover - Tests the percent a given master area is covered by a specified input dataset variable.
timediff - Computes the time difference between two TeraScan datasets or one TeraScan dataset and a user specified date and time.
tsargs - Processes TeraScan style argument lists in C-shell scripts.
tsdate - Writes date difference or converted date to UNIX stdout.
tsparams - Processs TeraScan style argument lists in C-shell scripts.
varnames - Lists dataset variables to UNIX stdout, so it can be captured in shell variables as part of a shell script.

In the Useful section we have:
copydimvars - Copies dimension variables from an input dataset to an output dataset.  The most common examples of dimension variables are elevation variables such as those found in TOVS, SSMT1 and SSMT2 datasets.
doppsat - Reports the satellite down- and uplink doppler shifts, down- and uplink frequencies, elevation, azimuth, and doppler speed for a given receiver and specified times.
datename - Outputs a TeraScan-like pass filename from date, time, and satellite input parameters. This function is useful for naming the output filenames produced within processing scripts.
deflate and inflate are two very unusual functions for working with piped serialized variable data. Currently, only two ingesters, hrptin and metin have options that allow variable data to be serialized and piped to UNIX stdout. deflate and inflate are provided as a mechanism for efficiently transferring ingested datasets from a reception machine to a remote processing machine over a low-bandwidth network.
dumpvar - Dumps variable data in ASCII. Unlike printvar, which outputs scaled data, dumpvar outputs unscaled data, e.g., data exactly as it is stored.
hatch - Converts a given 2-D numeric variable into a cross-hatched faxable image. The variable is divided into areas in a manner similar to contouring. Unlike contouring, areas are determined by their central values. Each area is then filled with a cross-hatch pattern.

Last Update: $Date: 2002/02/09 03:05:02 $