USAGE:
           xchan-units-with-si.pl [opt] file

MAKE IT EASY:
           ln -s xchan-units-with-si.pl  xchan-units

PURPOSE:
           Extracts time and measurement columns from GWR files
           of type A1* A2* G1* (and *.TSF ?)
           and prints to stdout.
           For .GGP files there is a sister script xggp.
           Options that apply identically to xggp are indicated
           by a  `+´-sign below.
                  |
                  V
OPTIONS:
 -c               + Prints an easily readable table of the channels.
 -q               - Like -c, all in one row, no decorations.

 -C cset[,cset..] - units conversion presets:
                    cset = signal:factor  e.g. G1-Sig:-776.0 See remark


 -u               - Do unit conversion (still incomplete)
                    OBS! The temperatures T1-Ext T2-Ext T3-Ext are not
                    of conversion type TDVOhm; the header is wrong about this.
                    Available:
                      factors, He-lvl, SiDiodes-2 -3 -4, Pt100V, TDOhm, TDVOhm

                    Some of these, especially the SiDiodes, are rather sophisticated functions.
                    
                    `factors´ are simple; they can be set once with the -C option,
                    and they can be hard-wired.

 -l                 (letter l, not 1) Prints a long string with all labels.
                    Use
                       eval set labs \= \'`xchan-units -l RAW_o054/A2111210.054`\'
                    to assign to a single set parameter, or
                       set labs = `xchan-units -l RAW_o054/A2111210.054`
                    to assign to an array

 -H c[,c...]      + Prints the header of column c (integer number).
                    Each c may be a range c1..c2

 -N c[,c...]        Prints the channel number for measurement named c.
 
 -x c[,c...]      + The requested channel numbers to retrieve.
                    Each c may be a range c1..c2 See remark
                  - The requested channel names ...; no ranges then!

 -x H             + Print number of channels

 -I #c[,#c...]    - Signal information for specified channel number.
 -S c[,c...]      - Signal information for specified channel name.
                    Verbose mode, no data out.
                    prints   CONVERSION #chn S-name Conversion Units
                    like     CONVERSION 31 T2-Ext TDVOhm Celsius
                    upon xchan-units -S T2-Ext RAW_o054/A1121013.054
                    or   xchan-units -I 31 RAW_o054/A1121013.054


 -m m             + Print only each m'th line
 -n r             + The number of records for output              [100000]
                    A value < 0 will suppress printing;
                    0 doesn't work, "Look at that stupid pe-herl!"
                    (Jagger&Richards)

 -s s             - Skip s records

 -l l             - Output l records (same function as -n but different
                    logic - maybe useful after a differenciated change.

  -v               - Verbose mode, helpul for debug.
 -V               - reduced verbose. Shows selected channels
                    and unit conversions.

Remarks:

 -x  - If any of the  -x channel numbers is beyond the actual range,
       the previous column will be doubled.

 -C  - We have avoided to hard-wire this particular conversion
       since the factor might change and since we might
       like to keep the Volt units but convert the other channels.
       If you want to hard-wire a factor for a particular channel, read here.
EXAMPLES:

  xchan-units -C G1-Sig:-776.0 -u -x 5..8 RAW_o054/A1091107.054 > tmp.dat

retrieves channels 5 6 7 8 and does unit conversion.
Unit conversion would be with a preset factor of 1
(since the measurement file provides no information on factors for
these particular channels).
However, for channel 5 = G1-Sig the calibration factor is imposed.

Result from example
2009 11 07 00 00 00  -278.73291440    -0.08514400     0.00000000    -0.00030520
2009 11 07 00 01 00  -285.36375680    -0.08575440    -0.00030520    -0.00030520
2009 11 07 00 02 00  -246.05221760    -0.08361820    -0.00030520     0.00000000
2009 11 07 00 03 00  -384.35303280    -0.07629390     0.00000000     0.00030520
2009 11 07 00 04 00  -416.32322400    -0.06896970     0.00000000     0.00000000
2009 11 07 00 05 00  -363.75000000    -0.07263180     0.00000000    -0.00030520
...
12345678901234567890123456789012345678901234567890123456789012345678901234567890
         1         2         3         4         5         6         7         8

Convert to mc-binary file using

tslist tmp.dat -A -g'(I4,5I3,f15.0)' -k3 -F1p,e18.10 -C3 -O`label GRAV,VALnms2` file.mc -I
tslist tmp.dat -A -g'(I4,5I3,t35,f15.0)' -k3 -F1p,e18.10 -C3 -O`label MODE,VALnms2` file.mc -I
...

xchan-units -V -x 32..34 -n -1 RAW_o054/A1100301.054
SELECTION REQUESTED: 32 33 34
SELECTION GRANTED:   32 33 34
CONVERSION 32 T2-Ext TDVOhm Celsius
CONVERSION 33 T3-Ext TDVOhm Celsius
CONVERSION 34 Temp-G1 TDVOhm Celsius


xchan-units -H 32..34 -n -1 RAW_o054/A1100301.054
32:T2-Ext 33:T3-Ext 34:Temp-G1


xchan-units -x H RAW_o054/A1100301.054
48


xchan-units -V -x 48,49 -n -1 RAW_o054/A1100301.054                                                           
SELECTION REQUESTED: 48 49
Channel 49 not in file
SELECTION GRANTED:   48 48
CONVERSION 48 RelHum2 factor,1.0 %
CONVERSION 48 RelHum2 factor,1.0 %


xchan-units -V -x 1..48 -n -1 RAW_o054/A1100301.054 | m
SELECTION REQUESTED: 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48
SELECTION GRANTED:   1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48
CONVERSION 1 LHe-Lvl GEPLHe19 %
CONVERSION 2 AGnd factor,1.0 Volts
CONVERSION 3 AD-1 factor,1.0 Volts
CONVERSION 4 AD-2 factor,1.0 Volts
CONVERSION 5 G1-Sig factor,1.0 nm/sec2
CONVERSION 6 G1-Mode factor,1.0 Volts
CONVERSION 7 G2-Sig factor,1.0 nm/sec2
CONVERSION 8 G2-Mode factor,1.0 Volts
CONVERSION 9 Dewr-P PSI_1_1 PSI
CONVERSION 10 GBal-1 factor,1.0 nm/sec2
CONVERSION 11 TX-Pwr POWERV %Power
CONVERSION 12 TX-Bal factor,1.0 Volts
CONVERSION 13 NeckT-1 SiDiode-3 Kelvin
CONVERSION 14 NeckT-2 SiDiode-3 Kelvin
CONVERSION 15 BelyT-3 SiDiode-3 Kelvin
CONVERSION 16 BodyT-4 SiDiode-4 Kelvin
CONVERSION 17 LHeLvl GEPLHe19 %
CONVERSION 18 GBal-2 factor,1.0 nm/sec2
CONVERSION 19 TY-Pwr POWERV %Power
CONVERSION 20 TY-Bal factor,1.0 Volts
CONVERSION 21 Tmp-Bal factor,1.0 Volts
CONVERSION 22 HtrCrnt POWERV %Power
CONVERSION 23 Temp-6K factor,1.0 Volts
CONVERSION 24 Temp-77 factor,1.0 Volts
CONVERSION 25 FB-Mod factor,1.0 Volts
CONVERSION 26 P1GasCl PSI-3000 PSI
CONVERSION 27 P2GasRg PSI-500 PSI
CONVERSION 28 P3CmpHi PSI-500 PSI
CONVERSION 29 P4CmpLo PSI-500 PSI
CONVERSION 30 P5CmpBl PSI-500 PSI
CONVERSION 31 T1-Ext TDVOhm Celsius
CONVERSION 32 T2-Ext TDVOhm Celsius
CONVERSION 33 T3-Ext TDVOhm Celsius
CONVERSION 34 Temp-G1 TDVOhm Celsius
CONVERSION 35 Temp-G2 TDVOhm Celsius
CONVERSION 36 Temp-TX TDVOhm Celsius
CONVERSION 37 Temp-TY TDVOhm Celsius
CONVERSION 38 Temp-TE TDVOhm Celsius
CONVERSION 39 Temp-AX TDVOhm Celsius
CONVERSION 40 Temp-CH TDVOhm Celsius
CONVERSION 41 Temp-Gt PT100V_K Kelvin
CONVERSION 42 Dwr-Htr factor,20.0 mA
CONVERSION 43 Comp-DC factor,1.0 Volts
CONVERSION 44 CH-DC factor,1.0 Volts
CONVERSION 45 Tmpr1 factor,1.0 Celsius
CONVERSION 46 Tmpr2 factor,1.0 Celsius
CONVERSION 47 RelHum1 factor,1.0 %
CONVERSION 48 RelHum2 factor,1.0 %


xchan-units -N Dwr-Htr,Temp-Gt RAW_o054/A1110101.054
41 Temp-Gt
42 Dwr-Htr

xchan-units -N Dwr-Htr,Temp-Gt RAW_o054/A1120101.054
40 Temp-Gt
41 Dwr-Htr
 

ADDING A FACTOR CONVERSION
In ~/TD/xchan-units , a perl script, find the lines below and add a factor scheme like the existing one for Dwr-Htr.
Note: The channel symbol is the one we convert to when GWR has provided one that we don't like
(they called it Dwr_Htr and our software gets upset at underscores; search for Dwr_Htr in the script.)
%conv = (  "T1-Ext" => "TDVOhm",
           "T2-Ext" => "TDVOhm",
           "T3-Ext" => "TDVOhm",
          "Temp-G1" => "TDVOhm",
          "Temp-G2" => "TDVOhm",
          "Temp-TX" => "TDVOhm",
          "Temp-TY" => "TDVOhm",
          "Temp-TE" => "TDVOhm",
          "Temp-AX" => "TDVOhm",
          "Temp-CH" => "TDVOhm",
          "Dwr-Htr" => "factor,0.02"
         );

%units = ( "T1-Ext" => "Celsius",
           "T2-Ext" => "Celsius",
           "T3-Ext" => "Celsius",
          "Temp-G1" => "Celsius",
          "Temp-G2" => "Celsius",
          "Temp-TX" => "Celsius",
          "Temp-TY" => "Celsius",
          "Temp-TE" => "Celsius",
          "Temp-AX" => "Celsius",
          "Temp-CH" => "Celsius",
          "Dwr-Htr" => "mA"
         );

 .bye