December 6, 1999

PAW version 2.11/13

The PAW version 2.11/13 is part of the 2000 release of CERNLIB. The source files, binaries and libraries are available, via anonymous ftp, on the asis system:

                       ftp asisftp.cern.ch

The PAW support is done by:

Olivier Couet.

The PAW related packages versions are:

Package	Version	Date
PAW	2.11/13	06/12/1999
KUIP	2.07/18	24/11/1999
HBOOK	4.25/04	23/03/1999
COMIS	1.21/00	13/05/1998
HPLOT	5.22/00	18/05/1999
HIGZ	1.26/03	13/10/1999
SIGMA	1.10/03	10/02/1994

The following subjects can be found in this page:

PAW

Improvements
New commands
Bugs fixed
Linux specific bugs fixes
NT specific bugs fixes

HBOOK

Improvements
Bugs fixed

HIGZ

Improvements
Bugs fixed

HPLOT

Improvements

KUIP

Improvements
Bugs fixed

Miscellaneous

PAW

Improvements

Help improvements in the commands: NT/PLOT

It is now possible to change the record length used to open the input files of the command HMERGE:

     PAW > hmerge LRECL 16384                   | New LRECL
      Next HMERGE will use LRECL = 16384
     PAW > hmerge out.hbook in1.hbook in2.hbook | Use the new LRECL

To go back to the automatic record length determination mode just do:

     PAW > hmerge LRECL 0                                            
      Next HMERGE will use the auto-record length detection

New routines callable via COMIS: ISWN3, ISVP3, DLGAMA, ALGAMA, VAVDEN, VAVSET.
In several places in PAW, fortran code is called from C code. This is done using the cfortran.h include file. In the past, cfortran.h has been copied in the various places it was used. Several different versions of this files and of the related files like hbook.h, kuip.h etc ... were duplicated in various places of the PAW code. Now only the official version of the cfortran.h package is used and no copy are in the PAW code.
the command VECTOR/FIT is now able to do fits using the Multi-Layer Perceptron facilities (option NN).
Old unused cpp flags removed from the sources: CERNLIB_TKTCL, CERNLIB_QP and CERNLIB_NTUPLE.

New commands

A new set of commands using Neural Networks is available. These commands allow to do ntuple selection using the Multi-Layer Perceptron facilities and fitting (option NN in VECTOR/FIT). These new commands are using the MLPfit package. The port has also be done on NT.

Bugs fixed

The following commands may produce wrong plot with GCUT:
```
  nt/plot 1.y%z $1
  gcut 2 1.y%x $1 option=S
```
The S option forced GCUT to produce a histogram scatter plot which completly obscured the picture.
The zones were not properly reset after a NT/SCAN with option SPIDER.
In Paw++, modifications to avoid the warning message telling that the file linexxx.bm and markerxxx.bm are not found.
In the chain management code the redefinition of strcasecmp has been removed.

Linux specific bugs fixes

In Paw++ a black picture was displayed when the geometry panel was poped up.
In mlp_lapack.c (new file used by MLPFIT) were defined 3 strings maniplation functions ( s_cat, s_cmp, s_copy). On Linux these funtions already exit in some system libraries (f77 or cc). So there was a conflict between the Linux systems functions and those defined in mlp_lapack.c. In particular the following simple example was not working:
```
  ve/create vec(10) R
  app comis quit
  !file example.f77
  quit
  call example
```
Where the file example.f is:
```
        subroutine example
        vector vec(10)
        vec(2) = 1.0
        print *, 'vec(2)=', vec(2)
        end
```
This macro involve some character strings manipulations using s_cat. The wrong s_cat was used (the one defined in mlp_lapack.c). To fix this problem, the functions s_cat, s_cmp and s_copy defined in mlp_lapack.c are now called mlp_s_cat, mlp_s_cmp and mlp_s_copy. This bug has been found in the intermediate PAW version 2.11/12 it is fixed in 2.11/13.

NT specific bugs fixes

$HINFO

$HTITLE

 PAW > message $HINFO(1000,'XBINS')

  *** Break *** Segmentation violation
  Traceq lun = 0, level = 99


  Longjump n-line trace-back still not available.
 PAW >

HBOOK

Improvements

The maximum token length in the column wise ntuples declaration has been extented from 32 to 80 characters.

Bugs fixed

With some CWNs containing REAL*8, an error message saying that the number was invalid (NaN) was displayed. This was a side effect of the word swapping problem fixed previously.

HIGZ

Improvements

