tslist-app man page


USAGE:

         tslist-app [-test] [-over] [-ib <tsi>] [-ie <tsi>] \     <- in this order!
                    tslist-options  \

                    [++ late-options] \
                    + file [-Llabel] [file [-Llabel] ...]
 
PURPOSE:
         append BIN ts files

         The first file right of the + sign is used as the
         primary input file to tslist
 
         A file tmp.tse will be created containing the
         TSF-EDIT commands for appending the other files.
 
OPTIONS (in this order!):
 -test               - Show the command and the tse-file produced.

 -over               - The later file overwrites the previous.

 -dc-adjust [#width] - Adjust DC-levels to match inside overlap.
                       A relative width is a number between 0 and 1,
                       default=1

 -shorten #n         - Before each appending, chop n samples
                       off the end of the series collected so far.
                       Helps to get rid of transients; don't use
                       it with -over ! Series must overlap, of course.

 -trunc "<where>"    - Issue command TRUNC <where> after the last
                       file has been appended.
                       <where> could contain an `At´-expression,
                       see tsfedit.html for time-range and TRUNC

 -ib <tsi> -ie <tsi
                     - include tsf-edit codelets at the beginning and at the end
                       of the tmp.tse-file produced.
                       You can e.g. edit out transients (APPENDDEL #nb #ne )
 

ENVIRONMENT:
         The file processing command in the tsf-edit file
         includes ${TSAPP_ROPT} last on the line.
         To e.g. remove a DC-level, setenv TSAPP_ROPT DC-
 
TSLIST-OPTIONS:
 -I      - recommended
 -Llabel - requested column of labeled files; remains the
           same in the entire set of input files unless
           other labels are specified in the set of files
 
           Reasonable to specify: -I -o out.ts
           -SO#value  - for scaling the output
 
"LATE OPTIONS":
 
         The options up to `+´ (except -test and -over) are passed to tslist
         and placed before the internally generated tsf-edit option,
         the one that invokes the appending process.

         The options between `++´ and `+´ are passed over to tslist
         and placed after the internally generated tsf-edit append option.
 
         Thus, if tsf-edit actions are to be applied on the
         the result file, place them between ++ and +
 
EXAMPLES:

(1)

  cd ~/Seismo/gcf
  tslist-app -O:`label SV,Z` d/tmp.mc -I +         \
     G2011.166/GCF.2011:166:00:[2-5]0:00.3U93Z2.ts \
     G2011.166/GCF.2011:166:0[1-9]:*.3U93Z2.ts     \
     G2011.166/GCF.2011:166:1[0-1]:*.3U93Z2.ts     \
     G2011.166/GCF.2011:166:12:00:00.3U93Z2.ts
 
will generate
  tslist G2011.166/GCF.2011:166:00:20:00.3U93Z2.ts \
         -O:SV_____________Z d/tmp.mc -I -Etmp.tse,A

(2)

  tslist-app -LZ -I -o appended.ts + \
     G2015.035/*00.3U93ENZ2-1Hz.mc \
     G2015.036/GCF.2015:036:00:00:00.3U93ENZ2-1Hz.mc
 
will append over a day boundary. To run in a loop:
     foreach d ( `fromto 35 47` )
        set dd=`calc -f "%3.3i" $d` nd=`calc -f "%3.3i" $d +1`
        tslist-app -LZ -I -o G2015.$dd/GCF.2015:${d}:00:00:00.Z-24h-1Hz.ts + G2015.$dd/*00:00.3U93ENZ2-1Hz.mc \
                G2015.$nd/GCF.2015:${nd}:00:00:00.3U93ENZ2-1Hz.mc
     end

(3)

  cd ~/TD
  rm d/g090701-140131-1h.mc
  tslist-app -O:`label GRAV,VAL` d/g090701-140131-1h.mc -LG -I \
            + d/g090701-130515-1h.mc d/g130516-140131-1h.mc
 
  tslist-app -O:`label BARO,VAL` d/g090701-140131-1h.mc -LB -I \
            + d/g090701-130515-1h.mc d/g130516-140131-1h.mc
 
will extend a measurement file with Gravity and Barometer for tide analysis.

(4)
  tslist-app -SO10. -I -o OSLVL-120929-140224-1h.ts \
             ++ -Erepair.tse,R \
             + OSLVL2012-1h.ts OSLVL2013-1h.ts OSLVL2014-1h.ts
 
will apply the repair.tse commands on the result of appending.

(5)
  setenv DECIMATE "DECISYNC 3600 100 0"
  setenv LOOPLENGTH 10800
  tslist-app -trunc N-75600 -U2018,7,3,0,48,20 -I -o tmp/glpf.ts
\
           ++ -E fastlpf.tse,L + ~/TD/d/G1_garb_18070[1-2]-1s.mc

will input the last file truncated to contain three segments to process in the LOOP with an FFT-filter. We can
create a long time series filtered this way looping the tslist-app command and collecting overlapping
daily files at the end (note the larger overlap - maybe it can be shortened):

(6)
set f = ~/TD/d/G1_garb_180701-1s.mc
foreach i ( 1 2 3 )
  set fn = `nextfile $f`
  tslist-app -trunc N-60000 -I -o tmp/glpf-$i.ts \
           ++ -E fastlpf.tse,L + $f $fn
  set f = $fn
end
setenv TSAPP_ROPT XF=AUTO
tslist-app -dc-adjust -I -o tmp/G1_g_180701-180703-100s.ts \
           + tmp/glpf-[1-3].ts
(7)
tslist-app -I -o likeg/Z1_a_220224-1s.ts \
           ++ -D -BHc2022,02,24,00,00,00 -Un86400 \
            + G2022.053/GCF.2022:053:23:00:00.3U93Z2-LIKEG-1Hz.ts
\
              G2022.054/GCF.2022:054:00:00:00.3U93Z2-LIKEG-1Hz.ts \
              G2022.054/GCF.2022:054:01:00:00.3U93Z2-LIKEG-1Hz.ts \
...
the tse-file generated (./tmp.tse):
TSF EDIT A
OPEN 41 ^ G2022.054/GCF.2022:054:00:00:00.3U93Z2-LIKEG-1Hz.ts
41, 'BIN]',-99999.0,'U', 0,   0,  'A',  1.d0 ${TSAPP_ROPT}
CLOSE 41
OPEN 41 ^ G2022.054/GCF.2022:054:01:00:00.3U93Z2-LIKEG-1Hz.ts
41, 'BIN]',-99999.0,'U', 0,   0,  'A',  1.d0 ${TSAPP_ROPT}
CLOSE 41

...
See tsfedit.html for options

.bye