NAME

Rickmovie - displays cubic array of data


SYNOPSIS

Rickmovie in=datafile [ data pars ] [ display pars ]


DESCRIPTION

Display cubic array of data in XWindows-Motif


INPUT PARAMETERS

in - file
      [stdin]    name of input file
n1,n2,n3..5 - integer
      length of 3 dimensions, n1 is fastest, e.g. time
o1...o5 - float
      [0.]first sample value in each dimension
d1...d5 - float
      [1.]sample increment in each dimension
z1...z5 - integer
      [1]relative spacing for true size, z3=3 means wide lines
label1..5 - char*
      [n1]...[n5]label for each dimension
title - char*
      [in]   dataset title
script - file
      script file with label for every panel (n3 dimension)
segy - integer
      [0]data format is segy or not
vgrid - integer
      specify vgrid choice
esize - integer
      [1]  data samples are =1 for bytes or =4 for floats
hbytes - integer
      [0,3600]header bytes to skip; 3600 for segy=1
pclip - integer
      [255]  positive clip value; high= and clip= are synonyms
nclip - integer
      [1]  negative clip value; low= and clip= are synonyms
value - char*
      [sample] name for values on colorbar
width,height-integer
      [600]pixel dimension (> 64) or fraction of screen (<= 1.0)
pick -file
      pick line data file
npick -integer
      [2500]maximum number of picks used
style -char*
      [cube]view is front, side, top, plan, array, picks, cube, 
      fence, or transparent
orient -char*
      [front]    orient is front, side, top
origin -char*
      [minimum]   frames set to middle or minimum
transp -integer
      [0] if 1, transpose down and across
shape -char*
      [fit]   shape fits screen, true, or pixel
movie -char*
      [off] run movie in up, down, left, right, in, or out direction
color -char*
      [gray]color is gray, straw, flag, tiger, blue, or rainbow
contrast -integer
      [50]  contrast is between 0 and 100
font -char*
      alternative XWindows font; default bold-courier-20


DATA ARGUMENTS

in=datafile vgrid format - bytes or float with header
in=datafile n1= n2= n3= segy=1 segy/SU format - float traces with headers
in=datafile n1= n2= n3= bytes format (SEPlib) - byte array without header
in=datafile n1= n2= n3= esize=4 float format - float array without header


FILE FORMATS

seplib, bytes input data set: (user supplied)
      2-D of 3-D array of unsigned byte integers 0-255.
      Use segy2movie to convert segy.
      Use Byte to convert seplib floating point.
seplib, float input data set: (user supplied)
      2-D of 3-D array of float numbers
segy, su input data set: (user supplied)
      Two dataset headers.
      n2 x n3 segy traces.
      Each trace 240 bytes + n1 IEEE floating point samples.
      Use suread to convert tape dataset.
vgrid, (read or written by Movie).
      cubic array of data.
      100 byte tail describing dimensions.
script file: (user supplied)
      Text file.
      Each line of text annotates an n3 direction frame.
pick file: (generated by program or user supplied)
      First line is dataset name.
      Second line is dataset dimensions.
      Third line are axes labels.
      Followed by pick-lines:
       First line is ID and frame.
       Following lines are pick points:
        three coordinates and data value.
par file: (user supplied or generated by Save State menu)
      List of parameters in name=value form. Free format.
      Last of duplicates used.


WINDOWS

(1) Menubar on top.
(2) Message window below menubar.
(3) Control panel below message window.
(4) Color spectrum below control panel. Line shows relative data sample distribution. Bar shows last pick value or range of values. Mouse click-drag-up specifies a value range.
(5) Resizable image window. Responds to following mouse clicks:


MOUSE USAGE

