NAME

     compusp - read two USP data files and display selected  sam-
     ples side-by-side.

SYNOPSIS

     compusp  -Afile1  -Bfile2  [-Oofile]  [-BSismp1]  [-ESismp2]
     [-BTitrc1]   [-ETitrc2]   [-BRirec1]  [-ERirec2]  [-OSnsoff]
     [-OTntoff]  [-ORnroff]  [-EPSAepsa]   [-EPSRepsr]   [-LHEAD]
     [-TRHEAD] [-h -?]  [-V]

DESCRIPTION

     compusp compares two USP data files, which need not be  con-
     formal;  i.e.,  they  may have different numbers of samples,
     traces, and records.  The second data  file  may  be  offset
     from  the  second  in  all  three  variables (sample, trace,
     record),    by    use    of    the     offset     parameters
     nsoff, ntoff, nroff.

     Its default use is:

          compusp -Afile1 -Bfile2

     which gives statistics (on stdout) for the entire  conformal
     overlap  of  the  two files, summarizing for each record. In
     the case where file1 and file2 are the  same  file,  compusp
     can  be used to scan the contents of a USP data file through
     judicious use of the input parameters -EPSA and -EPSR .


  Command line arguments
     -Afile1
          Enter the first input data set name  immediately  after
          typing -A.  This input file should include the complete
          or relative path name if the file resides in  a  direc-
          tory other than the current one. This file may not be a
          pipe.


     -Bfile2
          Enter the second input data set name immediately  after
          typing -B.  This input file should include the complete
          or relative path name if the file resides in  a  direc-
          tory  other than the current one.  This file may not be
          a pipe.


     -Oofile
          Enter the name of the file to which  output  should  be
          sent.  Default is stdout.


     -BSismp1
          Enter the  first  sample  to  process  in  file1.   The
          default is the first sample.


     -ESismp2
          Enter the last sample to process in file1.  The default
          is the last sample.


     -BTitrc1
          Enter the first trace to process in file1.  The default
          is the first trace.


     -ETitrc2
          Enter the last trace to process in file1.  The  default
          is the last trace.


     -BRirec1
          Enter the  first  record  to  process  in  file1.   The
          default is the first record.


     -ERirec2
          Enter the last record to process in file1.  The default
          is the last record.


     -OSnsoff
          Enter the sample offset  for  file2.   Processing  will
          begin with sample ismp1 + nsoff in file2.


     -OTntoff
          Enter the trace  offset  for  file2.   Processing  will
          begin with trace itrc1 + ntoff in file2.


     -ORnroff
          Enter the record offset  for  file2.   Processing  will
          begin with record irec1 + nroff in file2.


     -EPSAepsa
          Enter the absolute difference threshold parameter epsa.
          If  the  absolute difference between samples in the two
          files exceeds epsa, a side by side  comparison  of  the
          two  files is given, printing out relative and absolute
          differences for each sample, for any samples where  the
          threshold   is  exceeded.   The  difference  statistics
          reported are:

               absolute difference = (v1-v2)
               relative difference = (v1-v2) / ( (v1+v2)/2 )



     -EPSRepsr
          Enter the relative difference threshold parameter epsr.
          If  the  relative difference between samples in the two
          files exceeds epsr, a side by side  comparison  of  the
          two  files is given, printing out relative and absolute
          differences for each sample, for any samples where  the
          threshold   is   exceeded.  The  difference  statistics
          reported are:

               absolute difference = (v1-v2)
               relative difference = (v1-v2) / ( (v1+v2)/2 )


          Averages are reported as are the maximum  absolute  and
          relative differences.


     -LHEAD
          If this is specified, the  line  headers  are  compared
          field by field, and any differences are printed out.


     -TRHEAD
          If this is specified, trace headers are compared  field
          by field, except when the offsets are non-zero. Printed
          out are the identifying  string  and  and  the  varying
          values.  (It  is poorly assumed all trace header fields
          are integer*2.)


     -h -?
          Enter either of these keys for online help.   The  pro-
          gram will terminate after printing this.


     -V   Enter this option for more verbose output.

EXAMPLES

     The command:

          compusp -Afile0.usp -B/tmp/file0.usp -Ocomp.out -OR3 -V

     compares files  file0.usp and /tmp/file0.usp  starting  with
     record  1  in  file0.usp  and record 4 in /tmp/file0.usp and
     places its output in  file  comp.out.   If  there  are  more
     records  in  file0.usp  than  the  number  of records - 3 in
     /tmp/file0.usp, the remaining records are ignored.

BUGS

     None known.

AUTHOR

     J. Cooperstein, Axian Inc.

COPYRIGHT

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