A new version of PAW (2.06/20) has been released today 28 March together with CERNLIB 95A. The source files, binaries and libraries will be available, via anonymous ftp, on the asis system.
The PAW Team is:
In the file the following subjects can be found:
This release is a bug fixes and consolidation release. We intend to continue this effort of reliability and better documentation in the next releases also. In this release some importants points are:
More details are given in this file.
* KUIP/VERSION
Print the version string for PAW and the underlying packages.
* NTUPLE/HMERGE OUTFILE INFILES
OUTFILE C 'Output file name' D=' '
INFILES C 'Input file names' D=' ' Vararg
Merge HBOOK files containing histograms and/or ntuples. Ntuples are merged
and histograms with the same ID are added. The INFILES are merged into a
new file OUTFILE. If OUTFILE already exists, it is overwritten.
Note that if there is a histogram in PAW memory that has the same
identifier as a histogram in one of the files to be merged, then the
contents of the histogram in memory are added to those of the histogram in
the file. This can be avoided by deleting the memory histogram (using
H/DEL) before issuing the HMERGE command.
* NTUPLE/DUPLICATE ID1 ID2 [ NEWBUF TITLE OPTION ]
ID1 C 'Source Ntuple'
ID2 I 'New Ntuple'
NEWBUF I 'Buffer size' D=-1
TITLE C 'Title of ID2' D=' '
OPTION C 'Options' D='A'
Possible OPTION values are:
' '
A Set the Addresses of variables in common /PAWCR4,etc/.
M Create ID2 as a Memory resident Ntuple.
' ' Copy ID1 structure in ID2. Reset addresses of variables.
The structure of Ntuple ID1 is duplicated in a new ntuple ID2. This
command is useful when one wants to create an ntuple with the same
variables but only a subset of the events. NEWBUF is the buffer size for
ID2. If NEWBUF<0 the buffer size of ID1 is taken. If NEWBUF=0 the current
buffer size is taken (10000 words for RWNs). NEWBUF>0 will be the new
buffer size. If TITLE=' ' ID2 has the same title as ID1. In case of a
disk-resident ntuple (default), ID2 is created into the current working
directory which must be open in WRITE mode.
Example with a Row Wise Ntuple:
Macro DUPRWN
Close 0
Hi/File 1 source.hbook
Hi/File 2 new.hbook ! N
Nt/Dup //lun1/30 2
*
Application Comis Quit
Real Function Dup(dum)
Include ?
If (X.gt.0..Or.Y.gt.0.) call hfn(2,X)
dup=1.
end
Quit
*
nt/loop //lun1/30 dup
hrout 2
Note that the statement "include ?" allows to create automatically the
inlude file (comis.inc) corresponding to the ntuple structure. The command
UWFUNC is not required in this case.
Example with a Column Wise Ntuple:
Macro DUPCWN
*
Close 0 | Close all the currently opened file
H/file 1 source.hbook
Uwfunc //lun1/1 source.inc | generate source.inc
H/file 2 new.hbook ! N | Create a new hbook file
Nt/Dup //lun1/1 2 | Duplicate the ntuple 1 in the ntuple 2
*
* Comis routine which Loop on all events of Id1 and select some events
* to be written in the new ntuple Id2.
*
Application COMIS quit
Subroutine ntdup(Id1,Id2)
Include 'source.inc'
Call Hnoent(Id1,Noent)
Do Ievent=1,Noent
Call Hgnt(Id1,Ievent,Ierr)
If (Ierr.ne.0) Goto 20
If (X.Gt.0..Or.Y.Gt.0.) Then
Call Hfnt(Id2)
Endif
Enddo
20 Continue
*
End
Quit
*
Call Ntdup(1,2) | Execute the routine Ntdup
Hrout 2 | Write Id2 on disk
* GRAPHICS/PRIMITIVES/PLINE N X Y
N I 'Number of points'
X C 'Vector name for X coordinates'
Y C 'Vector name for Y coordinates'
Draw a polyline of N points X,Y in the current Normalization
transformation. The PLINE attributes can be changed with the command SET.
Example:
SET * ; OPT * | Reset the defaults
NUL -1 1 0 1 | Draw a frame (cf HELP NULL)
* Create vector X and Y (cf HELP SIGMA)
SIGMA X=ARRAY(100,-1#1)
SIGMA Y=X*X
SET PLCI 4 | The line color is blue
SET LWID 6 | The line width is 6
SET LTYP 2 | The line type is dashed
PLINE 100 X Y | Draw a 100 points line
* GRAPHICS/PRIMITIVES/LINE X1 Y1 X2 Y2
X1 R 'X first coordinate'
Y1 R 'Y first coordinate'
X2 R 'X second coordinate'
Y2 R 'Y second coordinate'
Draw a line connecting points (X1,Y1) and (X2,Y2) in the current
Normalization transformation. This command is kept for backward
compatibility. It has a reverse calling sequence compare to BOX or ARROW
and it doesn't take LOG scales into account. It is recommended to use DLINE
instead. The LINE attributes can be changed with the command SET.
Example:
SET * ; OPT * | Reset the defaults
NUL 0 5 0 5 | Draw a frame (cf HELP NULL)
SET PLCI 2 | The line color is red
SET LWID 6 | The line width is 6
SET LTYP 3 | The line type is dotted
LINE 0 0 5 5 | Draw a line
* GRAPHICS/PRIMITIVES/DLINE X1 X2 Y1 Y2
X1 R 'X first coordinate'
X2 R 'X second coordinate'
Y1 R 'Y first coordinate'
Y2 R 'Y second coordinate'
Draw a line connecting points (X1,Y1) and (X2,Y2) in the current
Normalization transformation taking care of logarithmic scales. The DLINE
attributes can be changed with the command SET.
Example:
SET * ; OPT * | Reset the defaults
OPTION LOGY | Log scale on the Y axis.
NUL 0 5 1 100 | Draw a frame (cf HELP NULL)
SET PLCI 2 | The line color is red
SET LWID 6 | The line width is 6
SET LTYP 1 | The line type is solid
DLINE 0 5 1 10 | Draw a line
* GRAPHICS/PRIMITIVES/FAREA N X Y
N I 'Number of points'
X C 'Vector name for X coordinates'
Y C 'Vector name for Y coordinates'
Fill the area defined by the N points X,Y in the current Normalization
transformation. The FAREA attributes can be changed with the command SET.
Example:
SET * ; OPT * | Reset the defaults
NUL -1.1 1.1 -1.1 1.1 | Draw a frame (cf HELP NULL)
* Create vector X and Y (cf HELP SIGMA)
SIGMA X=ARRAY(100,-3.14#3.14)
SIGMA Y=SIN(X)*COS(X)
SIGMA X=COS(X)
SET FACI 2 | The fill area color is red
SET FAIS 1 | The fill area interior style is solid
FAREA 100 X Y | Draw a 100 points line
SET FACI 1 | The fill area color is black
SET FAIS 0 | The fill area interior style is hollow
FAREA 100 X Y | Draw a 100 points line
SET FAIS 3 | The fill area interior style is hatched
SET FASI 245 | Defines the type of hatches
FAREA 100 X Y | Draw a 100 points line
* GRAPHICS/PRIMITIVES/PMARKER N X Y
N I 'Number of points'
X C 'Vector name for X coordinates'
Y C 'Vector name for Y coordinates'
Draw polymarkers at the N points X,Y in the current Normalization
transformation. The PMARKER attributes can be changed with the command
SET.
Example:
SET * ; OPT * | Reset the defaults
NUL -3.2 3.2 -1 1 | Draw a frame (cf HELP NULL)
* Create vector X and Y (cf HELP SIGMA)
SIGMA X=ARRAY(100,-3.14#3.14)
SIGMA Y=SIN(X)*COS(X)
SET PMCI 6 | The marker color is magenta
SET MTYP 3 | The marker type is *
SET MSCF 2 | The marker size is 2
PMARKER 100 X Y | Draw a 100 points polymarker
* GRAPHICS/PRIMITIVES/BOX X1 X2 Y1 Y2
X1 R 'X coordinate of first corner'
X2 R 'X coordinate of second corner'
Y1 R 'Y coordinate of first corner'
Y2 R 'Y coordinate of second corner'
Draw and fill a box with the current fill area and line attributes. Use
the current Normalization transformation. The BOX attributes can be
changed with the command SET.
Example:
SET * ; OPT * | Reset the defaults
NULL 0 10 0 10 | Draw a frame (cf HELP NULL)
SET FAIS 0 | Fill area interior style hollow
BOX 1 3 1 3 | Draw a box
SET FAIS 1 | Fill area interior style solid
BOX 1 3 3 5 | Draw a box
SET FAIS 3 | Fill area interior style hatched
SET FASI 245 | Changes the type of hatches
BOX 1 3 5 7 | Draw a box
SET FASI 3 | Changes the type of hatches
BOX 3 5 5 7 | Draw a box
SET BORD 1 | The border is requested
SET PLCI 2 | Line color is red
SET FASI 4 | Changes the type of hatches
BOX 5 7 5 7 | Draw a box
* GRAPHICS/PRIMITIVES/FBOX X1 X2 Y1 Y2 X3 X4 Y3 Y4
X1 R 'X coord of first corner of ext box'
X2 R 'X coord of second corner of ext box'
Y1 R 'Y coord of first corner of ext box'
Y2 R 'Y coord of second corner of ext box'
X3 R 'X coord of first corner of int box'
X4 R 'X coord of second corner of int box'
Y3 R 'Y coord of first corner of int box'
Y4 R 'Y coord of second corner of int box'
Draw and fill a frame (2 nested boxes) with the current fill area and line
attributes. Use the current Normalization transformation. The FBOX
attributes can be changed with the command SET.
Example:
SET * ; OPT * | Reset the defaults
NULL 0 10 0 10 | Draw a frame (cf HELP NULL)
SET FAIS 3 | Fill area interior style hatched
SET FASI 3 | Changes the type of hatches
SET FACI 2 | Fill are color is red
SET PLCI 4 | Line color is blue
SET LWID 8 | The line width is 8
SET BORD 1 | The border is requested
FBOX 1 9 1 9 3 7 3 7 | Draw a frame box
* GRAPHICS/PRIMITIVES/ARROW X1 X2 Y1 Y2 [ SIZE ]
X1 R 'X coordinate of start point'
X2 R 'X coordinate of end point'
Y1 R 'Y coordinate of start point'
Y2 R 'Y coordinate of end point'
SIZE R 'Arrow size' D=0.4
Draw an arrow Use the current Normalization transformation. The ARROW
attributes can be changed with the command SET. ARROW and LINE attributes
are the same.
(X1,Y1) ----> (X2,Y2) if SIZE>0.
(X1,Y1) <---> (X2,Y2) if SIZE<0.
Example:
SET * ; OPT * | Reset the defaults
NULL 0 10 0 7 | Draw a frame (cf HELP NULL)
ARROW 1 9 1 1 .2 | Draw a simple arrow (left to right)
ARROW 9 1 2 2 .4 | Draw a simple arrow (right to left)
ARROW 1 9 3 3 -.8 | Draw a double arrow
SET PLCI 2 | Arrow color is red
ARROW 1 9 4 4 -.8 | Draw a double arrow
SET LWID 8 | Arrow line width is 8
ARROW 1 9 5 5 -.8 | Draw a double arrow
SET LTYP 3 | Arrow line type is dotted
ARROW 1 9 6 6 -.8 | Draw a double arrow
* GRAPHICS/PRIMITIVES/HELIX [ X1 Y1 X2 Y2 R WI PHI ]
X1 R 'X coordinate of the begin of helix' D=0.
Y1 R 'Y coordinate of the begin of helix' D=0.
X2 R 'X coordinate of the end of helix' D=10.
Y2 R 'Y coordinate of the end of helix' D=10.
R R 'Radius of helix' D=.3
WI R 'Number of turns ' D=1.
PHI R 'Projection angle ' D=15.
Draw an helix with the current line attributes. Use the current
Normalization transformation. Feynman graph: gluon phi = 30, photon phi =
0.
Example:
SET * ; OPT * | Reset the defaults
NUL 0 10 0 10 'AB' | Draw a frame (cf HELP NULL)
HELIX 1 1 3 3 ! 10 ! | Draw an helix
SET LWID 8 | Helix line width is 8
HELIX 3 3 7 7 1 5 ! | Draw an helix
SET PLCI 2 | Arrow color is red
SET LTYP 2 | Helix line type is dashed
HELIX 7 7 10 10 .2 5 10 | Draw an helix
* GRAPHICS/PRIMITIVES/ARCHELIX [ X1 Y1 X2 Y2 R WI PHI RL ]
X1 R 'X coordinate of the begin of helix' D=0.
Y1 R 'Y coordinate of the begin of helix' D=0.
X2 R 'X coordinate of the end of helix' D=10.
Y2 R 'Y coordinate of the end of helix' D=10.
R R 'Radius of helix' D=.3
WI R 'Number of turns ' D=1.
PHI R 'Projection angle ' D=30.
RL R 'Radius of loop ' D=15.
Draw an archelix with the current line attributes. Use the current
Normalization transformation. Feynman graph: gluon phi = 30, photon phi =
0.
Example:
SET * ; OPT * | Reset the defaults
NUL 0 10 0 10 'AB' | Draw a frame (cf HELP NULL)
ARCHELIX 1 1 3 3 ! 9 ! 1 | Draw an helix
SET LWID 8 | Helix line width is 8
ARCHELIX 3 3 7 7 ! 9 ! 1 | Draw an helix
SET PLCI 2 | Arrow color is red
SET LTYP 2 | Helix line type is dashed
ARCHELIX 7 7 10 10 ! 9 ! 3 | Draw an helix
* GRAPHICS/PRIMITIVES/ARLINE [ X1 Y1 X2 Y2 H ]
X1 R 'X coordinate of the begin' D=0.
Y1 R 'Y coordinate of the begin' D=0.
X2 R 'X coordinate of the end' D=10.
Y2 R 'Y coordinate of the end' D=10.
H R 'arrow size' D=.5
Draw a line with arrow in middle (fermion line) with the current line and
fill area attributes. Use the current Normalization transformation.
Example:
SET * ; OPT * | Reset the defaults
NULL 0 10 0 6 | Draw a frame (cf HELP NULL)
ARLINE 1 1 9 1 .2 | Draw a arrow line (left to right)
ARLINE 9 2 1 2 .4 | Draw a arrow line (right to left)
SET PLCI 2 | Arrow color is red
SET FAIS 1 | Fill area interior style solid
ARLINE 9 3 1 3 .4 | Draw a arrow line (right to left)
SET LWID 8 | Arrow line width is 8
SET FACI 4 | The fill area color is blue
ARLINE 9 4 1 4 .4 | Draw a arrow line (right to left)
SET LTYP 3 | Arrow line type is dotted
ARLINE 9 5 1 5 .4 | Draw a arrow line (right to left)
* GRAPHICS/PRIMITIVES/FPOINT [ X Y R ]
X R 'X ' D=0.
Y R 'Y ' D=0.
R R 'Radius ' D=.5
Draw a filled point (vertex) with the current fill area attributes. Use
the current Normalization transformation.
Example:
SET * ; OPT * | Reset the defaults
NULL 0 10 0 10 | Draw a frame (cf HELP NULL)
SET FAIS 1 | Fill area interior style solid
FPOINT 5 1 .1 | Draw a filled point
FPOINT 5 3 .2 | Draw a filled point
FPOINT 5 5 .3 | Draw a filled point
SET FACI 4 | The fill area color is blue
FPOINT 5 7 .4 | Draw a filled point
FPOINT 5 9 .5 | Draw a filled point
* GRAPHICS/PRIMITIVES/AXIS X0 X1 Y0 Y1 WMIN WMAX NDIV [ CHOPT ]
X0 R 'X axis origin in WC'
X1 R 'X end axis in WC'
Y0 R 'Y axis origin in WC'
Y1 R 'Y end axis in WC'
WMIN R 'Lowest value for labels'
WMAX R 'Highest value for labels'
NDIV I 'Number of divisions' D=510
CHOPT C 'Options' D=' ' Minus
Possible CHOPT values are:
' ' Draw an axis with default values.
G Logarithmic scale, default is linear.
B Blank axis. Useful to superpose axis.
U Unlabeled axis, default is labeled.
+ Tick marks are drawn on Positive side. (default)
- Tick marks are drawn on the negative side.
= Tick marks are drawn on Equal side
P Labels are drawn Parallel to the axis
O Labels are drawn Orthogonal to the axis (Top to Down).
0 Labels are drawn Orthogonal to the axis (Down to Top).
R labels are Right adjusted on tick mark.
L labels are Left adjusted on tick mark.
C labels are Centered on tick mark.
M In the Middle of the divisions.
Y Direction of labels DOWN . Default is RIGHT
. Dot obligatory
T Alphanumeric labels .
S Tick marks Size
H Labels Height
D Distance labels-axis
N No bining optimization
I Integer labeling
Draw an axis in the current Normalization transformation.
NDIV=N1 + 100*N2 + 10000*N3
N1, N2, N3 = Number of 1st, 2nd, 3rd divisions respectively, eg:.
NDIV=0 --> no tick marks.
NDIV=2 --> 2 divisions, one tick mark in the middle
of the axis.
Orientation of tick marks on axis: Tick marks are normally drawn
on the positive side of the axis.However, if X0=X1, then Negative .
CHOPT='+': tick marks are drawn on Positive side. (default)
CHOPT='-': tick marks are drawn on the negative side.
i.e: '+-' --> tick marks are drawn on both sides of the axis.
Position of labels on axis: Labels are normally drawn on side
opposite to tick marks.However:
CHOPT= '=' on Equal side
Orientation of labels on axis: Labels are normally drawn
parallel to the axis. However if X0=X1, then Orthogonal
if Y0=Y1, then Parallel
CHOPT= 'P' : Parallel to the axis
CHOPT= 'O' : Orthogonal to the axis (Top to Down).
CHOPT= '0' : Orthogonal to the axis (Down to Top).
Position of labels on tick marks: Labels are centered on
tick marks. However , if X0=X1, then they are right adjusted.
CHOPT='R': labels are Right adjusted on tick mark.
(default is centered)
CHOPT='L': labels are Left adjusted on tick mark.
CHOPT='C': labels are Centered on tick mark.
CHOPT='M': In the Middle of the divisions.
Direction of labels: Default is RIGHT
CHOPT='Y': Down
Format of labels: Blank characters are stripped, and then the
label is correctly aligned. The dot,if last character of the
string, is also stripped, unless
CHOPT='.' Dot obligatory
In the following, we have some parameters, like
tick marks length and characters height (in percentage
of the length of the axis).The default values are as follows:
Primary tick marks: 3.0 %
Secondary tick marks: 1.5 %
Third order tick marks: .75 %
Characters height for labels: 2%
Characters spacing (related to height): 40%
Labels offset: 4.0 %
Type of labels: Labels are normally numeric . However, alphanumeric
labels can be drawn (see command LABEL).
CHOPT='T': Alphanumeric labels .
Intrinsic parameters: These values can be changed with the command
SET. The default value is used unless the corresponding option is
selected by CHOPT:
CHOPT='D' The distance between the labels and the axis
(the offset) is given by the preceding command
SET with the parameter LAOF.
CHOPT='H' The size (height) of the labels is given by the
preceding command SET with the parameter LASI.
CHOPT='S' The size of the tick marks is given by the preceding
command SET with the parameter TMSI.
Axis bining optimization: By default the axis bining is optimized .
CHOPT='N': No bining optimization
CHOPT='I': Integer labeling
Example:
SET * ; OPT * | Reset the defaults
NUL 0 12 0 12 'A' | Draw a frame (cf HELP NULL)
AXIS 1 11 1 1 0 100 510 'A' | Axis with arrow
AXIS 1 11 3 3 1 10000 510 'G' | LOG axis
LABEL 1 11 a b c d e f g h i j k | define alphanumeric labels
AXIS 1 11 5 5 0 12 11 'NATY' | alphanumeric labeling
AXIS 1 11 6 6 -100 0 510 'A'
AXIS 11 1 7 7 -100 0 810 'A+-' | Double side tick marks
AXIS 1 11 8 11 0 1234567 615 'A' | exponent is required
* GRAPHICS/PRIMITIVES/ARC X1 Y1 R1 [ R2 PHIMIN PHIMAX ]
X1 R 'X coordinate of centre'
Y1 R 'Y coordinate of centre'
R1 R 'Inner radius'
R2 R 'Outer radius' D=-1.
PHIMIN R 'Minimum angle' D=0.
PHIMAX R 'Maximum angle' D=360.
Draw an arc of circle with the current fill area and line attributes. Use
the current Normalization transformation. If R1 is not equal to R2 the
area between the two arcs of radius R1 and R2 is filled according to the
current fill area attributes. The border is never drawn unless the
interior style is hollow or the command SET BORD 1 has been called. If R1
is equal to R2 a polyline is drawn.
Example:
SET * ; OPT * | Reset the defaults
NULL 0 20 0 20 'AB' | Draw a frame (cf HELP NULL)
SET PLCI 2 | Line color is red
SET LWID 6 | Line width is 6
ARC 5 5 4 4 ! ! | Draw an circle
ARC 5 15 4 4 30 260 | Draw an arc of circle
SET FAIS 3 | Fill area with hatches
SET FASI 3 | Type of hatches
ARC 15 15 1 4 ! ! | Draw an arc
SET BORD 1 | Border is requested
ARC 15 5 1 4 30 ! | Draw an arc
* GRAPHICS/PRIMITIVES/PIE X0 Y0 RADIUS N VALUES [ CHOPT IAO IAS IAC ]
X0 R 'X coordinate of centre of the pie'
Y0 R 'Y coordinate of centre of the pie'
RADIUS R 'Radius of the pie chart'
N I 'Number of values'
VALUES C 'Vector name for N values'
CHOPT C 'Options' D=' '
IAO C 'Name of vector with offsets' D=' '
IAS C 'Name of vector with styles' D=' '
IAC C 'Name of vector with colors' D=' '
Possible CHOPT values are:
' ' Draw a Pie Chart with default values.
C Colours array is present.
L Alphanumeric labels are required.
O Offset array is present.
N The label of each slice will be the corresponding numeric value in
array VALUES.
P The label of each slice will be in expressed in percentage.
S Style array is present.
H Force the labels size to be the current character height. Without this
option the labels size is computed automatically.
R Draw the labels aligned on the radius of each slice.
Draw a pie chart in the current Normalization transformation.
Example:
SET * ; OPT * | Reset the defaults
NULL 0 20 0 20 'AB' | Draw a frame
LABEL 1 5 'Lab1' 'Lab2' 'Lab3' 'Lab4' 'Lab5' | define labels
* Initialize vectors
V/CRE VWS(5) R 28.3 18.6 16.9 13.5 22.7
V/CRE OFFSET(5) R 2*0. 2*20. 0.
V/CRE COLOUR(5) R 2 3 4 5 6
SET FAIS 1 | Fill solid
SET BORD 1 | Draw the border
PIE 10. 10. 7. 5 VWS 'L' OFFSET ! COLOUR | Draw the pie chart
* GRAPHICS/PRIMITIVES/TEXT X Y TEXT SIZE [ ANGLE CHOPT ]
X R 'X coordinate'
Y R 'Y coordinate'
TEXT C 'Text to be drawn'
SIZE R 'Text size' D=0.3
ANGLE R 'Comment angle' D=0
CHOPT C 'Justification option' D='L'
Possible CHOPT values are:
L Text is Left justified.
C Text is Centered.
R Text is Right justified.
Draw text at position X,Y in the current normalization transformation using
the software font IGTEXT. SIZE is always given in centimeters (as defined
by the command SIZE). A boldface effect can be obtained using the
parameters PASS and CSHI of the command SET. The text color can be changed
by SET TXCI.
Example:
SET * ; OPT * | Reset the defaults
NULL 0 10 0 10 | Draw a frame
TEXT 5 1 'Left justified' .5 0. L
TEXT 5 2 'Centered' .5 0. C
TEXT 5 3 'Right justified' .5 0. R
TEXT 5 4 '-- 30 degrees' .5 30. L
TEXT 5 4 '-- 60 degrees' .5 60. L
TEXT 5 4 '-- 90 degrees' .5 90. L
TEXT 5 4 '-- 120 degrees' .5 120. L
TEXT 5 4 '-- 150 degrees' .5 150. L
TEXT 5 8 'Some Greek ... [a, b, c, d]' .5 0. C
Set PASS 7 | Number of passes
TEXT 5 9 'Bold TEXT' .5 0. C
* GRAPHICS/PRIMITIVES/ITX X Y TEXT
X R 'X coordinate'
Y R 'Y coordinate'
TEXT C 'Text to be drawn'
Draw text at position X,Y in the current Normalization transformation,
using the current font parameters. The font and the precision can be
changed by SET TXFP. The character size can be changed by SET CHHE. The
text color can be changed by SET TXCI. The text orientation can be changed
with SET TXAL. The text angle can be changed by SET TANG.
Example:
SET * ; OPT * | Reset the defaults
NULL 0 10 0 6 | Draw a frame
SET TXFP -20 | Times bold
SET CHHE .5 | Text size 0.5 cm
SET TXAL 10 | Horizontal align. Left
ITX 5 1 'Left justified'
SET TXAL 20 | Horizontal align. Center
ITX 5 2 'Centered'
SET TXAL 30 | Horizontal align. Right
ITX 5 3 'Right justified'
SET TXAL 12 | Vertical align. Top
ITX .2 4 'Top justified'
SET TXAL 13 | Vertical align. Middle
ITX .2 5 'Middle justified'
SET TXAL 0 | Default align.
SET TANG 30 | Angle 30 degrees
ITX 5 4 '-- 30 degrees --'
* GRAPHICS/PRIMITIVES/LABELS LABNUM NLABS CHLABS
LABNUM I 'Label identifier' D=1 R=1:9
NLABS I 'Number of labels' D=0 R=0:50
CHLABS C 'List of labels' D=' ' Vararg
Define a list of alphanumeric labels to be used by subsequent commands such
as PIE and AXIS. The position of the labels on the axis may be changed with
SET NDVX (NDVY).
Example:
SET * ; OPT * | Reset the defaults
ZONE 1 3
LABEL 1 3 AAAAA BBBBB CCCCC | Define labels
SET NDVX 3.15 | 3 div, lab id 1, 5=center on bin
NULL 0 10 0 1 | Draw a frame
SET NDVX 3.11 | 3 div, lab id 1, 1=center on tick
NULL 0 10 0 1 | Draw a frame
SET NDVX 3.18 | 3 div, lab id 1, 8=bottom -> up
NULL 0 10 0 1 | Draw a frame
A full description of the possible alignments is given in the PAW manual
(see NDVX in the index).
* GRAPHICS/PRIMITIVES/PAVE X1 X2 Y1 Y2 [ DZ ISBOX ISFRAM CHOPT ]
X1 R 'X bottom left corner of box'
X2 R 'X top right corner of box'
Y1 R 'Y bottom left corner of box'
Y2 R 'Y top right corner of box'
DZ R 'Box width' D=0.4
ISBOX I 'Box style' D=0
ISFRAM I 'Frame style' D=5
CHOPT C 'Option' D='TR'
Possible CHOPT values are:
TR Top and Right frame are drawn
TL Top and Left frame
BR Bottom and Right frame
BL Bottom and Left frame
L Left frame only
R Right frame only
T- Top frame only pointing left
B- Bottom frame only pointing left
S Shadow mode
K Key mode
Draw a paving-block (box with 3D effect). ISBOX (ISFRAM) may be
1000+ICOLOR where ICOLOR is the color index of the box (frame), otherwise
the style index. If ISBOX (ISFRAM) = 0, only the box contour is drawn with
the current polyline attributes.
Example:
SET * ; OPT * | Reset the defaults
NULL 0 10 0 10 | Draw a frame
PAVE 1 4 1 4 ! ! 1001 CHOPT=TRS
PAVE 5 9 1 4 ! ! 1001 CHOPT=BLS
PAVE 1 4 5 9 ! ! 3 CHOPT=TR
PAVE 5 9 5 9 ! ! 3 CHOPT=BL
* GRAPHICS/PRIMITIVES/HIST N X Y [ CHOPT ]
N I 'Number of values'
X C 'Vector name for X coordinates'
Y C 'Vector name for Y coordinates'
CHOPT C 'Options' D='AHW'
Possible CHOPT values are:
A X and Y axes are drawn (default).
H An histogram is drawn as a contour (default).
W The Window/Viewport parameters are automatically computed from the X
and Y values (default).
R The histogram is Rotated, i.e. the values in X are used for the
ordinate and the values in Y for the abscissa (default is the
contrary). If option R is selected (and option 'N' is not selected),
the user must give: 2 values for Y (Y(1)=YMIN and Y(2)=YMAX) N values
for X, one for each bin. Otherwise the user must give: N values for Y,
one for each bin. 2 values for X (X(1)=XMIN and X(2)=XMAX) If option
'N' is selected see below.
N Non equidistant bins (default is equidistant). The arrays X and Y must
be dimensioned as follows: If option R is not selected (default) then
give: (N+1) values for X (limits of bins). N values for Y, one for each
bin. Otherwise give: (N+1) values for Y (limits of bins). N values for
X, one for each bin.
F The area delimited by the histogram is filled according to the fill
area interior style and the fill area style index or colour index.
Contour is not drawn unless CHOPT='H' is also selected.
C A Smooth curve is drawn across points at the centre of each bin of the
histogram.
L A straight Line is drawn across points at the centre of each bin of the
histogram.
* A star is plotted at the center of each bin of the histogram.
P Idem as '*' but with the current marker.
B A Bar chart with equidistant bins is drawn as fill areas. (Contours are
drawn). The bar origin and the bar width can be controlled by the
routine SET using the options BARO and BARW respectively.
Draw an histogram defined by arrays X and Y. The number of components
needed in vectors X and/or in Y may be dependent upon the value of CHOPT
(see options 'R' and 'N'). To set Log scales in X and/or Y, use OPT
LOGX/LOGY. Note that when an option is specified, it is also necessary to
specify the options 'W' or 'HW' in order to start a new zone or/and draw
the axes.
Example
SET * ; OPT * | Reset the defaults
Zone 1 2
* This command needs vectors
V/CREATE Y(10) r 1 2 3 4 5 5 4 3 2 1
V/CREATE X(11) r 1 2 4 6 8 10 15 16 20 21 30
HIST 10 X Y 'WH' | Equidistant bins
HIST 10 X Y 'HWN' | Non Equidistant bins
* GRAPHICS/PRIMITIVES/GRAPH N X Y [ CHOPT ]
N I 'Number of values'
X C 'Vector name for X coordinates'
Y C 'Vector name for Y coordinates'
CHOPT C 'Options' D='ALW'
Possible CHOPT values are:
A X and Y axes are drawn (default).
L Every point is connected with a straight line. (default)
W The Window/Viewport parameters are automatically computed from the X
and Y values (default).
C The values in Y are plotted in the form of a smooth curve. A Spline
approximation algorithm is used.
F A fill area is drawn. If the option 'CF' is used the contour of the
fill area is smooth. The border of the fill area is drawn if the
command SET BORD 1 has been typed. The fill area type may be changed
via the SET parameters FASI and FASI
R The graph is Rotated, i.e. the values in X are used for the ordinate
and the values in Y for the abscissa (default is the contrary).
B A Bar chart with equidistant bins is drawn as fill areas. (Contours are
drawn). The bar origin and the bar width can be controlled by the
routine SET using the options BARO and BARW respectively.
* A star is plotted at every point.
P A marker is plotted at every point, according to current marker type
and polymarker colour index.
Draw a curve through a set of points. To set Log scales in X and/or Y, use
OPT LOGX/LOGY. Note that when an option is specified, it is also necessary
to specify the options 'AW' or 'ALW' in order to start a new zone or/and
draw the axes.
Example
SET * ; OPT * | Reset the defaults
ZONE 1 2
* This command needs vectors
V/CREATE Y(10) r 1 2 3 4 5 5 4 3 2 1
V/CREATE X(11) r 1 2 4 6 8 10 15 16 20 21
GRAPH 10 X Y 'WC*L' | Draw an "open" graph
SET FAIS 3 | Interior style: hatched
SET FASI 245 | Define hatches type
SET BORD 1 | Border requested
NULL 0 22 0 6 | define new scales
GRAPH 10 X Y 'CF*' | Draw an "closed" graph
Opt STAT
Set STAT 111110
H/pl 2 BOX
The two vertical lines in the stat part were drawn to short
* MACRO/GLOBAL/CREATE NAME [ VALUE TEXT ]
NAME C 'Variable name' Loop
VALUE C 'Initial value' D=' '
TEXT C 'Comment text' D=' '
Create a global variable.
If used inside a macro the variable [name] is declared as global.
* MACRO/GLOBAL/IMPORT NAME
NAME C 'Variable name' Loop
Import global variables.
If used inside a macro the variables listed are declared as global. The
name may contain '*' as a wildcard matching any sequence of characters.
* MACRO/GLOBAL/DELETE NAME
NAME C 'Variable name' Loop
Delete global variables.
The global variables listed are deleted. The name may contain '*' as a
wildcard matching any sequence of characters.
* MACRO/GLOBAL/LIST [ NAME FILE ]
NAME C 'Variable name' D='*'
FILE C 'Output file' D=' '
List global variables.
If a file name is specified the output is the list of GLOBAL/CREATE
commands to define the selected global variables. The default file
extension is .kumac.