NAME

     putsis  - dump numbers into sis trace format

SYNOPSIS

     putsis [ -Ootap ] [ -nsnsamp ] [ -ntntrc ] [ -sinsi  ]  [  [
     -Nntap ] [ -F ] [ -vval ] ] [ -C ] [ -V ] [ -? ]

DESCRIPTION

     putsis reads numbers from input file or stdin or reads in  a
     single  sample  value  then attaches a line header and trace
     header and writes  this  to  a  sis  format  disk  file  (or
     stdout).   Output  will  consist  of  one  record of as many
     traces as specified and each trace with a number of  samples
     equal  to what was read from the input.  utop may be used to
     adjust the header entries.

     putsis gets both its data and its  parameters  from  command
     line  arguments.  These arguments specify the input, output,
     the sample interval, and verbose printout, if desired.

  Command line arguments
     -N ntap
          Enter the input data set name or file immediately after
          typing -N unless the input is from a pipe in which case
          the -N entry must be omitted. This is used to bring  in
          a series of sample values. For single sample option see
          below.  This input file  should  include  the  complete
          path name if the file resides in a different directory.
          Example -N/b/vsp/dummy tells the program  to  look  for
          file 'dummy' in directory '/b/vsp'.

     -O otap
          Enter the output data  set  name  or  file  immediately
          after typing -O.  This output file is not required when
          piping the output to another process.  The output  data
          set also requires the full path name (see above).

     -ns nsamp
          Input and output  number  of  samples.   This  must  be
          specified.

     -nt ntrc
          Input number of traces.   This  must  be  specified  so
          putsis knows how many samples to read from the input to
          generate the traces.

     -si nsi
          Optional  sample  interval  to  put  in  line   header.
          Default = 1

     -C   Enter the command line argument  '-C'  to  specify  the
          input  format  is  in column order, i.e. each column of
          the input will correspond to a  trace  on  output.  The
          default  is  to  assume  that the trace samples are one
          after another in a single column. The number of columns
          must  be  less  than  or  equal to the number of traces
          asked for in -nt[].

     -V   Enter the command line argument '-V' to get  additional
          printout.

     -F   Enter the command line argument '-F' to input a  single
          sample  value.   Useful for building constant velue USP
          traces.

     -v val
          Enter sample value. Default = 0.0

     -V   Enter the command line argument '-V' to get  additional
          printout.

     -?   Enter the command line  argument  '-?'  to  get  online
          help.   The program terminates after the help screen is
          printed.

EXAMPLE

     1. The command line

          echo "1 2 3 4 5 6 7 8 9 10" | putsis -Ojunk -ns10 -nt1

     will put the ten numbers from stdin into an sis trace format
     file  with  1  record  of  1 trace with 5 samples and sample
     interval of 1. To get say 2 traces each with 5  samples  you
     will  have  to build a file with two lines: the first with 5
     numbers and the second with 5 more, e.g.  suppose  the  file
     "indata" looked like

     0 1 2 3 4

     5 6 7 8 9

     putsis -Nindata -Ojunk -ns5 -nt2

     will output 2 traces each with 5 samples.

     2. The command line
     putsis -v1480 -Oveltrace -nt1 -ns2001 -si4 -F

     will output a single trace of  2001  samples  all  having  a
     value of 1480

BUGS

     unknown

AUTHOR

     Paul Gutowski, APR x3146

COPYRIGHT

     copyright 2001, Amoco Production Company
               All Rights Reserved
          an affiliate of BP America Inc.