March 14, 1994

PAW version 2.04/15

A new version of PAW (2.04/15) has been released on March 15th together with CERNLIB 94A. The source files the binaries and the libraries are available, via anonymous ftp, on the asis system.

New features and enhancements in this version are described below.

Start PAW
New PAW system functions
New PAW commands and options
PIAF
PAW miscellaneous
COMIS: New features
New HBOOK routines and options
Obsolete HBOOK routines
HBOOK: Improvements and bug fixes
HIGZ: New features, improvements and bug fixes
HPLOT: New features, improvements and bug fixes
KUIP: New features, improvements and bug fixes

Start PAW

It is now possible to pass the workstation type to PAW without being prompted.

     ex:  paw           default: you get the prompt "Give workstation type"
          paw  -w       no prompt. Use default workstation type
          paw  -w 3     no prompt. Use workstation type 3.

pawX11 can be invoked from the paw++ module also with the option w:

          /cern/new/bin/paw++ -w 2

New PAW system functions

$GRAFINFO('?TXFP') and '?TXAL' corrected to return value compatible with IGSET.
$GRAFINFO('TXFONT'), TXPREC, TXALIH, and TXALIV to return text font, precision, and horizontal and vertical alignment as separate values.
$RGBINFO(icol,'R'|'B'|'G') to return values from color * tables.
$HCDIR() to return current Hbook directory.

New PAW commands and options

VECTOR/FIT: New options "Z" and "W"

* VECTOR/FIT X Y EY FUNC [ CHOPT NP PAR STEP PMIN PMAX ERRPAR ]

W : Sets weights equal to 1. Default weights taken from the square root of the contents or from HPAKE/HBARX (PUT/ERRORS).
Z : the user is assumed to provide a COMIS routine FCN.F with his own fitting model. It is the user's responsibility to compute in FCN the quantity to be minimized. When the option 'Z' is selected, Vector/Fit does not produce a graphics output.

Example of a macro and FCN.F file:

       macro vfit
       v/read x,y,ey  vfit.dat
       v/cre step(3)
       v/cre pmin(3)
       v/cre pmax(3)
       v/cre err(3)
       v/cre par(1) r 4.e-2
       v/fit x(1:14) y(1:14) ey(1:14) fcn.f z 1 par step pmin pmax err
       v/pri err(1)
       return


      Subroutine fcn(N,X,Y,EY,NPAR,IFLAG,NPFITS)
*
*         User fitting model routine (chisquare technique is used)
*       X(N),Y(N),EY(N) arrays given to the Vector/Fit command
*       NPAR number of parameters
*       IFLAG Minuit flag indicating the MINUIT action
*
*       NPFITS output parameter containing the number of points used
*              in the fit
*
      DOUBLE PRECISION FITPAD(24),FITFUN
      COMMON/HCFITD/FITPAD,FITFUN
*
      dimension x(n),y(n),ey(n)
      fitfun=0.
      npfits=0
      do 10 i=1,n
         xu=x(i)
         cu=y(i)
         eu=ey(i)
         if(eu.gt.0.)then
            npfits=npfits+1
            f=fitpad(1)
            fitfun=fitfun+((cu-f)/eu)**2
         endif
  10  continue
      end

GRAPHICS/HPLOT/AERRORS and ERRORS: New option "0"

By default, the symbols are not drawn if they are one the edges of the plot: the option '0' allows to turn off this symbols clipping. See the help for more details.

NTUPLE/CUTS: New option "X"

In order to define graphical cuts using a tracking cross cursor. This is useful on some black and white Xterminal on the crosshair cursor is not visible.

NTUPLE/PLOT: With four variables, the color scale used is drawn.
NTUPLE/SCAN: Is able to process CWN ntuples with variable length events: PX(Ntrack).
GRAPHICS/PRIMITIVES/DLINE: New command

Draws a line taking care of log scales. The syntax is conform to BOX, ARROW etc ...

      * 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'

      Draws a line connecting points (X1,Y1) and (X2,Y2) in the current 
      Normalization transformation taking care of logarithmic scales. Use 
      commands SLN, SLWSC and SPLCI (or IGSET) to change line attributes.

