PSI µSR Facilities: Available Software
Background
The data files produced by the PSI µSR time-differential
data acquisition programme are saved to a portable binary format
(with extension ".bin" and 512 bytes/records and IEEE real-data format).
A description of the data format is given
here.The data-files are available from:
- the AFS PSI tree (at the subdirectory: /afs/psi.ch/project/bulkmusr/data/xxx/
where xxx represents the instrument name).
- the PSI-archive for older files (see information here),
Many programmes exist to analyse and manipulate these files (see list below
-- note that some of these applications are no more supported).
Information regarding the software available for the Avoided Level
Crossing (ALC) instrument is available separately.
Reading a Data File
A new C++ class has been recently developped to read the �SR
binary format produced at PSI with the td_bin format.
It has been written as a hopefully esay to use and highly
portable C++ code.
A complete description of the class is provided
here.
Data Analysis
- Analysis in time-space -- MUSRFIT: The programme musrfit
has been developed by Andreas Suter with some valuable contributions of Bastian M. Wojek from PSI/Uni ZH. It
is a very versatile fitting software tool for analyzing time
differential μSR-data. It is implemented in
C++/ROOT
and uses the
MINUIT2-libraries developed at
CERN for fitting
data. User functions can also be defined. In addition a nice Qt graphic user interface
(musrgui) is available.
Details about musrfit can be found
here (but I
fear that this page is only accessible from PSI) otherwise
here for musrgui,
here for musrfit
and finally
here for the batch fitting possibility.
musrfit is installed on different muSR Linux
machines. It can also be run on the "sinquser" machine:
Note that this procedure (Define the variables, Run the GUI) should work on all Scientific Linux 5 machines of PSI, where
musrfit is not installed locally. For a machine where musrfit is installed locally, the above
procedure should be avoided and the local version should be used.
For example the software can be run on the Linux cluster (machine: llcsl5a).
- Analysis in time-space -- MINFIT: The programme
MINFIT can be used to analyse time-spectra by fitting to various pre-defined
signal types. This programme is based on the CERN fitting library MINUIT.
MINFIT has the ability to read TRIUMF and RAL data files directly,
as well as PSI files.
- Documentation: This is available in PostScript format,
although LaTeX source is also available. In order of importance the
files should be read in this order:
- MINFIT_HELP.PS
A basic guide. Also available in HTML as MINFIT_HELP.HTML.
- MINFIT.PS
The manual for MINFIT commands. Also available as MINFIT_DOC.HTML.
- MINUIT.PS
The manual for MINUIT, including those commands that are directly
taken over into MINFIT. Also available as MINUIT_DOC.HTML.
- FCN.PS Gives
some background information on how the fitting programme is implemented.
Also available as FCN.HTML
.
- Windows XP Version: This is available in the
FTP-server from PSI (get MINFIT32.EXE).
Use binary ftp transfer! For this version, the installation of
GRAPHX
is required.
- Windows NT Alpha Version: This is available in the
FTP-server from PSI (get MINFIT64.EXE).
Use binary ftp transfer!
- Linux: A Linux version is now available
in the AFS system at PSI. It can be run either from the Linux PSI cluster
(llc) or from a stand-alone Linux workstation of PSI. In analogy to VMS,
you will have first to define environment variables MINFIT_NAME and
MINFIT_DATA.
Look here how to setup
the software. The programme can be invoked by the command
minfit .
- Analysis in time-space -- MUFIT: The programme
MUFIT can be used to analyse time-spectra by fitting to various pre-defined
signal types. This programme has been developed by (among others A.
Golnik and F. Gygax.
- Windows XP Version: This is available in the
FTP-server from PSI (get MUFIT32.EXE).
Use binary ftp transfer! For this version, the installation of
GRAPHX
is required.
- Linux: A Linux version is now available in the AFS
system at PSI. It can be run either from the Linux PSI cluster (llc) or
from a stand-alone Linux workstation of PSI. Note that the Fast Fourier
Transform option is currently not available.
Look here how to setup
the software. The programme can be invoked by the command mufit
.
- Analysis in time-space -- MSRFIT: The programme msrfit
developped in TRIUMF can be used to analyse time-spectra by fitting to various pre-defined
signal types.
To be able to run de TRIUMF data analysis applications, you have to
integrate the file: /afs/psi.ch/user/m/musrmgr/musr_software/@sys/msrfit/.bashrc_msrfit
in your .bashrc file.
First the PSI data have to be converted with the mud_util
application.
- Analysis in time-space -- WKM: The programme
WKM, based on the CERN fitting library MINUIT and developed by Wolfgang
Kopmann in Braunschweig, can be used to analyse time-spectra by fitting
to various pre-defined signal types. User functions can also be defined.
Details to setup WKM on the AFS system at PSI can be found here.
- Analysis in time-space -- WIMDA: This Windows
based programme is developed and maintained by F. Pratt (ISIS).
It can directly read PSI ".bin" data format.
Details about WIMDA can be found
here
.
- Analysis in frequency-space -- FFTX: This
programme has been developed by (among others) F. Gygax from ETH-Zurich.
- Windows95/NT Intel Version: This is available in
the FTP-server from PSI (get FFTX32.EXE). Use
binary ftp transfer and copy also the file tst025e.lat!
For this version, the installation of GRAPHX is required.
- Linux: A Linux version is now available
in the AFS system at PSI. It can be run either from the Linux PSI cluster
(llc) or from a stand-alone Linux workstation of PSI.
Look here how to setup
the software. The programme can be invoked by the command fftx
.
Data Conversion and Utilities
Since two types of data-formats are know available (see above),
the users should optimize the use of the conversion programmes to their
specific use.
- Converting fixed-records binary PSI data-files (".bin"-format):
- psibin2ascii
- Windows XP version: This is available in
the FTP-server from PSI (get PSIBIN2ASCII.EXE
). Use binary ftp transfer!
- Linux: A Linux version is available in
the AFS system at PSI. It can be run either from the Linux PSI cluster
(llc) or from a stand-alone Linux workstation of PSI.
Look here how to setup
the software. The programme can be invoked by the command
psibin2ascii .
- psibin2origin
- Windows XP version: This is available in
the FTP-server from PSI (get PSIBIN2ORIGIN32.EXE
). Use binary ftp transfer!
- Linux: A Linux version is vailable in
the AFS system at PSI. It can be run either from the Linux PSI cluster
(llc) or from a stand-alone Linux workstation of PSI.
Look here how to setup
the software. The programme can be invoked by the command
psibin2origin .
- Other utilities:
- editx -- This programme to display and manipulate
the raw data has been developed by (among others) F. Gygax from ETH-Zurich.
- Windows XP version: This is available in
the FTP-server from PSI (get EDITX32.EXE).
Use binary ftp transfer! For this version, the installation of
GRAPHX
is required.
- Linux: A simplified Linux version is now
available in the AFS system at PSI. It can be run either from the Linux
PSI cluster (llc) or from a stand-alone Linux workstation of PSI.
Look here how to setup
the software. The programme can be invoked by the command
editx.
- NovelLook -- A new application based on Qt and
Qwt to look
at raw data and obtain asymmetry plots. Multiple histograms can be open
simultaneously. The application is normally installed on the Linux
systems for muSR users. Different versions are available
- For XP systems with static libraries: see
here for a download
- For Linux systems with static libraries: see
here for a download
This application is
distributed under the terms of the
GNU General Public
License and its code is available
here.
- look_musr -- A new application to look
at raw data and obtain asymmetry plots.
- Linux: Look
here how to setup the software. The programme can be invoked by
the command look_musr. It can be run either from
the Linux PSI cluster (llc) or from a stand-alone Linux workstation of
PSI.
- list_runs -- A utility programme to list
header information from a range of runs.
- Windows XP version: This is available in
the FTP-server from PSI (get LIST_RUNS32.EXE
). Use binary ftp transfer! For this version, the installation
of GRAPHX
is required.
- Linux: Look
here how to setup the software. The programme can be invoked by
the command list_runs. It can be run either from
the Linux PSI cluster (llc) or from a stand-alone Linux workstation of
PSI.
Setting up Linux at PSI to run facility-software
- Copy the files ".graphxrc" and "grap1
" from the directory /afs/psi.ch/user/m/musrmgr/
.
- Edit and modify the file grap1 for
your needs.
- Edit your ".bash_profile" file or
equivalent if on another shell.
Add the following statement
export PATH=$PATH:/afs/psi.ch/sys/i386_linux24/apps/graphx/bin:/afs/psi.ch/user/m/musrmgr/musr_software
add also the line
export PRINTER=XXXXXXX
where XXXXXXX should be the CUPS name of your nearest
printer.
See here
for a list of the available printer names.
If you only know the old VPP printer name, then this page should help you !!
- Logout and login again
- You can now run the available software by *first*
invoking impenv graphx and after the
available software.
- The *on-line* data are found in the following directory:
/afs/psi.ch/project/bulkmusr/data/XXX/
where you replace XXX
by the name of the specific instrument
- Remember to use ".bin" data-file
- For minfit you must also set the environment
variables MINFIT_NAME and MINFIT_DATA
(i.e. export MINFIT_NAME=... and
export MINFIT_DATA=...)
Setup to run some of the software on the "sinquser" machine
The sinquser machine is a LINUX machine located outside of the
PSI firewall. An external user can log on this machine (via ssh) to access
the muSR software and data:
Account: sinquser
Password: sinquser
The machine is by default on the TENEX C shell (tcshell, type
the command ps $$ to be sure).
- Go into the bash shell (type the command bash)
- If
necessary set the graphx environment (command impenv graphx)
-
You can now run the available software.
- The *on-line*
data are found in the following directory:
/afs/psi.ch/project/bulkmusr/data/XXX/
where you replace XXX by the name of the specific
instrument
- Remember to use ".bin" data-file
-
For minfit for example you must also set environment variables (MINFIT_NAME
and MINFIT_DATA)
(i.e. setenv MINFIT_NAME ... and
setenv MINFIT_DATA ...)
For the
musrfit package, see above for details how to run it
on the sinquser machine.
|