New version of the pattern polygon filling in the Postscript driver. It now uses the Pattern functionality provided by PostScript level 2. This allows to have colored pattern and a better drawing of the pattern.
In IZFILE, RZMAKE is now called with 32000.

Bugs fixed

MapNotify is not supported by all the X11 emulators (problem on Mac !!!) When PAW is used via some X11 emulators on PC or Mac (note there is no problem with Exceed on PC), the HIGZ window appears on the display, the message Version 1.25/05 of HIGZ started appears, then...nothing! you never get a PAW > prompt. It just sits there forever. This was due to an improvement done in HIGZ to be sure that the window is displayed before doing graphics. This "improvement" uses the X11 function MapNotify which is not implemented properly on some X11 emulator.
Some optimisations to draw intermediate labels in log scale on vertical axis are now commented. They produced a wrong labels alignment. The reason why they have been put there have not been found i.e. every things looks fine without these lines. Nevertheless they are just commented. A test has been added in the PAW suite to cover this part of code.

An ellipse with When an ellipse (IGELLI) was drawn with FAIS.NE.0, the result was ugly because an axis of the ellipse was also drawn. The following macro shows the problem:

    SET * ; OPT *          | Reset the defaults
    NULL 0 10 0 10 'AB'    | Draw a frame (cf HELP NULL)
    SET PLCI 2             | Line color is red
    SET LWID 6             | Line width is 6
    SET BORD 1             | Border on
    SET FAIS 1             | Filled area
    SET FACI 3             | Filled area are green
    ELLIPSE  5 5 3 5

A workaround is to draw the ellipse in two passes:

    NULL 0 10 0 10 'AB'
    SET BORD 0
    SET FAIS 1
    SET FACI 3
    ELLIPSE  5 5 3 5
    SET PLCI 2
    SET LWID 6
    SET FAIS 0
    ELLIPSE  5 5 3 5

HPLOT

Improvements

The number of colours in a PALETTE was limited to 50. But it was possible to define a palette with more than 50 elements with the following sequence:
```
    SET NCOL 100
    PALETTE 1
```
There was no protections and, on some machines, wrong results may be produced because some code or data could be overwritten.

KUIP

Improvements

Correct lower to upper case file name conversion in KUWHAT.
Remove strdup redefinition

Bugs fixed

On alpha OSF machines only. The copy of one column of a bidimensional array into a monodimensional array was not working. The complete bidimensional array was copied. This was due to an optimisation problem in the alpha OSF fortran compiler. Reducing the optimisation level from O4 to O2 for the routine kxvcop fixes the problem.

This macro shows the problem:

Vector/create v(2,10) r

Appl Data v.dat
1 5
2 7
3 3
4 9
v.dat

Vector/read v v.dat
Vector/print v
Vector/create vbid(10)
Vector/copy v(1) vbid
Vector/print vbid

It gives the output:

PAW > exe a
 V(1, 1) = 1
 V(2, 1) = 5
 V(1, 2) = 2
 V(2, 2) = 7
 V(1, 3) = 3
 V(2, 3) = 3
 V(1, 4) = 4
 V(2, 4) = 9
 V(1, 5) ...
 V(2,10) = 0
 VBID( 1) = 1
 VBID( 2) = 5
 VBID( 3) = 2
 VBID( 4) = 7
 VBID( 5) = 3
 VBID( 6) = 3
 VBID( 7) = 4
 VBID( 8) = 9
 VBID( 9) = 0
 VBID(10) = 0
PAW >

instead of:

PAW > exe a
 V(1, 1) = 1
 V(2, 1) = 5
 V(1, 2) = 2
 V(2, 2) = 7
 V(1, 3) = 3
 V(2, 3) = 3
 V(1, 4) = 4
 V(2, 4) = 9
 V(1, 5) ...
 V(2,10) = 0
 VBID( 1) = 1
 VBID( 2) = 2
 VBID( 3) = 3
 VBID( 4) = 4
 VBID( 5) ...
 VBID(10) = 0
PAW >

ZEBRA

Improvements

Mods for Y2K in the date/time output
qcardl.inc was empty: It is now removed and not used.
The package version is now defined in one central place.
Error message improvement in RZOPEN
Enable calls to CFSTAT for WNT also, thus allowing rfio on NT.

Miscellaneous

The include files (minuit.h, hplot.h, higz.h, kernlib.h, hbook.h, kuip.h, zebra.h, comis.h, cspack.h, lepto62.h, jetset74.h, gen.h ) allowing to call the f77 CERNLIB routines from C or C++ have been reorganised because they were not working on NT machines. These include files use cfortran.h.