GRAPHICS/MISC/LOCATE Has been modified.

The user can now invoke a user COMIS routine in locator mode. When a mouse button is pressed, the user routine is called and the user has access in the common block QUEST all the information return by the HPLOT routine HPLCHA. Example:

      +------------- File locate.f  -----------+
      |                                        |
      |     Subroutine LOCATE                  |
      |     Common /Quest/Iquest(100)          |
      |     Dimension Rquest(100)              |
      |     Equivalence(Iquest(1),Rquest(1))   |
      |     IButton = Iquest(80)               |
      |     Nt      = Iquest(81)               |
      |     Xwc     = Rquest(82)               |
      |     Ywc     = Rquest(83)               |
      |     Idh     = Iquest(84)               |
      |     Xloc    = Rquest(85)               |
      |     Yloc    = Rquest(86)               |
      |     Icx     = Iquest(87)               |
      |     Icy     = Iquest(88)               |
      |     XNdc    = Rquest(11)               |
      |     YNdc    = Rquest(12)               |
      |     Ntuple  = Iquest(3)                |
      |     End                                |
      +----------------------------------------+

      Where:

      IButton = Mouse/Keybord button number
      Nt      = Normalisation transformation
      Xwc     = X world coordinate
      Ywc     = Y world coordinate
      Idh     = Histogram identifier
      Xloc    = X HPLOT coordinate (take care of OPTION LOGX)
      Yloc    = Y HPLOT coordinate (take care of OPTION LOGY)
      Icx     = X channel number
      Icy     = Y channel number
      XNdc    = X normalized coordinate
      YNdc    = Y normalized coordinate
      Ntuple  = 1 if the Idh is an Ntuple

The way to use this new possibility is:

      PAW > LOCATE locate.f

PIAF

PIAF connection can be opened automatically with the command HI/FILE:

         PAW > hi/file 45 //piaf/test.hbook
  **** Welcome to the Piaf server @ piaf2 ****

*** This is version 931013 of the Piaf server ***

Feb 15: The Piaf connection will close after 10 hours of inactivity.

  **** Piaf slave server @ piaf1 started ****
  **** Piaf slave server @ piaf2 started ****
  **** Piaf slave server @ piaf3 started ****
  **** Piaf slave server @ piaf4 started ****
  **** Piaf slave server @ piaf5 started ****

  Piaf server set to parallel mode (5 slaves)
         PAW > ld //
          //LUN45           //piaf/test.hbook

PAW miscellaneous

PAW main program:

Important restructuring of the PAW main program and Initialisation routines. This new structure has been introduced to facilitate the calls to PAW and PAW++ from user's programs, e.g. GEANT.

      +------------- 0pamain.f ---------+
      |      PROGRAM PAMAIN             |
      |      PARAMETER (NWPAW=2000000)  |
      |      COMMON/PAWC/PAWCOM(NWPAW)  |
      |      CALL PAW(NWPAW,IWTYP)      |
      |      CALL KUWHAG                |
      |      CALL PAEXIT                |
      |      STOP                       |
      +---------------------------------+

For PAW++, PAWPP should be called instead of PAW.

The colour was not visible in expressions like: NT/PLOT 10.x%y%z%t
The histogram title was not visible in expressions like: NT/PLOT 10.x%y%z or NT/PLOT 10.x%y%z%t

PAW++:

Global sections and shared memory are now visible in the PAW++ browsers.
In the graphics window, is now possible to integrate 1D histograms near the axis. In the past, the axis hided the histogram.
The cut editor now also accepts weights (select 'W' from operator menu).
Fixes in layout of HistoStyle panel.
New options in Ntuple viewer (profile, boxes and extended info) and introduction of a column selector for the scan command.

COMIS: New features

On HP machines, COMIS is now able to invoke the local compiler and to load the object file generated in the current PAW session. This is done via the shared libraries mechanism.

To access this facility, new rules for file extensions have been defined:

      file.f77: The FORTRAN file, ``file.f'' is compiled
                with the local fortran compiler and loaded in the
                current PAW session.

      file.c:   The C file ``file.c'' is compiled with the local C
                compiler and loaded in the current PAW session.

      file.sl:  The precompiled shared library ``file.sl'' is
                loaded in the current PAW session.

