getest [ inputfile ... directory ] There are no parameters.
getest processes raw RDS/SDS frames in .est datasets created by rdsin, and writes the resulting EST (Equipment Status Telemetry) records to corresponding output datasets.
EST data is contained in the LS-mode frames between and including the LS-mode subsync and LS-mode linesync frames. These frames are collected by rdsin and stored in datasets with the .est suffix. An output EST record is generated from each sequence of LS-mode frames:
subsync frame / frame / ... / frame / linesync frame
In addition to the actual EST data (est_data), the following per record information is extracted by getest:
est_size - number of words in each record, should be <= 61 est-lost - data loss caused by overflow, 1 if loss, 0 otherwise est_time - time in seconds extracted from the subsync frame
EST data words are 14-bit each, and stored as 16-bit short integers. Time is stored as double precision real numbers. Number of words and the data loss flag are stored as 8-bit byte integers.
The following output was produced by first running getest, followed by contents. Note the names, datatypes and sizes of each of the four output variables.
% getest f13.95234.0456.est test.est f13.95234.0456.est: 796 complete, 1 incomplete records found % contents test.est printout : char( 3) ? [no] Contents of File: test.est Page 1 Dimension Size Coord Scale Offset est_records 796 ? 1 0 est_words 74 ? 1 0 Attribute Type Units Value telemetry string3 sds pass_date long std_date 95/08/22 start_time double std_time 04:56:22.936 satellite string12 f-13 history byte Variable Type Units est_size byte est_lost byte est_time double seconds est_data short Variable Dimension Size est_size est_records 796 est_lost est_records 796 est_time est_records 796 est_data est_records 796 est_data est_words 74 Variable BadValue ValidMin ValidMax Scale Offset est_size 255 0 255 1 0 est_lost 255 0 255 1 0 est_time -3.4028e+38 -1.7977e+308 1.7977e+308 1 0 est_data -32768 -32768 32767 1 0
There currently is no TeraScan function that decodes EST data into fields. The bitfields and dumpvar generic functions are recommended for exploring the values contained within EST data records.
The theoretical maximum number of EST words per record is 61. According to original documentation, there should only be 4 LS-mode frames between each LS-mode subsync and LS-mode linesync frames; the 61 14-bit EST words are formed from one 7-bit byte from the subsync frame, 26 7-bit bytes from each of the intervening frames, and 17 7-bit bytes in the linesync frame. In reality, there are often 5 intervening frames, raising the possible maximum number of 14-bit EST words to 74 = (1 + 5*26 + 17)/2. The number of words field in the linesync frame is only 6 bits, so it cannot exceed 63.
Last Update: $Date: 1998/05/29 17:24:41 $