Nuclear Data Section (NDS)
             Department of Nuclear Sciences and Applications
                International Atomic Energy Agency (IAEA)
                Vienna International Centre, P.O. Box 100,
                        A-1400 Vienna, Austria
                Tel:(+43 1) 2600-21717; Fax:(+43 1) 26007
  
       WORKING MATERIALS TO FOLLOW THE IAEA EMPIRE WORKSHOP DECEMBER 2013
         https://www-nds.iaea.org/index-meeting-crp/EmpireWorkshop2013/
  
                    "EMPIRE-3.2.3 for Linux and MacOSX"
              Prepared by Viktor Zerkin, IAEA-NDS, 2013-2021
                   Last modified: 2021-11-12 by V.Zerkin
_______________________________________________________________________________

CONTENT
-------
 The distribution includes source for Linux/MacOSX:
 1) Empire-3.2.3 package: https://www-nds.iaea.org/empire/index.html
    - Empire-3.2.3 (Malta), source code, Rev.5310 (2021-11-09)
    - XC4 data from EXFOR (as of 2021-11-10)
 2) Installation scripts
    - bash scripts to prepare and run Empire package (V.Zerkin, 2018-05-10)


LICENSES
--------
For third party software, please see the README, "license.terms" files that 
come in the associated directories.


SETUP SYSTEM ENVIRONMENT
------------------------
 The package requires the following system components to be installed
 __________________________on Linux*_________________________________
  1) X11 terminal:      $ sudo apt install xterm
  2) gfortran:          $ sudo apt install gfortran
  3) dos2unix:          $ sudo apt install dos2unix
  4) Postscript viewer: $ sudo apt install gv
  5) Python (2.7.*)     $ sudo apt install python
  6) Tcl/Tk:            $ sudo apt install tk
     and extensions:    $ sudo apt install itcl3    
                        $ sudo apt install itk3     
                        $ sudo apt install iwidgets4
  *Examples of installation commands are given for Ubuntu-20
 ....................................................................
 __________________________on MacOSX*________________________________
  1) X-Windows X11: XQuartz-2.8.1.dmg from https://www.xquartz.org/
  2) gfortran: https://gcc.gnu.org/wiki/GFortranBinaries#MacOS
     technical details: https://gcc.gnu.org/wiki/GFortranBinariesMacOS
     or using Homebrew: $ gcc --version
                          this will start --> install Xcode.app
                          if you do not have it installed
                        $ brew install gfortran
     test gfortran:     $ gfortran --version
                          GNU Fortran (Homebrew GCC 11.2.0_1) 11.1.0
  3) dos2unix:          $ brew install dos2unix
  4) Postscript:        $ brew install ghostscript
                          Note. ps2pdf works; gv, ghostview - not
  5) Python and Tcl/Tk. Working versions: Python-2.7 and Tcl/Tk-8.5
    *MacOS Big Sur comes with Tcl/Tk and Python pre-installed
     test Tcl/Tk:       $ wish
                        % info patchlevel
                          8.5.9
                        % exit
     test Python:       $ python --version
                          Python 2.7.16
                        $
    *On MacOS Monterey pre-installed Tcl/Tk is not compatible with Empire-package
    *If Tcl/Tk Empire-scripts fail, set Python-2.7 local environment:
                        $ brew install pyenv
                        $ pyenv install 2.7.16
                          ...wait...
                          Installed Python-2.7.16 to /Users/viktor/.pyenv/versions/2.7.16
                        $ pyenv local 2.7.16
                        $ wish
                          DEPRECATION WARNING:...
                        % info patchlevel
                          8.5.9
                        % exit
                        $
 ....................................................................

EMPIRE INSTALLATION*
--------------------
 1) Download file "Empire323zv2src.tar.gz" from Internet:
	https://www-nds.iaea.org/cdroms/#EMPIRE-3.2.3src
 2) Uncompress "Empire323zv2src.tar.gz" to HD disk, e.g.
                        $ tar xvzf Empire323zv2src.tar.gz
                          (required free space on HD disk: ~2Gb)
 3) Goto package directory:
                        $ cd ~/Empire323zv2src
 4) Compile Empire:
                        $ ./make-all.sh
    4a) Compile Empire on Linux:
                        $ ./make-linux.sh
    4b) Compile Empire on Mac CPU:i386(x86_64), gfortran:10.2.0
                        $ ./make-mac-x86.sh
    4c) Compile Empire on Mac CPU:M1(arm64), gfortran:11.1.0
                        $ ./make-mac-m1.sh
 5) Start Empire:
                        $ ./run-empire.sh
	- You should see popup-window with Empire-GUI,
	  select input file and start your work
	  (default example: pd105.inp) 
	- if you have problems starting ZVView, download version for
	  your platform from http://www-nds.iaea.org/public/zvview
	- when you start plotting with ZVView on MacOS Big Sur
	  you will be asked to confirm running unknown program, so,
	  you can unblock it by "System Preferences" -->
	  "Security & Privacy" --> "Allow Apps" --> "Allow Anyway"
 6) Recompile Empire package:
                        $ ./make-lin.sh clean
                        $ ./make-lin.sh
	or under Empire/GUI Tcl/Tk:
                        [Source] -> [Make all]
 Important!
 You can install the package in any directory, but 
 please, do NOT use blank (space) symbol neither in your 
 directory names nor in your files and project names.

*Please, report difficulties with installation to V.Zerkin@iaea.org


INITIAL SETUP
-------------
 1) By default, working directory is defined as ~/wrk
    In order to change this edit "run-empire.sh" modifying "~/wrk"
 2) When running first time, script run-empire.sh will copy file 
    EMPIRE-3.2.3\test-cases\pd105.inp to working directory.
    This file can be used as input file for testing setup of Empire package.


WORK ON YOUR EMPIRE PROJECT
---------------------------
 See short description of EMPIRE package in EMPIRE-3.2.3/README.TXT,
 documentation and manual in EMPIRE-3.2.3/doc/. 
 You can send your feedback, suggestions, wishes to EMPIRE
 to R.CapoteNoy@iaea.org, mwherman@lanl.gov

_______________________________________________________________________________
         ALL PRODUCTS ON THIS DVD-ROM ARE PROVIDED IN GOOD FAITH AND 
                    WITHOUT A WARRANTY OF ANY KIND.