NAME

     rec2pol  - module to convert between rectangular  and  polar
     coordinate system

SYNOPSIS

     rec2pol [ -N1ntap1 ] [ -N2ntap2 ] [ -O1otap1 ] [ -O2otap2  ]
     [  -rsnrst ] [ -renrend ] [ -nsnstr ] [ -nenetr ] [ -aminamn
     ] [ -amaxamx ] [ -nullnval ] [ -V ] [ -R ] [ -ikp ] [ -? ]

DESCRIPTION

     rec2pol accepts input in X,Y or  Radius,Angle  and  performs
     the  coordinate  conversion  requested  by  the  user.   The
     default is to convert from rectangular to polar  coordinates
     assuming  X to be attached to N1 and Y to be attached to N2.
     The output will be radius at O1 and angle  (in  degrees)  at
     O2.   To  reverse  the conversion use the -R flag which will
     initiate the polar to rectangular conversion assuming radius
     attached to N1 and angle attached to N2.  The output will be
     X attached to O1 and Y attached to O2.

     rec2pol gets both its data and its parameters  from  command
     line  arguments.  These arguments specify the input, output,
     the start and end traces, angular max, min and null replace-
     ment value as well as the verbose printout flag, if desired.

  Command line arguments
     -N1 ntap1 [X or Radius]
          Enter the input data set name or file immediately after
          typing  -N1  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'.

     -N2 ntap2 [Y or Angle]
          Enter the input data set name or file immediately after
          typing  -N2  [cannot  be  a  pipe].   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'.

     -O1 otap  [Radius or X]
          Enter the output data  set  name  or  file  immediately
          after typing -O1.

     -O2 otap  [Angle or Y]
          Enter the output data  set  name  or  file  immediately
          after typing -O2.

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

     -amin amn
          Enter minimum  angle  to  convert  [degrees].   Default
          value is zero degrees.

     -amax amx
          Enter maximum  angle  to  convert  [degrees].   Default
          value is 360 degrees.

     -null nval
          Enter angular value [degrees] to use for sample falling
          outside limits of amax and amin.  Default value is 1000
          degrees.

     -R   Enter the command line argument '-R'  to  do  polar  to
          rectangular conversion.  The default is to do rectangu-
          lar to polar coordinate conversion.

     -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

     They're crawling out of the woodwork

SEE ALSO

     dreck(1)

AUTHOR

     P.G.A.      Garossino       [APR:Sept       93,       X3932,
     pgarossino@trc.amoco.com] requested by Dave Hill [London]

COPYRIGHT

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