New routines callable from COMIS:

      MATHLIB: GAUSS, DGAUSS,

      HBOOK:   HKIND, HRENID. 

      ZEBRA:   MZSTOR, MZDIV, MZLINK, MZWORK, MZBOOK, MZDROP, MZPUSH, MZLOGL
               MZWIPE, MZGARB, MZFORM, LZFIND, LZFID, DZSHOW, DZVERI
               FZIN, FZOUT, FZFILE, FZENDI, FZENDO
               RZCDIR, RZLDIR, RZFILE, RZEND, RZIN, RZOUT, RZVIN, RZVOUT
               RZOPEN, RZIODO, RZCLOS, RZQUOT

HELP CALL will produce the complete list.

New HBOOK routines and options

HKIND Returns histogram attributes.

      SUBROUTINE HKIND(ID,KIND,CHOPT)

      Returns the attributes of the histogram ID as follows:

      if CHOPT=' ' only KIND(1) is filled
      KIND(1) =
           -1 - unknown kind of histogram
            0 - ID does not exits
            1 - one-dim plot
            2 - two-dim plot
            3 - table
            4 - ntuple
            8 - profile

      if CHOPT='A' all the 32 status bits are returned in array KIND(32)

      I1     HBOOK1                        I17    HBIGBI
      I2     HBOOK2                        I18    HNORMA
      I3     HTABLE                        I19    HSCALE
      I4     NTUPLE                        I20    HMAXIM
      I5     Automatic binning             I21    HMINIM
      I6     Variable bin size histogram   I22    HINTEG
      I7     HBSTAT                        I23    H2PAGE
      I8     Profile histogram             I24    H1EVLI
      I9     HBARX                         I25    HPRSTA
      I10    HBARY                         I26    HLOGAR
      I11    HERROR                        I27    HBLACK
      I12    HFUNC                         I28    HSTAR
      I13    HROTAT                        I29    HPRCHA
      I14    HPRFUN                        I30    HPRCON
      I15    HPRLOW                        I31    HPRERR
      I16    HPRHIS

HRENID Renames an HBOOK ID (histogram or ntuple). For example, in PAW, to rename an HBOOK ID:

      PAW > HISTO/FILE 0 fname ! U
      PAW > CALL HRENID(idold,idnew)

HF1E Fills a 1-D histogram

      SUBROUTINE HF1E(ID,X,W,E)

      - ID : Histogram identifier.
      - X  : Value of the abscissa
      - W  : Content is incremented by W
      - E  : Errors is incremented by E**2

HBOOKNC This routine has a calling sequence very close to HBOOKN and creates a CWN instead.

      SUBROUTINE HBOOKNC(ID,CHTITL,NVAR,BLOCK,TUPLE,TAGS)

      - ID     : Id of CWN. If it doesn't already exist, it is created.
      - CHTITL : Name of ntuple. Not used if it already exists.
      - NVAR   : Number of variables per event. Maximum 200.
      - BLOCK  : Name of the block inside CWN. Default 'Block1'.
      - TUPLE  : Array of dimension nvar that will contain values at filling
                 time.
      - TAGS   : See HBOOKN.

HSTAF To set option for filling statistics

      SUBROUTINE HSTAF(CHOPT).

If CHOPT='YES' statistics are computed at filling time. All the histograms created (via HBOOK1 or HBOOK2) after a CALL HSTAF('YES'), will have the IDOPT option 'STAT' automatically activated. This is very useful when histograms are created in an indirect way like in the command NT/PLOT. The way to activate this option in PAW is: OPTION HSTA (HNST to turn it off). Example:

      PAW > OPTION HSTA
      PAW > NT/PLOT 10.x IDH=100

HOPERA The new option ``B'' allows to compute binomial errors.

Obsolete HBOOK routines

The following obsolete routines from HBOOK version 3 have been deleted:

         HCORE, HDISKF, HFNEXT, HISTGO, HLCM, HLCM3, HLOK,
         HSTORE, HUNLOK, HWRITE.

HBOOK: Improvements and bug fixes

