Usage:         tslist filename [option]

 Reads binary time-series data (even MC) and lists to stdout, time by default given
 in decimal years.
 Alt. reads ASCII time series using ReadFmD
 Can call tsfedit



 
 Option        meaning                                                     [default]
-------------------------------------------------------------------------------------
  -I         - print protocol information only. Else: protocol and time-
               series. To strip protocol, pipe to fgrep -v '>'
  -t[ttext]  - "Ticks" -  print range and tick information for GMT.
               String ttext may indicate:
                  minx,maxx[/miny,maxy][ftext]
               where the numbers control the minimum and maximum
               number of labeled ticks on each axis.
               String ftext may indicate
                  f:nx,ny or fx:nx or fy:ny
               where the numbers nx and ny indicate fixed amounts
               of unlabeled tick intervals (INTERVALS!)
               -t implies -I and -qq (stop before copy to STDOUT, quiet)
  -qs[s]     - query first (s=f) and last (s=l) file date.
  -qq        - quiet (suppress normal messages on protocoll)

 OUTPUT OPTIONS
  -S#        - multiply time series with scale value.                              [1]
  -Fcode     - format code for numeric field, used for output.                  [f8.5]
  -Tcode     - format code for time field, used for output.
               If code(1:1) needs to be Z, use \Z                               [f8.5]
  -N[code]   - Out time record is ordinal number. Format code
               may indicate integer or floating point real.
  -Y#        - offset by this value.                                               [0]
  -M#        - define missing record symbol.                                [internal]
  -B[s]date  - set beginning epoch. Default=first date on file.
               fix against epoch (s=f), cut at epoch (s=c).
               Default=no fix, no cut.
               Format for date is yyyy,mm,dd
  -H#        - fix or cut against number of hours from epoch.                      [0]
  -Un#       - truncate after this many samples.                              [at EOF]
  -U#,#,#[,#]- truncate at this date + hour.                                   [don't]
  -D[fmt]    - remove DC-level. The value is printed with
               format fmt                                                   [1p,d13.4]
  -i[y00]    - Out time record is t0+n*dt (from file) instead
               of decimal year. Subtract y00 from time.                        [0.0d0]
  -J[fmt]    - time record is Mod.Julian date. fmt format code.                [f13.6]
  -JX[fmt]   - Exact (mod.) Julian dates; they start at noon.
  -C[#]      - add date in Calendar form, -k# determines output khms
  -Q         - Fail if an error is encountered, else continue.
               (Not fully implemented yet, but works with -E)

  -ofilename - binary output file.
  -O[:label ]filename  - binary output file, append.

 INPUT OPTIONS
  -ffilename - A way to specify a file name late on the line.
  -f filename  will also work.
  -          - no file; input ascii from STDIN

  -Lcode     - Process MC-data. Code specifies location string.
               Specify -L' '  to obtain a list of the location codes
               of the file. More explanations in ~/sas/p/ufios.f
               integer function loc_getts_mc
  -Rp,t0,dt  - Resample. p is interpolation polynomial order,
               t0 is time-shift [h], dt is new time step [h].
  -E[file][,target]option] - tsf-edit commands are read from file.
               cf  ~/sas/p/tsfedit.f                                     [tslist.tse,TSLIST]]

  ASCII INPUT OPTIONS
  -A         - ascii data.                                                                                                                          [binary]
  -Acode     - target string (cf /sas/readfmd.f parameter trg).                  [none]
  -s#        - skip the first #n records of an ascii file                           [0]
  -atarget   - initial move to a file location; target may occur
               anywhere on the line.                                                                                                           [none]
  -ecode     - end-of-file target string.
  -gcode     - format code for input.                                ['(i4,3i3,f10.0)']
  -dcode     - date format for converted string (months 3-letter code
               converted to numeric form), after conversion.             ['(i4,i3,i2)']
     -TZ#       - The ITZ (time-zone) parameter. Floating-point values can
               be specified.                                                        [0]
  -k#        - read_fm_d parameter khms (1..4) indicating
               hour minute second frac.sec. record depth.                           [1]
  -y         - For input=decimal years, -g'(f...,)' needed.
  -v         - Time duplicates are dropped. Default is that they replace the
               sample previously read in.
  -0t0 -rdt  - t0 (first sample time offset) and dt (sampling interval)
               -r is ident. -1                                              [.0d0,.0d0]
  -zmrs      - missing-record symbol.                                      [-99999.0d0]


 Examples:

 (1) formatted data, decimal years (*.ep):

   tslist $DDIR/ONSA.gd.ep -g'(1x,f11.6,t13,f10.3)Y:1992' -k0 -C1 -Ff12.2 -012 -r24
 
     the last two options -0time and -rrate may be necessary if some of the first three
     samples are missing. The -C1 option requests printing of calendar form width+1, i.e.
     year month day hour

 (2) formatted data, (nearly-)free format input of records like
 1997 sep 17 14 00 00 1.23456

   tslist data.tsf -A -k3 -g'*a11)' -J -Etest.tse,TEST]

 while test.tse may look like
 TSF EDIT TEST
 DELETE At 1997 09 17 15 0 0 0
 END
 

Where are we ?

Get a golden badge