October 7, 1988

PAW version 1.04/01

1- A new command NTUPLE/READ is available:

 
         * /NTUPLE/READ  IDN FNAME [ FORMAT CHOPT ] 
 
            IDN        C 'Ntuple identifier'  
            FNAME      C 'File name'  
            FORMAT     C 'Format' D='*'  
            CHOPT      C 'Options' D=' '  
 
          To read Ntuple values from the alphanumeric file FNAME with 
          the format specifications in FORMAT.
          Before executing this command, the Ntuple IDN must have been
          created with the command Ntuple/Create.

This new command is particularly interesting for small or medium size Ntuples. The example below illustrates a possible usage of READ: Let us assume you have written a normal formatted text file with 5 variables per line and a few thousand events. The name of the file is "Example.dat". Now you are in PAW, and you want to create,fill and save the Ntuple onto a direct access file "Ntuple.dat". You can do:

 
        PAW> Histo/file 21 Ntuple.dat 1024 N
        PAW> Ntuple/create 10 'Testing READ' 5 TEST 1000  x y z pt Etot
        PAW> Ntuple/read 10 Example.dat
        PAW> Ntuple/plot 10.Etot

2- The commands VECTOR/READ and VECTOR/WRITE are doing more

Suppose you have the file "Example.dat" defined above: Typing:

 
         PAW> Vector/read x,y,z,pt,Etot   Example.dat

will read the file Example.dat in free format, filling 5 vectors named x,y,z,pt and Etot that will be automatically created by PAW with as many entries as there are lines in the file. Note that the comma "," between the vector names is obligatory. You cannot use a blank instead !

 
         PAW> Vector/write x,pt,Etot   Vdat.dat   3f15.6

writes the vectors x,pt and Etot onto an alphanumeric file with the format descriptor 3f15.6.

3- The command NULL is doing more

Up to now, the command NULL could only draw an empty frame without setting the scale and drawing axis values. NULL accepts now additional parameters:

 
         * /GRAPHICS/HPLOT/NULL  [ XMIN XMAX YMIN YMAX CHOPT ] 
 
           XMIN       R 'Low range in X' D=0  
           XMAX       R 'High range in X' D=1  
           YMIN       R 'Low range in Y' D=0  
           YMAX       R 'High range in Y' D=1  
           CHOPT      C 'Options' D=' ' R=' ,S,A'

Draw a frame box only (null histogram without axes) if no parameters are specified. If XMIN,XMAX,etc are given, draw a frame box with the window coordinates set to XMIN,XMAX,YMIN,YMAX. Axis labels and tick marks are drawn by default. If option 'S' is also specified, this command is a convenient way to redefine the scale for the current zone. If the option A is given, then axis labels and tick marks are not drawn.

4- Log scales

Function/plot can be used with a log-log scale. Commands TEXT and ITX can specify coordinates in log scale.

5- Changes in Hist/Copy command

In the case of a current directory set to a disk file, the effect of:

          PAW> Histo/copy id1 id2

was to store a copy of id1 and id2 in memory. Now only id2 is left in memory. Note that if id1 was already in memory, it is obviously not deleted by this command.

6- KUIP interface to SIGMA

SIGMA is now directly available in KUIP commands or macros via the new internal kuip function $SIGMA without entering the SIGMA system. The argument given in the function $SIGMA is the expression to be evaluated by SIGMA. The result may be a scalar or a vector. Ex:

          PAW > vector/create x(2) r $sigma(sqrt(2)) $sigma(sqrt(3))
          PAW > vector/print x
                X (    1 ) =   1.414214    
                X (    2 ) =   1.732051
          PAW > sigma w=array(100,0#100)
          PAW > vector/draw w
          PAW > vector/draw $sigma(sqrt(w))

7- Changes in plotting surfaces

The HPLOT routine HPLSUR now draws the axis on the picture. Users of the command SURFACE will also observe some changes in the scale of surfaces.

8- New option 'A' in Histo/Plot

If the option 'A' is given, Axis labels and tick marks are not drawn.

9- Usual minor improvements

A few inconsistencies and bugs have been corrected in all packages. Note that in KUIP commands the vertical bar | is the in-line comment character. A line starting with * (or |) is treated as a comment line.