tipin1b [ parameter=value ... ]
Parameters are: on_pass_disk, pass_number, tape_device, pass_year, output_tape, tovs_sensor, start_time, num_lines, orbit_number.
tipin1b creates TOVS (TIROS Operational Vertical Sounder) sensor 1B datasets from HRPT telemetry data. Input telemetry data can be read either from the pass disk or from the tape. Output data contains calibration and earth location information. tipin1b generates HIRS and/or MSU datafile(s).
Answer yes if the input is from the pass disk, or no if the input is from tape or standard UNIX disk file.
Valid responses are [yes or no]. The default is yes.
If on_pass_disk=yes, this is the number of the pass to process. Passes are numbered starting with 1.
Valid responses for input from the pass disk are [1 to maximum number of passes that can be stored on your pass disk (see lspass(1))]. The default response is the number of last acquired pass.
If on_pass_disk=no, this is the name of the input tape device or UNIX disk file name. Tape device names are machine specific. For example, the following devices are commonly used on the Sun SPARC Station:
/dev/nwd0 - DAT, fixed blocking, APUNIX driver /dev/nrwd0 - DAT, variable blocking, APUNIX driver /dev/nsx0 - 8mm, fixed blocking, APUNIX driver /dev/nrsx0 - 8mm, variable blocking, APUNIX driver /dev/nrmt - 8mm or CCT, variable blocking, SUN driverAll of the above device names imply no rewind on close.
The default is extracted from the UNIX environment variable TAPE. Only tape devices listed in the file $PASSDIR/devtable, or simple UNIX disk file names, are accepted.
If on_pass_disk=no, this is the year that the pass was collected.
The valid range is [>=1970]. The default is the current year.
This is the name of the output tape device or UNIX disk file.
NOTICE: HIRS and MSU files are written on tape sequentially. If the output is UNIX file, the user still specifies only one name, even if two sensors were selected. The program will append the extensions ".hirs" or ".msu" to each filename, depending on sensor type.
The default is extracted from the UNIX environment variable TAPE. Only tape devices listed in the file $PASSDIR/devtable, or simple UNIX disk files, are accepted.
The sensor data type to be extracted.
The answer can be hirs, msu or both. The default is hirs.
This is the start time for data extraction. The first line with a time greater than start_time is the first output line. A response of 00:00:00 instructs tipin1b to begin processing at the first scan line. NOTE: actual processing starts from the first perfect hirs or msu scan, i.e. scan complying to the hirs or msu scan line format with no extra or missing elements.
Any valid time is allowed (see formats). The default is 00:00:00.
The number of TIP records to be processed. Note that these do not correspond to scan lines. If the end of pass is detected before the output dataset is complete, the output dataset is truncated.
The valid range is [>=1]. The default is 2000.
The satellite revolution number.
The valid value is any non-negative integer number. The default is 0.
This example shows how to retrieve the HIRS data from the most recent HRPT pass on the pass disk.
[1] % tipin1b on_pass_disk : char( 3) ? [yes] pass_number : int ? [1] output_tape : char(255) ? [/dev/ncht0] tovs_sensor : char( 4) ? [hirs] start_time : char( 15) ? [00:00:00] num_lines : int ? [2000] orbit_number : int ? [0] raw pass disk: Processing pass 1 raw pass disk starts at time 16:07:39.263, sample 1. /dev/ncht0 start: noaa-12, 94/03/05 16:07:40.43, record 4256 bytes
The next example shows how to retrieve both HIRS and MSU data from the pass on the tape.
[2] % tipin1b on_pass_disk : char( 3) ? [yes] n tape_device : char(255) ? [/dev/nrht0] pass_year : int ? [1994] output_tape : char(255) ? [/dev/nrht0] out tovs_sensor : char( 4) ? [hirs] hirs msu start_time : char( 15) ? [00:00:00] num_lines : int ? [2000] orbit_number : int ? [0] /dev/nrht0: Processing pass 1 /dev/nrht0: starts at time 16:07:39.263, sample 1. out.hirs: start: noaa-12, 94/03/05 16:07:40.43, record 4256 bytes out.msu: start: noaa-12, 94/03/05 16:07:55.43, record 440 bytes
$SATDATA/satellite/sensor, orbdata, devtable
tipin, tovs, preing, ingtov, tovpre, tovret, filret, winret, tovscdf, hirscdf, tovsproc, avin, avhrr, hrptin
See hrptin NOTES to see the input record formats supported by tipin1b.
Last Update: $Date: 2001/05/16 20:26:59 $