SYNOPSIS
PERL PROGRAM NAME:
AUTHOR: Juan Lorenzo (Perl module only)
DATE:
DESCRIPTION:
Version:
USE
NOTES
Examples
SYNOPSIS
SEISMIC UNIX NOTES PSGRAPH - PostScript GRAPHer
Graphs n[i] pairs of (x,y) coordinates, for i = 1 to nplot.
psgraph n= [optional parameters] <binaryfile >postscriptfile
Required Parameters:
n array containing number of points per plot
Data formats supported:
1.a. x1,y1,x2,y2,...,xn,yn
b. x1,x2,...,xn,y1,y2,...,yn (must set pairs=0)
2. y1,y2,...,yn (must give non-zero d1[]=)
3. x1,x2,...,xn (must give non-zero d2[]=)
4. nil (must give non-zero d1[]= and non-zero d2[]=)
The formats may be repeated and mixed in any order, but if
formats 2-4 are used, the d1 and d2 arrays must be specified including
d1[]=0.0 d2[]=0.0 entries for any internal occurences of format 1.
Similarly, the pairs array must contain place-keeping entries for
plots of formats 2-4 if they are mixed with both formats 1.a and 1.b.
Also, if formats 2-4 are used with non-zero f1[] or f2[] entries, then
the corresponding array(s) must be fully specified including f1[]=0.0
and/or f2[]=0.0 entries for any internal occurences of format 1 or
formats 2-4 where the zero entries are desired.
Available colors are all the common ones and many more. The complete
list of 68 colors is in the file $CWPROOT/src/psplot/basic.c.
Optional Parameters:
nplot=number of n's number of plots
d1=0.0,... x sampling intervals (0.0 if x coordinates input)
f1=0.0,... first x values (not used if x coordinates input)
d2=0.0,... y sampling intervals (0.0 if y coordinates input)
f2=0.0,... first y values (not used if y coordinates input)
pairs=1,... =1 for data pairs in format 1.a, =0 for format 1.b
linewidth=1.0,... line widths (in points) (0.0 for no lines)
linegray=0.0,... line gray levels (black=0.0 to white=1.0)
linecolor=none,... line colors; none means use linegray
Typical use: linecolor=red,yellow,blue,...
lineon=1.0,... length of line segments for dashed lines (in points)
lineoff=0.0,... spacing between dashes (0.0 for solid line)
mark=0,1,2,3,... indices of marks used to represent plotted points
marksize=0.0,0.0,... size of marks (0.0 for no marks)
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=normal normal (axis 1 horizontal, axis 2 vertical) or
seismic (axis 1 vertical, axis 2 horizontal)
reverse=0 =1 to reverse sequence of plotting curves ", /* JGHACK
Note: n1 and n2 are acceptable aliases for n and nplot, respectively.
mark index:
1. asterisk
2. x-cross
3. open triangle
4. open square
5. open circle
6. solid triangle
7. solid square
8. solid circle
All color specifications may also be made in X Window style Hex format
example: axescolor=#255
Example:
psgraph n=50,100,20 d1=2.5,1,0.33 <datafile >psfile
plots three curves with equally spaced x values in one plot frame
x1-coordinates are x1(i) = f1+i*d1 for i = 1 to n (f1=0 by default)
number of x2's and then x2-coordinates for each curve are read
sequentially from datafile.
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 d1
sub d1num
sub d2
sub d2num
sub f1
sub f1num
sub f2
sub f2num
sub grid1
sub grid2
sub gridcolor
sub gridwidth
sub hbox
sub i
sub label1
sub label2
sub labelfont
sub labelsize
sub linecolor
sub linegray
sub lineoff
sub lineon
sub linewidth
sub mark
sub marksize
sub n
sub n1tic
sub n2tic
sub nplot
sub pairs
sub reverse
sub style
sub ticwidth
sub title
sub titlecolor
sub titlefont
sub titlesize
sub wbox
sub x1beg
sub x1end
sub x2beg
sub x2end
sub xbox
sub ybox
sub get_max_index
max index = number of input variables -1