SYNOPSIS

PERL PROGRAM NAME:

AUTHOR: Juan Lorenzo (Perl module only)

DATE:

DESCRIPTION:

Version:

USE

NOTES

Examples

SYNOPSIS

SEISMIC UNIX NOTES PSMOVIE - PostScript MOVIE plot of a uniformly-sampled function f(x1,x2,x3)

psmovie n1= [optional parameters] <binaryfile >postscriptfile		



Required Parameters:							

n1                     number of samples in 1st (fast) dimension	



Optional Parameters:							

d1=1.0                 sampling interval in 1st dimension		

f1=0.0                 first sample in 1st dimension			

n2=all                 number of samples in 2nd (slow) 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

d1s=1.0                factor by which to scale d1 before imaging	

d2s=1.0                factor by which to scale d2 before imaging	

verbose=1              =1 for info printed on stderr (0 for no info)	

xbox=1.0               offset in inches of left side of axes box	

ybox=1.5               offset in inches of bottom side of axes box	

wbox=6.0               width in inches of axes box			

hbox=8.0               height in inches of axes box			

x1beg=x1min            value at which axis 1 begins			

x1end=x1max            value at which axis 1 ends			

d1num=0.0              numbered tic interval on axis 1 (0.0 for automatic)

f1num=x1min            first numbered tic on axis 1 (used if d1num not 0.0)

n1tic=1                number of tics per numbered tic on axis 1	

grid1=none             grid lines on axis 1 - none, dot, dash, or solid

label1=                label on axis 1				

x2beg=x2min            value at which axis 2 begins			

x2end=x2max            value at which axis 2 ends			

d2num=0.0              numbered tic interval on axis 2 (0.0 for automatic)

f2num=x2min            first numbered tic on axis 2 (used if d2num not 0.0)

n2tic=1                number of tics per numbered tic on axis 2	

grid2=none             grid lines on axis 2 - none, dot, dash, or solid

label2=                label on axis 2				

labelfont=Helvetica    font name for axes labels			

labelsize=18           font size for axes labels			

title=                 title of plot					

titlefont=Helvetica-Bold font name for title				

titlesize=24           font size for title				

style=seismic          normal (axis 1 horizontal, axis 2 vertical) or	

                       seismic (axis 1 vertical, axis 2 horizontal)	

n3=1                   number of samples in third dimension		

title2=                second title to annotate different frames	

loopdsp=3              display loop type (1=loop over n1; 2=loop over n2;

                                          3 = loop over n3)		

d3=1.0                 sampling interval in 3rd dimension		

f3=d3                  first sample in 3rd dimension			



NeXT: view movie via:   psmovie < infile n1= [optional params...] | open

Note: currently only the Preview Application can handle the multipage  

      PostScript output by this program.				



All color specifications may also be made in X Window style Hex format

example:   axescolor=#255						



Legal font names are:							

AvantGarde-Book AvantGarde-BookOblique AvantGarde-Demi AvantGarde-DemiOblique"

Bookman-Demi Bookman-DemiItalic Bookman-Light Bookman-LightItalic 

Courier Courier-Bold Courier-BoldOblique Courier-Oblique 

Helvetica Helvetica-Bold Helvetica-BoldOblique Helvetica-Oblique 

Helvetica-Narrow Helvetica-Narrow-Bold Helvetica-Narrow-BoldOblique 

Helvetica-Narrow-Oblique NewCentrySchlbk-Bold"

NewCenturySchlbk-BoldItalic NewCenturySchlbk-Roman Palatino-Bold  

Palatino-BoldItalic Palatino-Italics Palatino-Roman 

SanSerif-Bold SanSerif-BoldItalic SanSerif-Roman 

Symbol Times-Bold Times-BoldItalic 

Times-Roman Times-Italic ZapfChancery-MediumItalic 

User's notes (Juan Lorenzo) untested

CHANGES and their DATES

Import packages

instantiation of packages

Encapsulated hash of private variables

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

sub bperc

sub clip

sub d1

sub d1num

sub d1s

sub d2

sub d2num

sub d2s

sub d3

sub f1

sub f1num

sub f2

sub f2num

sub f3

sub grid1

sub grid2

sub hbox

sub label1

sub label2

sub labelfont

sub labelsize

sub loopdsp

sub n1

sub n1tic

sub n2

sub n2tic

sub n3

sub perc

sub style

sub title

sub title2

sub titlefont

sub titlesize

sub verbose

sub wbox

sub wclip

sub wperc

sub x1beg

sub x1end

sub x2beg

sub x2end

sub xbox

sub ybox

sub get_max_index

max index = number of input variables -1