NAME

     rotaten  - rotates  two  component  seismic  attribute  data
     through a multiplicity of viewing angles.

SYNOPSIS

     rotaten [ -N1file_xin ] [ -N2file_yin ]  [  -Ofile_out  ]  [
     -nrotnrot ] [ -V ] [ -? ]

DESCRIPTION

     rotaten reads in two orthogonal seismic attributes and  gen-
     erates  intermediate  attribute  displays  between 0 and 360
     degrees.


     -N1 file_xin
          Enter the first of two  orthogonal  attributes  immedi-
          ately  after typing -N1. This input file should include
          the complete path name if the file resides  in  a  dif-
          ferent  directory.   Example -N/export/data2/san_juan/p
          tells the program to look for the in-line dip file  'p'
          in  the directory '/export/data2/san_juan'. Data cannot
          be piped in using this option.

     -N2 file_yin
          Enter the second of two orthogonal  attributes  immedi-
          ately       after       typing       -N2.       Example
          -N/export/data2/san_juan/q tells the  program  to  look
          for  the  cross-line  dip  file   'q'  in the directory
          '/export/data2/san_juan'. Data cannot be piped in using
          this option.

     -O file_out
          Enter -O followed by the output rotated file  name.  If
          the  input  number of time samples is nsamp, the output
          number of time samples will be nsamp*nrot, the  rotated
          data  corresponding  to input sample jsamp and rotation
          jrot being stored in output sample (jsamp-1)*nrot+jrot.
          This  peculiar  storage  mechanism allows to time slice
          and interpret the rotated seimic attributes using  com-
          mercial Landmark Seisworks and  Geoquest IESX interpre-
          tive workstation software. (Default:  pipe  the  output
          data to standard out).

     -nrot nrot
          Enter the number of  rotation  angles,  such  that  the
          angle  @theta@  for  the  rotation jrot will be @ theta
          =jrot*d theta @, where  @  d  theta  =  360  over  nrot
          @.(Default:   nrot  =  24,  such  that  @d theta = @ 15
          degrees).

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

Expert Options (NOT for the faint

     -N file_multiattribute
          Enter the input multi-attribute data set file name gen-
          erated  by  program  c5 immediately after typing -N. In
          contrast to the -N1 and -N2 options  above,  this  file
          may  be   piped  in.  The attributes in this file  were
          output back to back, line by line.  The  actual  attri-
          butes calculated were be stored in the line header word
          LinNam, with character 'c'  indicating  coherency,  'p'
          indicating in-line dip p, 'q' indicating cross-line dip
          q, 'r' indicating reflector curvature,  'a'  indicating
          amplitude  a0,  'x' indicating amplitude gradient dadx,
          'y' indicating amplitude gradient dady, and  'l'  indi-
          cating  amplitude  2nd derivative or Laplacian, da2dx2.
          To extract the in-line and cross-line dip,  enter  com-
          mand  line  arguments   -P and  -Q . To extract the in-
          line and cross-line amplitude gradients enter the  com-
          mand line arguments  -DADX and  -DADY.

See Also:

      c5, SSAM,  lm3dvtosis, sistolm3dv, iesx3dtosis, sistoiesx3d

CONTRACT AGREEMENT

     This product is brought to you by Development  Agreement  D-
     97-2548  (The  seismic  coherency and spectral decomposition
     cubes) as a first quarter, 1997, deliverable.. Thank you for
     your support.

AUTHOR

     Kurt J. Marfurt, Amoco EPTG, Tulsa, OK, 1996.

COPYRIGHT

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