NAME

     razbin  - module to do radial, azimuthal binning of 3D  pre-
     stack seismic data.

SYNOPSIS

     razbin [ -Nntap ] [ -Ootap ] [ -sist ] [ -eiend ] [  -nsnstr
     ]  [ -nenetr ] [ -rsnrst ] [ -renred ] [ -asnsaz ] [ -aeneaz
     ] [ -ainiaz  ]  [  -ntrcntrbin  ]  [  -scope  ]  [  -R  ]  [
     -hwhmnemonic ] [ -V ] [ -? ]

DESCRIPTION

     razbin performs radial azimuthal binning of  pre-stack  end-
     point seismic data.  The trace header entries for Source and
     Receiver X,Y co-ordinates must be filled out and  better  be
     correct.  The routine runs in one of three modes:

     Scoping Mode: -scope reads through the data  and  using  the
     command  line  entries  for  start  azimuth, end azimuth and
     azimuthal increment determines, for each record,  the  total
     number of live traces per bin.  This information is reported
     to the printout file.  The maximum  and  minimum  number  of
     live  traces  per  bin and the maximum radial offset for the
     dataset along with a histogram of data distribution per  bin
     is also reported to stderr.

     Sorting Mode: Once the maximum number of traces per  bin  is
     known  the  routine  may be run on the data to do the actual
     binning.  This number is required as it defines  the  traces
     per  record  on  the  output dataset.  Each record is sorted
     into the number of azimuthal bins  defined  by  the  command
     line  parameters above.  The number of records in the output
     dataset is equal to the number of input  records  multiplied
     by  the  number  of  azimuthal  bins  output.  The number of
     traces per record is defined by the command line entry -ntrc
     which is required.

     Reverse Sorting Mode:  After all radial processing  is  com-
     pleted,  if  desired,  the data may be returned to it's pre-
     radial sort configuration by using the -R option.  The trace
     header  mnemonic  used to restore the trace order within the
     record may be supplied on the command  line  using  the  -hw
     parameter.   The  same azimuthal parameters used to sort the
     data are required here as well in order to  properly  unsort
     the data.

     razbin gets both its data and its  parameters  from  command
     line  arguments.  These arguments specify the input, output,
     the start and end records,traces, and samples, the start and
     end  azimuth  and  azimuth increment, the sort direction and
     header mnemonic to sort on, scoping action and verbose prin-
     tout, 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.  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).

     -s ist
          Enter the start time  of  the  design  window  in  mil-
          liseconds.  The default is the beginning of the trace.

     -e iend
          Enter the  end  time  of  the  design  window  in  mil-
          liseconds.  The default is the end of the trace.

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

     -as nsaz
          Enter start sort azimuth in degrees.  Default value  is
          the zero degrees.

     -ae neaz
          Enter end sort azimuth in degrees.   Default  value  is
          the 359 degrees.

     -ai niaz
          Enter sort azimuth increment in degrees.  Default value
          is the 10 degrees.

     -ntrc ntrbin
          Enter the maximum number of  traces  per  bin  for  the
          sorted output.  This information is required to perform
          the sorting as it defines the  line  header  entry  for
          number  of traces per record on output.  You may obtain
          this information for your dataset by running the  scop-
          ing  action  of  this routine prior to actually sorting
          the data. See -scope below.

     -scope
          Enter the command  line  argument  '-scope'  to  obtain
          information regarding the number of live traces per bin
          for each input record as  well  as  global  information
          about the maximum and minimum number of live traces per
          bin in the dataset as a  whole.   This  information  is
          required in order to sort the data for real.

     -R   Enter the command line argument '-R' to return the data
          sort  to  the  original  configuration  prior to radial
          sorting.

     -hw hmnemonic
          Enter trace header mnemonic used to  do  the  secondary
          sort within a record on output.  The default is RecInd.

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

     -?, -h, -help
          Enter one of the command  line  arguments  '-?'  -h  or
          -help to get online help.  The program terminates after
          the help screen is printed.

BUGS

     Unknown

SEE ALSO

     sr3d1(1) sr3d2(2) sisort(1) presort(1)

AUTHOR

     P.Garossino, Original Concept D. Wagner [May/95]

COPYRIGHT

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