Support of the global sections on Alpha/VMS machines.
The packing of the floating point variables in now suppoted in HBNAME.
The maximum size of a CWN (Column Wise Ntuple) row can be up to 50000 words, but the maximum number of elements in a single array is limited to 1000 words.
Maximum size of PAWCR4 increased from 5000 to 50000 words
Add type declarations in HUWFUN
Implement possibility to add 1-D histograms with alphanumeric labels Mods in HOPERA. New routine HOPER1A.
Bug found in the hmcstats code and fixed. The bug would have caused slightly different results for people using VERY low monte carlo statistics, with lots of empty bins (Christine Beeston).

HIGZ : New features, improvements and bug fixes

New features:

A set of 3D primitives are available in HIGZ/HPLOT (IPL3, IPM3, ISWN3, ISVP3 etc ..).
The xvertext package to rotate and scale X11 fonts is now available in higzcc/rotated (Alan Richardson(mppa3@uk.ac.sussex.syma)). It is used in the routine ITX. Now the X11 fonts are managed as follows:

font=xx precision=0 : The X11 font is rotated
font=xx precision=1 : IGTEXT is used on the screen
font=xx precision=2 : The X11 font is rotated and scaled.

New routine IXDOGIF to produce gif files. It is available only if HIGZ has been installed with the PATCHY flag "GIF" ON. On asis the cern library is now installed with this flag OFF. So this funtionnality is not yet available in PAW. Note also that xpick can be used to produce a gif file from the PAW window.
FALCO driver: Request locator is implemented (John Clement)
New routine IGDWK to Get the Default Workstation type. This routine is called by IGWKTY.

Improvements and bug fixes:

The limitations to 1000 point in IGRAPH and IGHIST is now removed. This is also available in all the PAW command using these routines (H/PLOT, GRAPH, etc..)
IGPICK is now able to pick IGARC.
Mods in IGCOLM in order to support default position and color map.
Mods in IOPWK, IGWKTY, IGINIT and IKFILE to be able to call IGWKTY before or after IGINIT.
Correction in IKERNEL/IPM: The marker size was not correct for very small sizes.
Protection added in ixgetge: sometimes (for instance after a CTRL-C), XGetGeometry returns wrong values. In this case the previous "good values" are used.

HPLOT: New features, improvements and bug fixes

New features:

HPLTIT (PAW command TITLE) : If the histogram title contains a ';' two titles are drawn: one horizontally and one vertically.
New option HSTA (HNST) in HPLOPT (PAW command OPTION).
If a parameter name given to the HBOOK routine HFINAM begin with a '-', HPLFIT doesn't draw this parameter.
The error bars with edges marks drawing (error bar drawing in PAW with option E1):

If the error bars are smaller than the KSIZ, the edges marks are not drawn.
If the edges marks are bigger than the error bars, the minimum of the two is taken.

New option 0 in HPLAER (error bar drawing in PAW) to avoid the automatic clipping of markers.
New options in HPLSET (PAW command SET): SMGR: define the Right Margin between the STAT/FIT boxes and the histogram box (in % of the histogram box width). SMGU: define the Up Margin between the STAT/FIT boxes and the histogram box (in % of the histogram box height). This implies mods in HPLSET, HPLSTA and HPLFIT.
New routine HPLFR3 (frame 3d). Equivalent of HPLFRA but in 3D.

      SUBROUTINE HPLFR3(X1I,X2I,Y1I,Y2I,Z1I,Z2I,THETA,PHI,CHOPT)
  
      REAL X1I : Low range in X
      REAL X2I : High range in X
      REAL Y1I : Low range in Y
      REAL Y2I : High range in Y
      REAL Z1I : Low range in Z
      REAL Z2I : High range in Z
      REAL THETA, PHI : Viewing angles
      CHARACTER CHOPT : Options
                        'B' Draw the back box
                        'F' Draw the front box
                        'W' Start a new window

In PAW, this routine is callable within a COMIS program.

Improvements and bug fixes:

