April 03, 1989
PAW version 1.05/04
1- PAW improvements
================
** NOTE the following IMPORTANT CHANGE <=============
===================================
Let us consider the following old PAW session:
When the Current Directory was set to a file, the Histo/Plot ID
command and all others working with histograms/Ntuples,
stored a copy of ID into the current directory in memory //PAWC.
If Histo/Plot ID was again invoked, then PAW was plotting
the ID already in memory.
PAW >Histo/file 1 myfile.dat | The file contains ID=10
PAW >Histo/Plot 10 | ID=10 read from file and plotted
PAW >H/Plot 10 | ID=10 is plotted directly from //PAWC
PAW >Gauss 10 | Make a Gaussian fit on //PAWC/10
PAW >H/Plot 10 | Shows the result of fit from //PAWC/10
With the new PAW, every time Histo/Plot ID is invoked,
a copy of the ID from the file is stored in memory, possibly
replacing an old copy of the same ID. Therefore, if one wants
to make an operation on ID, one has to change first the
Current Directory to memory.
PAW >Histo/file 1 myfile.dat | The file contains ID=10
PAW >Histo/Plot 10 | ID=10 read from file and plotted
PAW >H/Plot 10 | ID=10 read again from file and plotted
PAW >Gauss 10 | read from file,Make a Gaussian fit on //PAWC/10
PAW >H/Plot //PAWC/10 | Plot the current copy of ID in memory
PAW >CD //PAWC | Change Current Directory to //PAWC
PAW >H/Plot 10 | Plot the current copy of ID in memory
PAW >CD //LUN1 | Change directory back to file.
This new feature which has been requested by many users,
in particular in a real time environment, may have some
side-effects in macros. BE CAREFUL !
Example of side-effect: Current directory is //LUN1
The following command ADD 10 20 30
creates a new histogram 30 in //PAWC. To see the result
of the operation type Histo/Plot //PAWC/30
or CD //PAWC and then Histo/plot 30.
** A new menu /NETWORK has been introduced. It contains
2 commands RLOGIN and RSHELL.
RLOGIN starts a communication with a PAW/ZEBRA server
running on a remote host.
RSHELL send a command to the remote server.
A PAW user sitting on a workstation can open a HBOOK file
on the remote host and plot histograms one by one
without transferring the complete file. This has been
designed to work in an heterogeneous environment.
These 2 commands are currently available for tests purposes
on APOLLO only. The current implementation is based
on TCP/IP and works between APOLLOs, VAX, IBM
and OS9 (OPAL configuration).
It is intended to implement in the near future this facility
to all systems mentioned above and also the CRAY.
Example
PAW> Rlogin vxcrna
PAW> Rshell file disk$dl:[brun]gexam1.hist
PAW> Rshell list
PAW> Histo/plot 10
** The Ntuple/Plot command is faster in
Nt/Plot idn.var selection -ID
where ID is an already existing histogram with user
defined binning.
More information given in Command Ntuple/plot.
** Plotting of the CUT string working for Legos/Contours.
In the command GRAPH, the maximum number of points
when in a LOG scale has been changed from 200 to 800.
** The LOCATE command returns in addition:
- the content of the channel for 1-D histogram
- the content of the cell for 2-D plots
** New routines and functions callable from COMIS
(See list with HELP CALL).
** A new command PAVE added to the menu PRIMITIVES:
* /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.400000006
ISBOX I 'Box style' D=0
ISFRAM I 'Frame style' D=5
CHOPT C 'Character option' D='TR'
To draw a paving-block (box with 3D effect). Useful for slides.
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.
By default the Top and the Right frame are drawn. CHOPT='TR'.
CHOPT='TL' Top and Left frame
CHOPT='BR' Bottom and Right frame
CHOPT='BL' Bottom and Left frame
CHOPT='T' same as 'TR', 'B' same as 'BR'
CHOPT='L' Left frame only, 'R' right frame only.
CHOPT='T-' Top frame only pointing left.
CHOPT='B-' Bottom frame only pointing left.
2- KUIP improvements
=================
======> A new style 'P' (Panel) has been introduced. It can only be
used on workstations. A panel is useful for commands which are
frequently entered.
* /KUIP/SET_SHOW/PANEL [ LINE GKEY ]
LINE R 'Line number' D=9999
GKEY C 'Graphics key value(s)' D=' '
Set up the panel of graphics keys (used by STYLE GP).
Examples:
PANEL | draw the panel
PANEL 0 | reset the panel
PANEL 2 A/L QUIT V/L | initialise line 2 with 3 graphics keys,
respectively A/L, QUIT, V/L
PANEL 2 A/L ' ' V/L ' ' ' ' | initialise line 2 with 5 graphics keys,
and fill 1st and 3rd keys
PANEL 2.04 MESSAGE | initialise 4th key of 2nd line to MESSAGE
PANEL 2.04 | clear 4th key of 2nd line
PANEL -2.08 | initialise line 2 with 8 graphics keys
PANEL -6.16 | initialise line 6 with 16 graphics keys
Note that the key number on the right of the decimal point must
always be defined with two digits.
Panel initialisation, like the two last examples, is not mandatory.
For example if a panel is reset and then PANEL 3.05 STRING is entered,
then 2 empty lines (in fact with just one blank key) are created above
the 3rd one, which is created with 5 keys (the first 4 are blank).
Try to enter for example the following commands :
PANEL 1 al/l vec/l m/li- m/li test-- ' '
PANEL 2 - message shell-
STYLE GP
Move now the mouse around the boxes, and click with the left mouse button
when the locator is on the graphics key you want to execute. The box will
change to reverse video until the command is completed. To exit from any
graphics style (G, GP, etc.) click on the right mouse button.
Key values are drawn (and sent for execution) in the same upper/lower case
of their definition. As usual in KUIP, if the value of a key contains blank
characters, it must be enclosed in single quotes. All others rules for
command lines syntax and special characters apply as well. Examples:
PANEL 1.02 'Message This is a message '
PANEL 1.03 'Message @'This is a message between quotes@''
PANEL 1.04 Vec/List
PANEL 1.05 'VEC/PRI VECX'
If the value of a key terminates with one minus sign, a parameter window
is opened automatically and the user has to type the parameter(s)
terminated by a carriage return. The final string sent for execution
will not contain the last character of the key (the minus) and a blank
will be added between the key and the parameter(s). Example:
PANEL 1.03 'VEC/PRI-' | entering VAB will execute VEC/PRI VAB
If the value of a key terminates with two minus signs, the result is the
same as in case of one minus sign, but no blank is added between the key
and the parameter(s), allowing the insertion of the last part of a parameter.
Example:
PANEL 1.03 'VEC/PRI V--' | entering AB will execute VEC/PRI VAB
Maximum values for the key layout are currently :
1 panel, 10 lines/panel, 30 keys/line, 32 characters/key
=====> HELP improvements
If the option HELP -E is selected (in PAWLOGON for example)
then the text for HELP command is sent to the local editor
instead of standard output. This is useful for long HELPs
which cannot fit on a 24 lines terminal.
HELP -E is the default on Apollos and will be become
the default on VM if we receive favourable comments.
HELP -NE switch to the HELP on standard output.
=====> A UNIX like history mode has been introduced.
To use it, you can change the prompt via:
Prompt 'PAW []'
Now type ! (This shows the previous commands with a number)
Typing !9 executes the command 9
=====> Some bugs fixed
3- HPLOT improvements
==================
You can superimpose a contour-plot on an existing picture.
Set the number of contours to a negative value.
The options DATE,TIME and FILE are working for legos/contours.
The size of characters for the option STAT can be changed
by SET CSIZ value . (the default value for one zone).
This value is automatically scaled with the number of zones
along X.
Commands SYMBOL and ERRORS allow plotting outside the zone
boundaries.
4- HIGZ improvements
=================
A 3-D version of HIGZ is available. It is not currently
used by PAW (it will be). It offers like the 2-D version
an interface to the basic GKS-3D primitives and segmentation.
In addition high-level routines to draw various shapes
(a la GEANT) are available.
An interface to the DI3000 package has been included
into the new PAMfile. It has been developed by
H.Johnstad from FNAL. PAW versions distributed in the USA
are in general based on DI3000.
A new option (called MAIL) has been included into the PAM.
The MAIL option gives the following possibilities:
The application program runs for example on a mainframe
and the user wants to get the graphics output on his
workstation in a window separated from the alphanumeric
window
This is somehow similar to the terminal emulators (TEK4014 like)
but is much faster and one can exploit all the graphics
features of the workstation.
This facility is currently released on the APOLLOS only and is
based on TELNET. Both Graphics Output and Input are supported
by this HIGZ emulator.
PAW users who have Personal Computers on which the TELNET system
is available could take advantage of this powerful emulator.
5- HBOOK improvements
=================
Some bugs have been corrected.
New options 'F1' and 'F2' in HDIFF (PAW command DIFF).
New option 'I' in HPDIR to print an INDEX a la HINDEX.
See CNL 194 for more information.
6- Usual minor improvements
========================
Paw.Support@cern.ch
