SYNOPSIS

PERL PROGRAM NAME:

AUTHOR: Juan Lorenzo (Perl module only)

DATE:

DESCRIPTION:

Version:

USE

NOTES

Examples

SYNOPSIS

SEISMIC UNIX NOTES PSWIGP - PostScript WIGgle-trace plot of f(x1,x2) via Polygons

 Best for few traces.  Use PSWIGB (Bitmap version) for many traces.	



 pswigp 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			

 x2=f2,f2+d2,...        array of sampled values in 2nd dimension	

 bias=0.0               data value corresponding to location along axis 2

 perc=100.0             percentile for determining clip		

 clip=(perc percentile) data values < bias+clip and > bias-clip are clipped

 xcur=1.0               wiggle excursion in traces corresponding to clip

 fill=1			=0 for no fill;				

				>0 for pos. fill;			

				<0 for neg. fill			

                               =2 for pos. fill solid, neg. fill grey  

                               =-2for neg. fill solid, pos. fill grey  

                       SHADING: 2<=abs(fill)<=5  2=lightgrey 5=black   

 linewidth=1.0         linewidth in points (0.0 for thinest visible line)

 tracecolor=black       color of traces; should contrast with background

 backcolor=none         color of background; none means no background	

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

 xbox=1.5               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				

 titlecolor=black       color of title					

 axescolor=black        color of axes					

 gridcolor=black        color of grid					

 axeswidth=1            width (in points) of axes			

 ticwidth=axeswidth     width (in points) of tic marks		

 gridwidth=axeswidth    width (in points) of grid lines		

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

                        seismic (axis 1 vertical, axis 2 horizontal)	



 curve=curve1,curve2,...  file(s) containing points to draw curve(s)   

 npair=n1,n2,n2,...            number(s) of pairs in each file         

 curvecolor=black,..    color of curve(s)                              

 curvewidth=axeswidth   width (in points) of curve(s)                  

 curvedash=0            solid curve(s), dash indices 1,...,11 produce  

                        curve(s) with various dash styles              



 Note:  linewidth=0.0 produces the thinest possible line on the output.	

 device.  Thus the result is device-dependent, put generally looks the	

 best for seismic traces.						



 The curve file is an ascii file with the points specified as x1 x2 pairs,

 one pair to a line.  A "vector" of curve files and curve colors may 

 be specified as curvefile=file1,file2,etc. and similarly		

 curvecolor=color1,color2,etc, and the number of pairs of values	

 in each file as npair=npair1,npair2,... .                             



 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 axeswidth

sub backcolor

sub bias

sub clip

sub curve

sub curvecolor

sub curvedash

sub curvefile

sub curvewidth

sub d1

sub d1num

sub d2

sub d2num

sub f1

sub f1num

sub f2

sub f2num

sub fill

sub grid1

sub grid2

sub gridcolor

sub gridwidth

sub hbox

sub label1

sub label2

sub labelfont

sub labelsize

sub linewidth

sub n1

sub n1tic

sub n2

sub n2tic

sub npair

sub perc

sub style

sub ticwidth

sub title

sub titlecolor

sub titlefont

sub titlesize

sub tracecolor

sub verbose

sub wbox

sub x1beg

sub x1end

sub x2

sub x2beg

sub x2end

sub xbox

sub xcur

sub ybox

sub get_max_index

max index = number of input variables -1