hrptjwa [ parameter=value ... ] [ outputfile ... ] hrptjwa [ parameter=value ... ] [ directory ]
Parameters are: on_pass_disk, tape_device, pass_number, files_per_pass, pass_year, tbus_file, use_master, master_file, start_time, num_lines, bogus_lines, hrpt_format.
hrptjwa creates datasets in JWA format from HRPT telemetry data. Input telemetry data can be read from the pass disk, tape, or standard UNIX disk files. Multiple passes on tape or the pass disk can be processed at once.
The ouput data can be spatially subsampled. The overall spatial subset of data to be extracted can be specified in one of two ways:
1) the smallest number of scan lines required to cover a region defined by a master dataset. 2) scan lines range defined by start time and number of lines.
There are no input TeraScan datasets. The sources for input telemetry data are described above. Output is either to a user supplied directory or a user-supplied list of dataset names. If a directory name is entered, output names will be automatically generated and the files will reside in the specified directory. Names will be generated that look like n#.yyddd.hhmm, where # is the NOAA satellite number, yyddd is the year and julian date, and hhmm is the start hour and minute of the output dataset.
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=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/ncht0 - HP DAT, fixed blocking, compressed, APUNIX driver /dev/nrht0 - HP DAT, variable blocking, APUNIX driver /dev/nsx0 - Exabyte 8mm, fixed blocking, APUNIX driver /dev/nrsx0 - Exabyte 8mm, variable blocking, APUNIX driver /dev/rmt/0n - Sun or HP DAT, variable blockingAll 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.
This specifies the number(s) of the pass(es) to process, when input is from tape or the pass disk. Passes are numbered starting with 1. Input tape is always assumed to be positioned at the first pass.
Valid responses for input from the pass disk are [1 - number of pass partitions]. The default response is the number of the last acquired pass.
Valid responses for input from tape are [1 to 100]. The default response is 1.
If input is from tape, this is the number of tape files per pass. If files_per_pass=2, then each pass is assumed to consist of a header file, followed by a data file. If files_per_pass=1, then the tape is assumed not to have any header files.
Valid responses are [1 or 2]. The default response is 2.
If on_pass_disk=no, this is the year that the pass was collected. All passes processed in one execution of hrptjwa must have the same year.
The valid range is [>=1970]. The default is [current year].
The name of the text file with TBUS elements.
There is no default.
Answer yes if the data is to be selected from the intersection of a master dataset (number 1 in the description above, also see master). Answer no if subsets are to be specified by start time and number of lines.
Valid responses are [yes or no]. The default is yes.
If use_master=yes, this is the name of the master dataset used to specify a region for data extraction (see master).
Valid responses are any TeraScan dataset that contains an earth transform. The default is Master.
If use_master=no, 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 hrptjwa to begin processing at the first scan line.
Any valid time is allowed (see formats). The default is 00:00:00.
If use_master=no, this is the number of lines written to the output dataset. num_lines input lines will be processed to produce an output dataset. 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 5500.
OPTIONAL. This parameter defines the number of lines to skip when beginning to process a pass. This is used when initial pass lines contain deceiving date and time codes; e.g., when passes from two different satellites were accidentally concatenated during capture. This option is rarely needed.
The valid range is [>=0]. The default is 0. This parameter must be explicitly specified on the command line.
OPTIONAL. This parameter defines the format of the raw telemetry to be read. See hrptin NOTES for a list of these formats.
The default is auto, which stands for auto-sensing. This parameter must be explicitly specified on the command line.
Create JWA dataset from the pass archived on tape. The area for data selection is specified by a master dataset.
[1] % hrptjwa output file(s) : char(255) ? [.] on_pass_disk : char( 3) ? [yes] no tape_device : char(255) ? [/dev/nwd0] pass_number : int (100) ? [1] 2 files_per_pass : int ? [2] pass_year : int ? [1995] tbus_file : char(255) ? tbus.951018 use_master : char( 3) ? [yes] master_file : char(255) ? [Master] Processing tape file 2 Actual size is 944 lines by 2048 samples. 101838 NOAA 14 PART I 04122 01813 05858 00314 T0204 L2551 PART IV 1994 089A 04114 291015551112 951018002223616 0316289 01020143 01020729 00090175 20770132 23262352 09891308 15237549 07229438 M043956019 M057541057 P000000001
$SATDATA/satellite/sensor, orbdata, devtable
avhrr, datasets, formats, etx, hrptin, gac, lac, master.
hrptjwa can read all record formats described in hrptin.
Last Update: $Date: 2002/05/07 23:21:18 $