LEFT: zoom; MIDDLE: navigate; RIGHT: pick.
LEFT click-drag-up: zoom window.
LEFT click only: initial size.
LEFT click-drag-up + 'h' key: zoom horizontal only.
LEFT click-drag-up + 'v' key: zoom vertical only.
LEFT click-drag-up in ARRAY window: those panels.
MIDDLE click: select cross frames.
MIDDLE click-drag-up: select an animation range.
RIGHT click: pick a point on the image.
RIGHT click + 'a' key: add a point to end of pick line.
RIGHT click + 'm' key: move nearest point in pick line.
RIGHT click + 'd' key: delete nearest point in pick line.
RIGHT click-drag-up + 's' key:select seed point & sub-volume pick bounds.
COLORBAR ANY click-drag-up: replace sub-volume range with this new range.


INTERACTIVE CONTROLS


MAIN FUNCTIONS: Interface to system

``Main'' ``Redraw'' -- refresh damaged screen
``Main'' ``Write vgrid file (floats)'' -- save data files as floats in seplib/vgrid format
``Main'' ``Write vgrid file (bytes)'' -- save data files as bytes in seplib/vgrid format
``Main'' ``Write parameter restart file'' -- create a parameter restart file
``Main'' ``Debug'' -- dump various arrays for programmer debugging
``Main'' ``Quit''


STYLE FUNCTIONS: Select a style and set attributes

``View'' ``Front (2D)'' -- Front face of data cube
``View'' ``Side (2D)'' -- Side face of data cube
``View'' ``Top (2D)'' -- Top face of data cube
``View'' ``Plan (2D)'' -- All three cube faces
``View'' ``Array (3D) ...'' -- Array of front faces- up to a hundred
``View'' ``Pick (3D) ...'' -- Array of picked faces
``View'' ``Cube (3D)'' -- Cube view
``View'' ``Fence (3D) ...'' -- Show intersecting faces
``View'' ``Transparent (3D) ...'' -- Transparent volume
``Array Panel'' ``Direction'' <four axes> -- Select through direction
``Array Panel'' ``Down'' -- Panels in down direction
``Array Panel'' ``Across'' -- Panels in across direction
``Array Panel'' ``Start'' -- First panel
``Array Panel'' ``Delta'' -- Panel increment
``Array Panel'' ``End'' -- Last panel; sets delta
``Array Panel'' ``Draw'' -- Draw with new parameters
``Array Panel'' ``Close'' -- Close control panel
``Array Panel'' ``LEFT MOUSE SELECTS PANEL RANGE
``Fence Panel'' ``Toggle Front'' -- Toggle front plane on
``Fence Panel'' ``Toggle Side'' -- Toggle side plane on
``Fence Panel'' ``Toggle Top'' -- Toggle top plane on
``Fence Panel'' ``Transparency'' -- Set transparency threshhold
``Fence Panel'' ``Draw'' -- Draw with new parameters
``Fence Panel'' ``Close'' -- Close control panel
``Transparency Panel'' ``Min'' -- Set minimum transparency value
``Transparency Panel'' ``Max'' -- Set maximum transparency value
``Transparency Panel'' ``Transp'' -- Set transparency value
``Transparency Panel'' ``Draw altogether'' -- Update screen once
``Transparency Panel'' ``Draw tenth blocks'' -- Update screen ten times
``Transparency Panel'' ``Draw each plane'' -- Update screen continuously
``Transparency Panel'' ``Draw'' -- Draw with new parameters
``Transparency Panel'' ``Close'' -- Close control panel


ORIENT FUNCTIONS: change way axes point; 2-D are in-plane

``Orient'' ``Side<->Top (2-D)'' -- Rotate axes
``Orient'' ``Front<->Side (3-D)'' -- Rotate axes
``Orient'' ``Top<->Front (3-D)'' -- Rotate axes
``Orient'' ``Front<->Extra (4-D)'' -- Rotate axes
``Orient'' ``Side<->Extra (4-D)'' -- Rotate axes
``Orient'' ``Top<->Extra (4-D)'' -- Rotate axes
``Orient'' ``<-Down-> (2-D)'' -- Reversal
``Orient'' ``<-Across-> (2-D)'' -- Reversal
``Orient'' ``<-Deep-> (3-D)'' -- Reversal
``Orient'' ``Frames to Origin'' -- Cross frames to start of origin of each axis
``Orient'' ``Frames in Middle'' -- Cross frames in middle of each frame
``Orient'' ``Labels Set ..'' -- Control panel to adjust labeling
``Orient'' ``Reset Initial''


