Cascade is a program that uses a transition state model code to calculate
competing fission and evaporation following fusion. This is the Sun port of
Steve Sanders' modified version of Cascade. It uses Sierk barriers for
fission, and has been interfaced with Lilita (also supplied).

Please contact S.M.Singer@bham.ac.uk in case of any problems.

Installation instructions
-------------------------

Unzip and untar the tar archive, it will create a directory called cascade.
Use a command like:

	gunzip -c cascade.tar.gz | tar xvf -

Then type

	cd cascade/src

Edit the Makefile to alter the location where the executables and
libraries are stored. Look for the line BASE =. When finished type 

	make install

To save disk space, you may also type

	make clean

Documentation
-------------

The input deck format is documented in cascade/man/input-format, this is all
the documentation I have for Cascade. This version of Cascade automatically
produces the input file for Lilita, so the lack of documentation on that is
not so important.

Usage instructions
------------------

Ensure the bin directory in Cascade is on your path, for example, at
Birmingham, where Cascade was untarred into /home/charissa, you would
type:

set path = ( /home/charissa/cascade/bin $path)

or make appropriate alterations to your .cshrc file.

Running Cascade
---------------

Create an input file with the extension .dat. A sample input file called
mg24mg24_89.dat is provided and we'll use that filename in the example.
The Cascade output file created from that input file is also provided so
that you can check your installation works.

To run Cascade type 
	runcascade filename

Where filename is either the name of the input file (for example,
mg24mg24_89.dat) or just the first part of the name (mg24mg24_89).  If you've
already run cascade on the same input file, then runcascade will backup the
old output files first. It will give a prompt 'Enter input data file name :',
ignore this prompt as you specified the name on the command line. The script
prints out the name of the file you specified at this point (unless the
machine is running slow, it which case it may miss). All being well, you
should see something like this:

% runcascade mg24mg24_89
No parameters file exists, using system version.
The next prompt will be answered automatically.
 Krappe potential in use
 Reading from parameter file
 Number of parameters read =   8
 voff0                      -5.19330
 voff1                       0.00460
 ba_0                        0.79992
 ba_asym                     0.00000
 s0                          0.79051
 sacn                        0.00805
 wigscale                    0.50000
 fracgs                      0.00000
 Enter input data file name :mg24mg24_89.dat
STOP: Execution terminated
Deleting scratch files

The main Cascade output file has a .CSO extension. The Lilita input file
created has a .PRE extension. Many other files are created, you can work
those out for yourself.

Running Lilita
--------------

To run Lilita type
	runlilita filename_prefix [number_of_events]

Where filename_prefix is the first part of the filename (eg. mg24mg24_89).
Since Lilita is a Monte-carlo program, the number of events in the simulation
can be chosen. Cascade sets a default value, you may override this by
specifying a number of events. All being well, you should see something like
this (exact numbers may vary due to the Monte-carlo nature of the code):

% runlilita mg24mg24_89 100000
Using 100000 events.
 imas1,masmin=  1  5
 vcn =     4.45650E-02
  Number of elements in mass table =   636
[section of output removed]
   2500  4998  4972  4022  4059  873  897
   5000  9998  9947  7986  8066  1802  1856
   7500  14998  14925  12036  12148  2659  2736
   10000  19998  19909  16023  16179  3560  3668
   12500  24998  24883  20033  20241  4440  4564
   15000  29998  29860  24062  24304  5325  5467
   17500  34998  34838  28084  28359  6193  6364
   20000  39998  39811  32076  32388  7098  7295
   22500  44998  44790  36114  36461  7960  8189
   25000  49998  49770  40107  40483  8872  9138
   27500  54998  54744  44165  44573  9697  10007
   30000  59998  59720  48173  48615  10585  10931
   32500  64998  64694  52159  52642  11485  11857
   35000  69998  69671  56202  56729  12340  12733
   37500  74998  74637  60207  60770  13233  13645
   40000  79998  79612  64210  64816  14130  14563
   42500  84998  84589  68265  68897  14996  15447
   45000  89998  89563  72267  72938  15880  16369
   47500  94998  94541  76355  77058  16696  17218
   50000  99998  99525  80405  81148  17531  18097
0TOTAL TRIAL=   50237TOTAL REQUEST=  100000
[more output removed]
  MISSING MASSES:
          z          a          cnt
         4         6         3
   kmin  kmax  minm  maxm

The output is in the files with .lilita and .lilout extensions.

Tidying up
----------

To erase all output files from a run of Cascade and Lilita, type
	tidycascade filename_prefix

For example,
	
% tidycascade mg24mg24_89
Cascade and Lilita output files deleted.
