Summary

• Get CD-ROM or download:
  • EMPIRE-2-18
  • setup-emp
  • EXFOR library - optional
  • HF-BCS level densities - optional
• type sh setup-emp in the directory in which setup-emp has been placed

What to download?

• EMPIRE-2-18 - is the only file, which is strictly required. It contains all sources, scripts, GUI, and other files needed for execution of reaction calculations. The file can be placed anywhere in the file system.
• setup-emp - is a bash script, which decompresses EMPIRE-II package, compiles it and starts Graphic User Interface (GUI). It makes installation straightforward thus it is strongly recommended that the user get it downloaded.
• EXFOR library - this link points to the X4-2-17.tgz file which contains entire EXFOR library organized in a tree starting with the 'EXFOR/subent' directory. If downloaded it should be placed in the same directory as empire-2-18.tgz. The library expands to about 340 Mb when uncompressed. EXFOR is needed only for the comparison plots. Users who have problems with disk space do not need to download and install this file. In such a case, user is advised to request a CD-ROM with EMPIRE distribution, which allows to use EXFOR library stored on the CD-ROM without copying it to the local disk.
• HF-BCS level densities - this file (HFBCS-lev-dens.tgz) contains tabulated level densities calculated in frame of the Hartree-Fock-BCS approach and provided to RIPL-2 by S. Goriely. If downloaded it should be placed in the same directory as empire-2-18.tgz. This file is only necessary for calculations using HF-BCS level densities (LEVDEN=3 input option). The size is about 145 Mb when uncompressed. Again, when installing from a CD-ROM the full functionality of the code can be preserved without necessity of storing microscopic level densities on the local hard drive.
• Tcl/Tk packages - to be downloaded if and only if any of the Tk, Tcl, Tix, and itcl packages is missing on the local computer and if the operating system supports 'rpm' (Linux RedHat, Suse and Mandrake). The current link (Tcl-Tk-Tix-ictl.tgz) when untarred and gunzipped will produce the following RedHat 7.3 packages, which can be installed by the setup-emp script:
  • tk-8.3.3-67.i386.rpm
  • tcl-8.3.3-67.i386.rpm
  • itcl-3.2-67.i386.rpm
  • tix-8.2.0b1-67.i386.rpm
  These may or may not work with Suse or Mandrake, just don't know. Native Tcl/Tk packages, as included in the original Linux distributions, are recommended. For other systems, sources and/or binaries can be downloaded free of charge from:
  • Tcl/Tk - http://www.tcl.tk/software/tcltk/
  • Tix - http://tix.sourceforge.net/download.shtml
  • itcl - http://sourceforge.net/projects/incrtcl
  In such a case the packages must be installed manually.
• manual - NEED NOT BE DOWNLOADED; it is already contained in the empire-2-18.tgz file.

Installation using setup-emp script (Linux/UNIX)

Starting with the 2.17 version EMPIRE-II can be installed using the setup-emp script. This is as easy as can be! Just cd 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. If you are installing from the CD-ROM you may also say 'no'. The script will not copy EXFOR and/or HF-BCS level densities to the hard disk but will create links to the CD-ROM instead. Thus, you will be able to use both libraries providing you have EMPIRE distribution CD-ROM inserted into your CD-ROM drive and mounted while running calculations. A substantial reduction of the occupied disk space may compensate for a slight overhead (order of seconds), which is due to the low transfer rate of data from the CD-ROM. After all files are uncompressed and copied the script will ask for the FORTRAN compiler of your choice. By default, Linux standard 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. There will be a flood of warnings during ECIS compilation. These are caused by the ECIS style for setting array dimensions. It is 'legal' but not appreciated by most compilers. As long as 'ecis' executable is created in the empire/source directory these warning messages can be safely ignored.

Starting with the 2.18 version EMPIRE-II distribution comes with the Tcl, Tk, Tix, and itcl packages needed for running user graphic interfaces (GUIs). Installation script will probe whether these packages are available on the system and propose to install them in case they are missing. In order to do this the root password will be requested. Probing and installation is only possible on Linux systems running 'rpm' (RedHat, Suse, and Mandrake). It has been tested on the RedHat 7.2 and 7.3 only and it may not work for other distributions.

At the very end the script proposes to launch EMPIRE GUI and you are all done.

Manual installation (UNIX)

Here is a sequence of steps to follow in oder to install EMPIRE-II manually if setup-emp script can not be used for any reason :-(

The last command should start the new GUI. If not, you may still try the old one :-( by typing:
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.

Platform

EMPIRE-II has been developed and tested under LINUX Red Hat (actual version 7.3). The whole system should run on any UNIX providing:

• bash shell
• FORTRAN compiler
• Tcl/Tk
• Tix
• itcl
• gnuplot
• awk
• xemacs
• ghostview (gv)

Execution

Invoke Xrun.tcl (lrun.tcl) script in the ~/empire/work directory (if it was not already started by the setup-emp script):

This brings the new Graphical User Interface (GUI) to the screen.

NOTE: Xrun.tcl needs Tcl/Tk, Tix, 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/work directory. Please refer to documentation for more details. In case 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.