SIZE FUNCTIONS: set size and shape policy

``Size'' ``Fit Screen'' -- Front fills 2/3s screen; sides 1/3
``Size'' ``True Proportions''
``Size'' ``Sample per Pixel''
``Size'' ``Interpolate'' -- Improves large magnifications
``Size'' ``Size Set ..'' -- Launch size setting control panel
``Size Set'' ``Minimum'' -- Minimum sample/value along axis
``Size Set'' ``Maximum'' -- Maximum sample/value along axis
``Size Set'' ``Frame'' -- Frame sample/value along axis
``Size Set'' ``Pixels'' -- Pixels along axis
``Size Set'' ``Draw'' -- Draw these size settings
``Size Set'' ``Current'' -- Restore current size settings
``Size Set'' ``Initial'' -- Fill in initial settings
``Size Set'' ``Close'' -- Close size settings panel
``Size'' ``Reset Initial''
``Size'' ``LEFT MOUSE BOX ZOOMS'' -- interactive magnification
``Size'' ``+ 'h' KEY ONLY HORZ'' -- constrain to horizontal
``Size'' ``+ 'v' KEY ONLY VERT'' -- constrain to vertical
``Size'' ``LEFT MOUSE CLICK ONLY'' -- initial size


MOVIE FUNCTIONS: go to part of the cube; run movies

``Navigate'' ``Reset Bounds'' -- Movie loop traverses full cross face
``Navigate'' ``High Speed'' -- Frames are stored in displat terminal
``Navigate'' BUTTON ``GO'' -- Start movie
``Navigate'' BUTTON ``NO'' -- Stop movie
``Navigate'' BUTTON `` z '' -- Run/step in direction
``Navigate'' BUTTON `` Z '' -- Run/step out direction
``Navigate'' BUTTON `` < '' -- Run/step left direction
``Navigate'' BUTTON `` > '' -- Run/step right direction
``Navigate'' BUTTON `` ^ '' -- Run/step up direction
``Navigate'' BUTTON `` v '' -- Run/step down direction
``Navigate'' SLIDER `` Speed '' -- Delay between frames
``Navigate'' ``MIDDLE MOUSE CLICK Reset cross framesFRAMES'' -- X
``Navigate'' ``MIDDLE MOUSE DRAG MOVIE BOUNDS'' -- Set movie range


COLOR FUNCTIONS: set color, contrast, and transparency

``Color'' ``Gray'' -- Grayscale
``Color'' ``Straw'' -- Blue and yellow
``Color'' ``Flag'' -- Red, white and blue
``Color'' ``Tiger'' -- Red, white and black
``Color'' ``Blue'' -- Blue and white
``Color'' ``Rainbow'' -- Multi-colored
``Color'' ``Graybow'' -- Gray plus multi-colored
``Color'' ``Overlay'' <color-list> -- Overlay lines and text
``Color'' ``Mark'' <color-list> -- Pick color
``Color'' ``Background'' <color-list> -- Screen background color
``Color'' ``Flip Polarity'' -- of data-> color
``Color'' ``Reset Contrast'' -- No skew or zero point contrast
``Color'' SLIDER ``CONTRAST'' -- Shift color table skew
``Color'' SLIDER ``CONTRAST0'' -- Shift color table zero point
``Color'' BUTTON ``Reset'' -- Reset initial contrast


PICK FUNCTIONS: set picking behavior