Improvements in the drawing of the updated histograms (PAW command H/PLOT). With the options "+", "-", "+-" and "U" of HPLOT, the line border around each new contribution, is drawn only around the new contribution and, as before, around the whole added boxes. The resulting visual effect is to avoid the vertical lines in the updated part of the histogram.
Improvement in HPLFRA (PAW command NULL): when the X1=X2 or Y1=Y2 the frame is drawn with X1-1,X2+1,Y1-1,Y2+1. In the past an error message was generated.
Mods in HPLTAB to manage more than 1000 channels.
Bug fixed in HPLSET (SET 2SIZ was not correct) (PAW command SET).
Bug fixed for the page numbering. It was not correct with 2D histograms
Bug fixed in HPLF. The filled area was not good in the case of histograms subranges drawing.
Change in HPLAER. The option E1 was not correct if the marker type was "."

KUIP: New features, improvements and bug fixes

New features:

Basic KUIP:

MACRO/DATA: new command to be used as "APPL DATA file.name" to write text from immediate data in a macro. Example:

      Application DATA vec.dat
      1  2  3
      4  5  6
      7  8  9
      vec.dat
      vec/read x,y,z vec.dat

New system function $IQUEST(I) returning the status vector element. "IF $IQUEST(1)=0 THEN ..." allows to test the success of the last command.
HOST_PRINTER and KUIP/PRINT: new commands to send a file to the printer; Print is now included in the action menus of the file system browser.
KUOPEN: new status code 'DONTKNOW' which opens the highest cycle on VMS ('UNKNOWN' creates a new cycle); on other systems equivalent to 'UNKNOWN'

KUIP Motif interface:

Introduction of the command "panel 0 c title" ("panel close") to close a panel with name title in a KUIP macro. This was previously only possible with the mouse.
Add resource "centerCommand": in application build on top of KUIP/Motif the commands panels are displayed in the center of the screen instead of at the last mouse cursor posiotion. For example in PAW++ this resource can be activated as follow in the .Xdefaults file:

     Paw++*centerCommand:                       True

Improvements and bug fixes:

Basic KUIP:

Batch mode did not work on VAX/VMS due to wrong VAXC$CRTL_INIT() placement (reported by John Marrafino).
"cmd $fun([var])" did not work if [var] contained an operator like ".and." (reported by Mats Cronqvist).
CALL KUCMD('..',' ','SW') crashed when creating a menu without any commands (reported by Vincenzo Innocente).
Allow comma-separated list of names for ALIAS/DELETE and VECTOR/DELETE (reported by Mike Kelsey).
KUFDEF: allow for functions without arguments given as "$name()".
$FORMAT: fix for format descriptors like I9.5 which did not put leading zeroes on VAX/VMS.
Use Fortran READ for command input when stdin is not a terminal. (RS/6000, DECstation, and Alpha-OSF/1 Fortran I/O does not use C-stream functions.)
GETLINE: make it less noisy by removing some beeps.
$SUBSTRING(s,k,n) returned one character too much if k+n happened to be the length of the string.
KUESVR: create lock file in /tmp if /usr/tmp fails, e.g. because directory is NFS mounted and locking not supported (reported by Dave Edsall).
KXTERM: delay flow control to allow FFREAD from stdin.
KUGETF: allow KUGETL mechanism to get a list of filenames.
Command COLUMNS: add protection in case environment variable "COLUMNS" does not contain a number (reported by Maurizio Loreti).
getline: ^Z-suspend did not work if the program was called from a shell script (reported by Maarten Ballintijn).
KUIPC produced wrong Fortran code for a 64-character string on continuation lines (reported by David Wagner).
KUIPC: compiler-independent treatment of backslash in character strings.
"cmd;" resulted in "unknown command cmd;" rather than executing the command "cmd".
last.kumac could not be written if application started in a directory with a mixed-case name.
Treat alias content in expressions as number if possible.
Preserve trailing blanks in variable initialization in MACRO header.
Preserve trailing blanks in macro variable assignment
KUHOME: do not apply filecase conversion to allow uppercase directory names.
KIMATH: fix to recognize numbers .LT.1 without leading zero.

KUIP Motif interface:

Bug fixed for item "Chdir to ..." in the browsable "Files".
Break interception for Motif version on VMS.
Use HOST_EDITOR setting in VMS Motif version.