NAME

     resorter  - resort on the fly between records & traces; fill
     3D volume

SYNOPSIS

     resorter [ -Nntap ] [ -Ootap ] [ -nsnstr ]  [  -nenetr  ]  [
     -rsnrst  ]  [  -renred  ]  [ -lbnlb ] [ -fdslice ] [ -D3 ] [
     -liminlimin ] [ -limaxlimax ] [ -lidellidel ] [  -dimindimin
     ] [ -dimaxdimax ] [ -dideldidel ] [ -S ] [ -V ] [ -? ]

DESCRIPTION

     resorter will (1) exchange  sequential  records  and  traces
     (i.e.  output all the trace 1s followed by all the trace 2s,
     etc), or (2) sort on the fly into trace order (i.e. traces 1
     ->  N  for   the  first record, etc).  It does not require a
     presort table and hence can be piped into but NOT out of. In
     3D  mode you specify a range of lines (LIs) and traces (DIs)
     and their increments to define a 3D volume and its numbering
     scheme.   The  RecNum  and  TrcNum header words of the input
     data are read and using these values the trace  is  sent  to
     its proper cell in the volume.

     resorter gets both its data and its parameters from  command
     line  arguments.  These arguments specify the input, output,
     the design window, the start and  end  traces,  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 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.  Piping of output is not allowed.

     -ns nstr
          Enter the start trace number.  The default is the first
          trace of the record.

     -ne netr
          Enter the end trace number. The  default  is  the  last
          trace of the record.

     -rs nrst
          Enter start record number.  Default value is the  first
          record.

     -re nred
          Enter end record number.  Default value is last record.

     -lb nlb
          Enter end input/output trace blocking length.   Default
          value  is  one  (1).  This is for data that has another
          dimension to it in addition to records and  traces.  An
          example  might be data that is organized into N records
          each with M traces, which are themselves comprised of 3
          component  data. In this case the blocking length would
          be 3.

     -D3  Enter the command line argument '-D3' for 3D  mode:  in
          3D  mode  you specify a range of lines (LIs) and traces
          (DIs) and their increments to define a  3D  volume  and
          its  numbering  scheme.   The  RecNum and TrcNum header
          words of the input data are read and using these values
          the trace is sent to its proper cell in the volume.

     -limin limin
          Enter the minimum LI number in the survey  volume.  The
          total number if cells in the LI direction will be given
          by the formula  nli = (limax-limin)/lidel + 1

     -limax limax
          Enter the maximum LI number in the survey  volume.  The
          total number if cells in the LI direction will be given
          by the formula  nli = (limax-limin)/lidel + 1

     -lidel lidel
          Enter the LI number increment. Default is 1. The  total
          number  if  cells  in the LI direction will be given by
          the formula  nli = (limax-limin)/lidel + 1

     -dimin dimin
          Enter the minimum DI number in the survey  volume.  The
          total number if cells in the DI direction will be given
          by the formula  ndi = (dimax-dimin)/didel + 1

     -dimax dimax
          Enter the maximum DI number in the survey  volume.  The
          total number if cells in the DI direction will be given
          by the formula  ndi = (dimax-dimin)/didel + 1

     -didel didel
          Enter the DI number increment. Default is 1. The  total
          number  if  cells  in the DI direction will be given by
          the formula  ndi = (dimax-dimin)/didel + 1

     -S   Enter the command line argument '-S'  to  stack  traces
          into 3D volume.  If you know there are more than a sin-
          gle trace per cell then  use  this  option.  This  will
          cause  the  latest  input  trace to be stacked into the
          current cell contents  (normalizing  according  to  the
          number of live samples).

     -fdslice
          Enter the command line argument '-fdslice' sort in mode
          2  (this is really for data generated by fdslice) based
          on the  actual  record  and  trace  numbers  (RecNum  &
          TrcNum).  This  will  guarantee  output data ordered by
          trace first.

     -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.

BUGS

     none

SEE ALSO

     sisort(1) memsrt(1) presort(1)

AUTHOR

     P.G.A. Garossino (APR:3932) Requested by Klaas Koster (APR)

COPYRIGHT

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