DOCUMENTATION
SYNOPSIS
PERL PROGRAM NAME: SUXMOVIE - X MOVIE plot of a 2D or 3D segy data set AUTHOR: Juan Lorenzo (Perl module only) DATE: DESCRIPTION: Version:
USE
NOTES
Examples
SEISMIC UNIX NOTES
SUXMOVIE - X MOVIE plot of a 2D or 3D segy data set
suxmovie <stdin [optional parameters]
Optional parameters:
n1=tr.ns number of samples per trace
ntr=tr.ntr number of traces in the data set
n2=tr.shortpad or tr.ntr number of traces in inline direction
n3=ntr/n2 number of traces in crossline direction
d1=tr.d1 or tr.dt/10^6 sampling interval in the fast dimension
=.004 for seismic (if not set)
=1.0 for nonseismic (if not set)
d2=tr.d2 sampling interval in the slow dimension
=1.0 (if not set)
d3=1.0 sampling interval in the slowest dimension
f1=tr.f1 or 0.0 first sample in the z dimension
f2=tr.f2 or 1.0 first sample in the x dimension
f3=1.0
mode=0 0= x,z slice movie through y dimension (in line)
1= y,z slice movie through x dimension (cross line)
2= x,y slice movie through z dimension (time slice)
verbose=0 =1 to print some useful information
tmpdir= if non-empty, use the value as a directory path
prefix for storing temporary files; else if the
the CWP_TMPDIR environment variable is set use
its value for the path; else use tmpfile()
Notes:
For seismic data, the "fast dimension" is either time or
depth and the "slow dimension" is usually trace number.
The 3D data set is expected to have n3 sets of n2 traces representing
the horizontal coverage of n2*d2 in x and n3*d3 in y direction.
The data is read to memory with and piped to xmovie with the
respective sampling parameters.
See the xmovie selfdoc for the remaining parameters and X functions.
PERL PROGRAM NAME: XMOVIE - image one or more frames of a uniformly sampled function f(x1,x2) AUTHOR: Juan Lorenzo (Perl module only) DATE: DESCRIPTION: Version:
USE
NOTES
Examples
SEISMIC UNIX NOTES
XMOVIE - image one or more frames of a uniformly sampled function f(x1,x2)
xmovie n1= n2= [optional parameters] <fileoffloats
X Functionality:
Button 1 Zoom with rubberband box
Button 2 reverse the direction of the movie.
Button 3 stop and start the movie.
q or Q key Quit
s or S key stop display and switch to Step mode
b or B key set frame direction to Backward
f or F key set frame direction to Forward
n or N key same as 'f'
c or C key set display mode to Continuous mode
Required Parameters:
n1= number of samples in 1st (fast) dimension
n2= number of samples in 2nd (slow) dimension
Optional Parameters:
d1=1.0 sampling interval in 1st dimension
f1=0.0 first sample in 1st dimension
d2=1.0 sampling interval in 2nd dimension
f2=0.0 first sample in 2nd dimension
perc=100.0 percentile used to determine clip
clip=(perc percentile) clip used to determine bclip and wclip
bperc=perc percentile for determining black clip value
wperc=100.0-perc percentile for determining white clip value
bclip=clip data values outside of [bclip,wclip] are clipped
wclip=-clip data values outside of [bclip,wclip] are clipped
x1beg=x1min value at which axis 1 begins
x1end=x1max value at which axis 1 ends
x2beg=x2min value at which axis 2 begins
x2end=x2max value at which axis 2 ends
fframe=1 value corresponding to first frame
dframe=1 frame sampling interval
loop=0 =1 to loop over frames after last frame is input
=2 to run movie back and forth
interp=1 =0 for a non-interpolated, blocky image
verbose=1 =1 for info printed on stderr (0 for no info)
idm=0 =1 to set initial display mode to stepmode
Optional resource parameters (defaults taken from resource database):
windowtitle= title on window and icon
width= width in pixels of window
height= height in pixels of window
nTic1= number of tics per numbered tic on axis 1
grid1= grid lines on axis 1 - none, dot, dash, or solid
label1= label on axis 1
nTic2= number of tics per numbered tic on axis 2
grid2= grid lines on axis 2 - none, dot, dash, or solid
label2= label on axis 2
labelFont= font name for axes labels
title= title of plot
titleFont= font name for title
titleColor= color for title
axesColor= color for axes
gridColor= color for grid lines
style= normal (axis 1 horizontal, axis 2 vertical) or
seismic (axis 1 vertical, axis 2 horizontal)
sleep= delay between frames in seconds (integer)
Color options:
cmap=gray gray, hue, saturation, or default colormaps may be specified
bhue=0 hue mapped to bclip (hue and saturation maps)
whue=240 hue mapped to wclip (hue and saturation maps)
sat=1 saturation (hue map only)
bright=1 brightness (hue and saturation maps)
white=(bclip+wclip)/2 data value mapped to white (saturation map only)
Notes:
Colors are specified using the HSV color wheel model:
Hue: 0=360=red, 60=yellow, 120=green, 180=cyan, 240=blue, 300=magenta
Saturation: 0=white, 1=pure color
Value (brightness): 0=black, 1=maximum intensity
For the saturation mapping (cmap=sat), data values between white and bclip
are mapped to bhue, with saturation varying from white to the pure color.
Values between wclip and white are similarly mapped to whue.
For the hue mapping (cmap=hue), data values between wclip and bclip are
mapped to hues between whue and bhue. Intermediate hues are found by
moving counterclockwise around the circle from bhue to whue. To reverse
the polarity of the image, exchange bhue and whue. Equivalently,
exchange bclip and wclip (setting perc=0 is an easy way to do this).
Hues in excess of 360 degrees can be specified in order to reach the
opposite side of the color circle, or to wrap around the circle more
than once.
The title string may contain a C printf format string containing a
conversion character for the frame number. The frame number is
computed from dframe and fframe. E.g., try setting title="Frame 0".
CHANGES and their DATES
sub Step
collects switches and assembles bash instructions by adding the program name
sub note
collects switches and assembles bash instructions by adding the program name
sub clear
sub axesColor
sub bclip
subs bclip or loclip or low_clip
sub bhue
sub bperc
sub bright
sub clip
sub cmap
sub d1
sub d2
sub d3
sub dframe
sub f1
sub f2
sub f3
sub fframe
sub grid1
sub grid2
sub gridColor
sub height
sub hiclip
subs wclip or hiclip or high_clip
sub high_clip
subs wclip or hiclip or high_clip
sub idm
sub interp
sub label1
sub label2
subs label2 or xlabel
sub labelFont
sub loclip
subs bclip or loclip or low_clip
sub low_clip
subs bclip or loclip or low_clip
sub loop
sub mode
sub n1
sub n2
sub n3
sub nTic1
sub nTic2
sub ntr
sub perc
sub sat
sub sleep
sub style
sub title
sub titleColor
sub titleFont
sub tmpdir
sub verbose
sub wclip
subs wclip or high_clip
sub white
sub whue
sub width
sub windowtitle
sub wperc
sub x1beg
sub x1end
sub x2beg
sub x2end
sub x_label
sub y_label
sub get_max_index
max index = number of input variables -1