NAME

     tune3d  -  The 3-D seismic tuning cube.

SYNOPSIS

     tune3d [ -Nfile_in ] [ -Sfile_scale ] [ -f_peakfile_f_peak ]
     [   -f_troughfile_f_trough   ]   [  -f_meanfile_f_mean  ]  [
     -amp_peakfile_amp_peak ] [  -amp_troughfile_amp_trough  ]  [
     -amp_meanfile_amp_mean ] [ -normalize ] [ -V ] [ -? ]

DESCRIPTION

     tune3d Performs a spectral decomposition on  a  3-D  seismic
     data  cube for a user defined frequency range over a sliding
     analysis window. These parameters  are  input  to  companion
     program swak, which performs a statistical wavelet amplitude
     calculation  of  the  'source  wavelet'  spectrum  and   its
     inverse.  Output  takes several forms: either 4-D cubes or a
     choice of several reductions to 3-D cubes.

     tune3d gets both its data and its  parameters  from  command
     line  arguments.  These arguments specify the input, output,
     the spectral analysis window, the percent  of  cosine  taper
     and verbose printout, if desired.

  Command line arguments
     -N file_in
          Enter the input 3-D seismic cube file name  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/export/data2/migrated.data tells the program to look
          for file 'migrated.data' in directory '/export/data2'.

     -S file_scale

     Enter the wavelet amplitude and inverse spectrum  file  gen-
     erated as output from companion program swak. In addition to
     containing the spectrum and its inverse, temporal  and  fre-
     quency analysis window information is carried through in the
     seismic line header. No default.

     -f_peak file_f_peak
          Enter the (optional) output 3-D  data  cube  containing
          the peak frequency of the spectral analysis immediately
          after typing -f_peak .

     -f_trough file_f_trough
          Enter the (optional) output 3-D  data  cube  containing
          the  frequency  correpsonding  to the minimum trough of
          the  spectral   analysis   immediately   after   typing
          -f_trough .

     -f_mean file_f_mean
          Enter the (optional) output 3-D  data  cube  containing
          the mean frequency immediately after typing -f_mean .

     -amp_peak file_amp_peak
          Enter the (optional) output 3-D  data  cube  containing
          the  amplitude  at  the  peak frequency of the spectral
          analysis immediately after typing -amp_peak .

     -amp_trough file_amp_trough
          Enter the (optional) output 3-D  data  cube  containing
          the  amplitude  correpsonding  to the minimum trough of
          the  spectral   analysis   immediately   after   typing
          -f_trough .

     -amp_mean file_amp_mean
          Enter the (optional) output  3-D  data  cube  the  mean
          amplitude immediately after typing -amp_mean .

     -normalize
          Enter the command line argument '-normalize' to normal-
          ize amp_peak and amp_trough by dividing by amp_mean.

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

EXAMPLE 1:

     Run a slab of data called  'seismic  cube'  through  the  D1
     spectral  decomposition  algorithm  tune3d  for a fixed time
     slice at 2600ms. Use named pipes to convert this one  sample
     deep output cube into horizontal time slices.
     #
     # define named pipes:
     #
     /etc/mknod f_peak_file p
     /etc/mknod amp_peak_file p
     #
     # start up qdslice jobs in the background.
     #
     qdslice -N f_peak_file -O f_peak.2600  &
     qdslice -N amp_peak_file -O amp_peak.2600 -ss1 -es1 &
     #
     #launch swak followed by tune3d in the foreground.
     #
     swak -N seismic.cube -O scale_file -fmin 10 -fmax 70 -twindow 100      -tstart 2600 -tend 2600   && tune3d -N seismic.cube -S scale_file   -f_peak f_peak_file -amp_peak amp_peak_file
     #
     # remove named pipes
     #
     "rm" -f f_peak_file amp_peak_file
     #

BUGS

     no known bugs.

See Also:

           swak, spec, rwspec, d3

REFERENCES

     Partyka, G. A., Gridley, J. M., Mims, C. V.  and  Lopez,  J.
     A., 1995, The tuning cube: Interpretational aspects of spec-
     tral decomposition, Amoco Geos. Tech. Bull. F95-G-46.

CONTRACT AGREEMENT

     This product was brought to you by Research Agreements  D96-
     2518  (Seismic  Signal Analysis) and D96-2548 (The Coherency
     Cube, 2nd Quarter Deliverable). Thank you for your support.

AUTHORS:

     Extraction of peak frequency due to A. Kurt  Tollestrup  and
     Charlie V. Mims (OBU, 1/96). Original spectral decomposition
     effort by James M. Gridley and Greg  Partyka  (EPTG,  7/95).
     Vectorization   and  reductions  by  Kurt  J. Marfurt (EPTG,
     4/96). Normalization by mean amplitude by  Kurt  J.  Marfurt
     (EPTG, 8/98)

COPYRIGHT

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