``Pick'' ``Clear Current Line'' -- Erase pick line or sub-volume
``Pick'' ``Write pick file'' -- Write to pick= now
``Pick'' ``Read pick file'' -- Read from pick= now
``Pick'' ``RIGHT MOUSE MAKES PICK'' -- right mouse button manipulates picks
``Pick'' ``+ 'a' KEY ADDS POINT TO END OF LINE''
``Pick'' ``+ 'i' KEY INSERTS POINT BETWEEN NEAREST POINTS''
``Pick'' ``+ 'm' KEY MOVES NEAREST POINT''
``Pick'' ``+ 'd' KEY DELETES NEAREST POINT''
``Pick'' ``+ 's' KEY + DRAGGING PICKS SUB-VOLUME''


EDIT FUNCTIONS: edit grid sub-volume

``Edit'' ``Clear Sub-volume pick'' -- Clear current subvolume
``Edit'' ``Smooth Sub-volume'' -- Smooth sub-volume to boundary value
``Edit'' ``Undo Smooth'' -- Restore sub-volume
``Edit'' ``Grade Sub-volume'' -- Grade sub-volume to boundary plane values
``Edit'' ``Undo grade''
``Edit'' ``Sub-volume Neighborhood'' <6, 18, 26> -- Cube connectivity of sub-volume
``Edit'' ``COLOR BAR MOUSE SETS SMOOTH RANGE''


SECTION FUNCTION: plot various sections through the data

``Section'' ``On screen wiggle plot ...'' ``Front, side or top plane''
``Section'' ``On screen contour plot ...'' ``Front, side or top plane''
``Section'' ``On screen graph profile ...'' ``Down, across, or deep profile''
``Section'' ``Print wiggle plot ...'' ``Front, side or top plane''
``Section'' ``Print contour plot ...'' ``Front, side or top plane''
``Section'' ``Print graph profile ...'' ``Down, across, or deep profile''
``Section'' ``Save section in file ...'' ``Front, side or top plane''
``Section'' ``Save profile in file ...'' ``Save down, across, or deep profile''
``Section'' ``PLANES AND PROFILES ARE SELECTED AT CROSS-HAIRS''


STATUS FUNCTIONS: print parameters and state variables

``Status'' ``Dataset'' -- Dataset parameters
``Status'' ``Data Values'' -- Data value parameters
``Status'' ``Data Axis0'' -- Value/color axis
``Status'' ``Data Axis1'' -- Fast axis, usually time
``Status'' ``Data Axis2'' -- Second data axis, usually CDP
``Status'' ``Data Axis3'' -- Slow axis, usually section
``Status'' ``Data Axis4'' -- Slow axis, usually offset
``Status'' ``Data Axis5'' -- Slow axis, unused
``Status'' ``View'' -- View parameters
``Status'' ``Down Axis'' -- View down axis parameters
``Status'' ``Across Axis'' -- View across axis parameters
``Status'' ``Deep Axis'' -- View deep axis parameters
``Status'' ``Extra Axis'' -- View extra axis parameters
``Status'' ``Color Axis'' -- Colorbar axis parameters
``Status'' ``Color'' -- Color and contrast parameters
``Status'' ``Render'' -- Rendering parameters
``Status'' ``Draw'' -- Draw screen parameters
``Status'' ``Mouse Buttons'' -- Mouse button functions
``Status'' ``Navigate'' -- Movie parameters
``Status'' ``Pick'' -- Pick parameters
``Status'' ``Pick List'' -- Current pick line parameters
``Status'' ``sub-volume'' -- Current mark sub-volume
``Status'' ``Frame List'' -- List of screen frames


HELP FUNCTIONS: print self documentation from various places

``Help'' ``Command Line Args''
``Help'' ``File Formats''
``Help'' ``Windows''
``Help'' ``Mouse Usage''
``Help'' ``Main Functions''
``Help'' ``View Functions''
``Help'' ``Orient Functions''
``Help'' ``Size Functions''
``Help'' ``Navigate Functions''
``Help'' ``Color Functions''
``Help'' ``Picking Functions''
``Help'' ``Status Functions''


CATEGORY

interact