NAME

     binxys  - write common midpoint XYs into 3D stacked data

SYNOPSIS

     binxys [ -Nntap ] [ -Ootap ] [ -x1x1 ] [ -y1y1 ] [ -dxdx ] [
     -dydy ] [ -nlnl ] [ -ndnd ] [ -X ] [ -V ] [ -? ]

DESCRIPTION

     binxys writes midpoint XYs into the trace headers  of  a  3D
     stacked  volume  starting at Corner 1 described in the sr3d1
     and sr3d2 documentation (corner 1 is the NE  corner  of  the
     survey. The dimensions of the survey and the cell dimensions
     are then used to compute the XYs  in  all  the  cells.   The
     resulting  XY  information can then be used to manipulate or
     merge 3D surveys.

     binxys gets both its data and its  parameters  from  command
     line  arguments.  These arguments specify the input, output,
     corner 1, the cell dimensions, and  the  survey  dimensions,
     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.  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).

     -x1 x1
          Enter the X-coordinate of the NE corner of the  survey.
          This is easy if the 3D stacked data have been generated
          using the USP 3D tools since the 4-cornered survey lim-
          its  are explicitly given. Otherwise a base map will be
          necessary to locate the survey in some reasonable coor-
          dinate system. Generally it can be taken that X runs EW
          (or 2-3 direction) and Y runs NS (or 1-2 direction). No
          default.

     -y1 y1
          Enter the Y-coordinate of the NE corner of the  survey.
          This is easy if the 3D stacked data have been generated
          using the USP 3D tools since the 4-cornered survey lim-
          its  are explicitly given. Otherwise a base map will be
          necessary to  locate  the  survey  in  some  reasonable
          coordinate  system.  Generally  it  can be taken that X
          runs EW (or 2-3 direction) and Y runs NS (or 1-2 direc-
          tion). No default.

     -dx dx
          Enter the X dimension of the cell (in the same units as
          x1,y1).   The  first midpoint value in X will be 1/2 dx
          west from the x1 value, the next will be 3/2  dx  west,
          etc. No default.

     -dy dy
          Enter the Y dimension of the cell (in the same units as
          x1,y1).   The  first midpoint value in Y will be 1/2 dy
          south from the y1 value, the next will be 3/2 dy south,
          etc. No default.

     -nd nd
          Enter the (1-2) or DI (Y) dimension of the  survey  (in
          cell  units).  Generally the 3D stack will be organized
          into nl lines (records), each of nd traces. The default
          is  to  look  in the input line header for the MxDpIn &
          MnDpIn header values (max & min DI numbers) and compute
          the ND.

     -nl nl
          Enter the (2-3) or LI (X) dimension of the  survey  (in
          cell  units).  Generally the 3D stack will be organized
          into nl lines (records), each of nd traces. The default
          is  to  look  in the input line header for the MxLnIn &
          MnLnIn header values (max & min LI numbers) and compute
          the NL.

     -X   Enter the command line argument '-X' if the  survey  is
          in crossline order with LIs varying most rapidly.

     -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

     unknown

SEE ALSO

     sr3d1, sr3d2

AUTHOR

     Paul Gutowski, (socon 422-3146), zprg03@trc.amoco.com

COPYRIGHT

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