Skip to content

vetlewi/oslo-method-software

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

README-file for OsloSoftware

Concept DOI: DOI

When citing, please use the DOI of the specific verion, which will be accessible via Zenodo.


Magne Guttormsen Department of Physics University of Oslo P. Box 1048, Blindern N-0316 OSLO

E-mail: [email protected] Oslo, September 27. 2014 MSU , February 18. 2015 Oslo, June 26. 2015 Oslo, October 23. 2015 Oslo, November 11. 2015 Oslo, December 15. 2015

For questions or issues with installation, you may also contact Jørgen E. Midtbø, [email protected].

Enjoy, Magne

(The package and README was modified in January 2016 by Fabio Zeiser and Jørgen E. Midtbø to be more generally installable than just on MacOSX.)


OsloSoftware is copylefted free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, see http://www.gnu.org. This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PUR-POSE. See the GNU General Public License for more details. For your reports and publications, you should refer to the following publications:

  1. The Oslo method
    A. Schiller, L. Bergholt, M. Guttormsen, E. Melby, J. Rekstad,
    and S. Siem, Nucl. Instrum. Methods Phys. Res. A 447 494 (2000).

  2. The unfolding procedure:
    M. Guttormsen, T.S. Tveter, L. Bergholt, F. Ingebretsen, and
    J. Rekstad, Nucl. Instrum. Methods Phys. Res. A 374, 371 (1996).

  3. The first generation gamma-ray spectra procedure:
    M. Guttormsen, T. Ramsøy, and J. Rekstad,
    Nucl. Instrum. Methods Phys. Res. A 255, 518 (1987).


In order to do the Oslo method, you need to run the mama-commands:

re Read in the raw particle-gamma matrix
rm Make response matrix
un Unfold the particle-gamma matrix
fg Run the first-generation procedure on the unfolded particle-gamma matrix

after un and fg, you should use the commands:

fn # Fill negative counts from neighbours 
rn # Replace (remaining) negative counts with zeros

Then write (wr command) the first-generation matrix and call it fg

For the further analysis, you need programs found in the /prog directory:
rhosigchi.f Find Rho and T from a least-square fit to the matrix fg
d2rho.f Find Rho(Sn) from D0 or D1 values
rhobin.f Find Rho(Sn) from global systematics (e.g. Egidy&Bucurescu)
counting.c Normalize the level density function Rho(Ex)
normalization.c Normalize the gamma-ray strength function f(Egamma)
radex.f Find the gamma-ray strength function from P/Rho

(There are several other programs in /prog and /mama that you do not need. Some of them are out-dated or do not work…)


Installation:

You need a Mac or a Unix/Linux computer with the following software installed:
gfortran
gcc
g++
(On linux (Ubuntu) you will also need the packages libx11-dev, libxt-dev, libreadline-dev, libncurses-dev)

You would also benefit from downloading ROOT from CERN (see below).

Then, clone this repository (or download and unpack the zip file) into the folder where you want the software to be installed. Let us say it is

/path-to-software/oslo-method-software/

This folder should now contain the three subfolders mama/, prog/ and sirius/, among other things.

You must then add this path to your system environment variables in the following way:

Edit your /home/user/.bash_profile file (or something equivalent, if you prefer and know what you are doing) and add the two lines

export UIO_APPLICATIONS=/path-to-software/oslo-method-software
PATH=$PATH:$UIO_APPLICATIONS/prog/bin

You must of course replace the installation path with your own.

Then, navigate in a terminal to your installation directory, and execute the following commands:

cd mama
make very-clean
make all
make install

cd ..
cd prog
make very-clean
make all
make install

NOTE: if you are a Mac user with Mac OSX High Sierra (version 10.13) or later with Macports installed, you might get this error message:

FATAL:/opt/local/bin/../libexec/as/x86_64/as: I don't understand 'm' flag!

Then you need to do

export PATH=/usr/bin:$PATH

before running the above commands.

All executables are now installed in /path-to-software/oslo-method-software/prog/bin, but they should also be in your $PATH so you can run them from anywhere by typing e.g.

mama

This should open the mama prompt, as well as a graphical window.


Adding new response matrixes

You can read reponse matrixes from file, which is now the default method.

You can add another response matrix by adding a folder in the mama/resp directory, eg "oscar2018", and export the enviroment variable MAMA_MYRESP

 export MAMA_MYRESP=oscar2018

If you do not set it manually, it will choose the myresp folder. You can take this folder as a starting point for adding you own response functions if you like.


Ensuring ROOT support

To our knowledge, we have now ensured compatibility with ROOT 6 in all cases. Please report if you (still) experience backward compatibility issues.

To get ROOT working the environment variable ROOTSYS needs to be defined. If you have ROOT installed, you should already have this, since it is set automatically by the script /path-to-root/bin/thisroot.sh, which you should be calling in some startup script, e.g. in your /home/user/.profile file (other common names are .bashrc, .bash_profile).

You can test whether you have the correct setup by typing

echo $ROOTSYS

in a terminal. If it prints the path to your ROOT directory, you are all set. If not, open your /home/user/.profile file in a text editor and add the line

. /path-to-root/bin/thisroot.sh # for sh shell user, e.g. bash users (if you are unsure which shell you are running, use this)

or

source /path-to-root/bin/thisroot.csh # for csh shell users

to the end of it.


Fixing a font problem

For Ubuntu (and possibly other GNU/Linux) users, there might be a font problem. This manifests itself when you open mama as a complaint about something called X_OpenFont.

The solution is to install the apt package

xfonts-100dpi

(i.e. do sudo apt-get install xfonts-100dpi in an Ubuntu terminal)

and then run the following terminal commands:

cd /usr/share/fonts/X11/100dpi/
sudo mkfontdir
xset fp+ /usr/share/fonts/X11/100dpi

To add the path permanently, add FontPath /usr/share/fonts/X11/100dpi to ~/.xinitrc


About

Software for the Oslo Method

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • Mercury 77.4%
  • C 13.7%
  • Fortran 6.7%
  • VBA 0.8%
  • C++ 0.8%
  • Roff 0.2%
  • Other 0.4%