Installation
Using setup-emp script (LINUX/UNIX)
Change to the directory containing downloaded files and type:
sh setup-emp
to execute the script. In the case of CD-ROM installation you have to mount CD-ROM before executing the
script with something like (actual mount point may be different depending on your installation):
mount /mnt/cdrom
cd /mnt/cdrom
sh setup-emp
The installation script will default to the current directory for the EMPIRE distribution files so it is
safe to hit Enter key when it asks for the location of source files. Next script will ask for the target
directory in which EMPIRE should be installed. The default is your home directory and again Enter is a
good answer since setup-emp will create 'empire' directory so that EMPIRE installation will not mess up
with your files. Then the script will ask whether you want to install
EXFOR and HF-BCS level densities. You certainly want to answer yes if you have them downloaded.
After all files are uncompressed and copied the script will ask
for the FORTRAN compiler of your choice. By default, Linux g77 is used but you may prefer to
specify another one (NOTE: the compiler must already be installed on your system). Next the whole
package
is compiled.
Starting with the 2.19 version EMPIRE distribution comes with the ActiveTcl package needed to run EMPIRE
GUI. The setup-emp script will automatically invoke ActiveTcl installer. Please remember to add path
to ActiveTcl in your shell configuration file (e.g., .bash_profile for bash) as indicated by the installer.
To activate the configuration you will need to logout and to login (or source the configuration file).
EMPIRE GUI can be started by typing
../scripts/Xrun.tcl &
in any subdirectory of empire (typically the work subdirectory).
Manual installation on UNIX
Here is a sequence of steps to follow in oder to install EMPIRE manually if setup-emp script
can not be used for any reason
tar xvzf empire-2-19b24.tgz
tar xvzf x4cd.tgz (optional)
tar xvzf HFBCS-lev-dens.tgz (optional)
mv ActiveTcl8.4.7.0-linux-ix86-108887.tar.gz empire
cd empire
tar xvzf ActiveTcl8.4.7.0-linux-ix86-108887.tar.gz
Compile
Here you need to logout and login again
cd empire/work
../scripts/Xrun.tcl&
The last command should start the new GUI. If not, you may still try the old one :-( by typing:
../scripts/lrun.tcl&
If all worked fine you should
be ready to go. If this is not a case read details below.
Some systems will not allow for tar xvzf 'file.tgz' command. In such a case one can use:
gunzip 'file,tgz' and
tar xvf 'file.tar'
instead. On Windows, WinZip can be used to uncompress .tgz files.
The FORTRAN sources are compiled using Makefiles present in respective
directories. By default g77 FORTRAN compiler (standard in recent LINUX Red Hat
distributions) is used. To use another compiler user has to
edit all Makefiles and change them appropriately before running Compile script.
Note that Makefile in the empire/source directory contains commented examples
for a number of typical compilers. If 'make' utility is not available user will
have to compile all components manually. Please refer to Makefiles for the correct
names of executables and to the manual for further details.
Execution
Invoke Xrun.tcl (lrun.tcl) script in the ~/empire/work directory:
cd ~/empire/work
../scripts/Xrun.tcl &
This brings the new Graphical User Interface (GUI) to the screen.
NOTE: Xrun.tcl needs Tcl/Tk, itcl,
and bash shell installed, while lrun.tcl can do without itcl.
If Tcl/Tk is missing you still can use scripts provided in the
empire/scripts directory. Please refer to documentation for more
details. In case the bash shell is not available you would have to resort to the
manual mode (see documentation). However, a single run of the whole system
in the manual mode is likely to be more work than installing the bash shell.
To run default calculations for neutron induced reactions using GUI:
- select your favorite editor using 'Options'->'Select editor' menu of the GUI
- type any name (no dots or spaces!) in the 'Project' box
- hit 'Create' button
- in the editor window type target's A and Z in place of 'x'
- save the file and close the editor
- click 'rocket-icon' to run full set of calculations
- inspect outputs and plots clicking on the appropriate buttons
