framesx [ parameter=value ... ]
Parameters are: on_pass_disk, tape_device, pass_number, satellite, telemetry, pass_date, start_time, num_records, skip_records, derandomize, reed-solomon
framesx is called by command line or by pre-processing script. framesx reads the telemetry-dependent configuration file, looks for the specified sync code (in $REFDATA/config/FSYNC_PARAMS), and then tries to line up frames by emulating a hardware frame synchronizer. Depending on the telemetry type, reformatting of framed data can also be specified.
With telemetry from the MODIS sensor on the terra or aqua spacecrafts, the output is a .pds file which can readily be ingested by IMAPP or the TeraScan modisin function. With telemetry from the OCM sensor on the oceansat-1 spacecraft, the output is a file which can be ingested by the TeraScan ocmin function.
Answer yes if the input is from the pass disk, or no if the input is from 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.
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 of the pass to process, when input is from tape or the pass disk. Input tape is always assumed to be positioned at the first pass.
Valid responses for input from the pass disk are [1 or 2]. The default response is the number of the last acquired pass.
Valid responses for input from tape are [>=1]. The default response is 1.
If on_pass_disk=no, this is the name of the satellite from which the data was received.
Valid responses are terra-1, aqua-1, oceansat-1, or any valid X-band satellite. UNIX matching characters can also be used (e.g., terra-?).
If on_pass_disk=no, this is the type of telemetry that was received.
Valid responses are teradb, aquadb, or any valid X-band telemetry.
If on_pass_disk=no, this is the date of the pass.
The format for the response is yy/mm/dd.
If on_pass_disk=no, this is the start time of the pass. The first line with a time greater than start_time is the first output line.
Any valid time is allowed. See formats for information on time formats. The default is 00:00:00.
Specifies the number of records acquired after receiver lock.
Valid responses are [>=1]. The default is 4608.
Specifies the number of records to skip.
Valid responses are [>=0]. The default is 0.
Specifies whether data should be derandomized or not.
Valid responses are yes or no. The default is yes.
Specifies whether reed-solomon error correction should be performed or not.
Valid responses are yes or no. The default is no.
% framesx output file(s) : char(255) ? [.] on_pass_disk : char( 3) ? [yes] pass_number : int ? [2] 1 num_records : int ? [4608] 1024 skip_records : int ? [0] derandomize : char( 3) ? [yes] reed-solomon : char( 3) ? [no]
$REFDATA/config/FSYNC_PARAMS
If called by the SeaSpace-provided script do_frame in $PASSDIR/postprocs, framesx outputs to a satellite-dependent subdirectory of /level0 (eg, /level0/Terra).
Last Update: $Date: 2000/11/06 01:00:05 $