CRaTER -- tsv


tsv -- Generate tab-separated-value listing of CRaTER data


    tsv [-c[alcurve] [-f[orce]] [-h[elp]] [-v[erbose]] \
        arg1 [arg2 arg3 ... argn]


    -b   blindly use CCSDS sequence numbers, not time, for index
    -c   output only engineering value from calcurve pipe
    -f   force acceptance of all args; do not validate
    -h   displays help message
    -v   specifies verbose operation and extended help message


Header mnemonics

    SeqCount         Packet sequence count
    SerialNumber     Instrument serial number
    TestMode         Instrument in Test Mode
    OneHertz         Observatory 1 Hz clock
    Time             Observatory time in seconds
    EventAmp         Primary science mnemonic

Secondary science mnemonics

    BiasCntrl        Detector bias delayed command
    BiasCmd          Detector bias initial command
    CalLow           Low range detector calibration command
    CalHigh          High range detector calibration command
    ProcD1           Process detector D1
    ProcD2           Process detector D2
    ProcD3           Process detector D3
    ProcD4           Process detector D4
    ProcD5           Process detector D5
    ProcD6           Process detector D6
    LastCmd          Application ID of last command sent
    LastValue        Value of last command sent
    DiscThin         Current Low Level Discriminator command for D1,D3,D5
    DiscThick        Current Low Level Discriminator command for D2,D4,D6
    Mask             Most significant 16 bits of discriminator mask
    Mask2            next 16 bits of discriminator mask
    Mask3            next 16 bits of discriminator mask
    Mask4            Least significant 16 bits of discriminator mask
    Single1          Detector D1 singles rate
    Single2          Detector D2 singles rate
    Single3          Detector D3 singles rate
    Single4          Detector D4 singles rate
    Single5          Detector D5 singles rate
    Single6          Detector D6 singles rate
    Good             Good event rate
    Reject           Rejected event rate
    Total            Total detected event rate

Housekeeping Mnemonics

    V28bus           28VDC input bus voltage
    V5digital        5VDC regulated digital voltage
    V5plus           5VDC regulated analog voltage
    V5neg            -5VDC regulated analog voltage
    I28bus           28VDC input bus current
    BiasCurrentD1    Detector D1 bias current
    BiasCurrentD2    Detector D2 bias current
    BiasCurrentD3    Detector D3 bias current
    BiasCurrentD4    Detector D4 bias current
    BiasCurrentD5    Detector D5 bias current
    BiasCurrentD6    Detector D6 bias current
    BiasVoltThin     Bias Voltage for Detectors D1,D3,D5
    BiasVoltThick    Bias Voltage for Detectors D2,D4,D6
    CalAmp           Detector calibration voltage amplitude
    LLDThin          Low Level Discrimator voltage for D1,D3,D5
    LLDThick         Low Level Discrimator voltage for D2,D4,D6
    Ttelescope       Temperature of telescope assembly
    Tanalog          Temperature of analog board
    Tdigital         Temperature of digital board
    Tpower           Temperature of regulated power supply
    Tref             Temperature of internal bulkhead
    RadHighSens      High Sensitivity radiation counter
    RadMedSens       Medium Sensitivity radiation counter
    RadLowSens       Low Sensitivity radiation counter
    Tprt             Temperature of bulkhead PRT
    Purge            Purge gas flow rate


The program accepts an ASCII data stream, normally the piped output of rtlm, and generates a series of tab-separated-value lines. Each line has, as its first argument the time in LRO-standard seconds. Each subsequent argument is tha value of the mnemonic specified in the command line. If at least one mnemonic from the housekeeping packet is given, the output will be generated only as often as housekeeping packets appear in the data stream (nominally once every 16 seconds).

If a mnemonic appears in the data stream more often than once per second, its value will appear multiple times on the same (one second) line. To defeat this behaviour, invoke the -u flag.

Each mnemonic argument given is checked against the list of valid rtlm mnemonics given above. To force acceptance of a non-standard mnemonic, use the -f flag. If used, the -f flag must appear before the mnemonic argument list.

Housekeeping packets are corrupted if the instrument received a SYSTEM RESET during the interval in which the data was collected. This program filters out the entire packet in this event.



High Level programs

Low Level programs

rtlm, calcurve


Bob Goeke

RCS Information

$Id: tsv,v 1.5 2008/11/24 18:49:08 goeke Exp goeke $