@@ -343,56 +338,93 @@ msr2data 8471 8470 -OneRunFit_example -o OneRunFits.db
For reporting bugs or requesting new features and improvements please use the PSI Tracker or send an e-mail to A. Suter.
--- BMW & AS
@@ -182,7 +177,7 @@ If called from within a shell it accepts several parameters:
-c, --chisq-only
Instead of fitting the model, musrfit calculates χ2 only once and sends the result to the standard output if called with this option. This might be useful for the adjustment of the initial values of the fit parameters.
-t, --title-from-data-file
If this option is given musrfit will replace the title in the <msr_file> by the run title in the data file of the first run appearing in a RUN block. In case there is no run title in the data file no substitution is done.
--dump <type>
is writing a data file with the fit data and the theory; <type> can be ascii (data in columns) or root (data in ROOT histograms)
-
--timeout <timeout_tag>
overwrites the predefined timeout tag 'none'. <timeout_tag>='none' means the timeout facility is not enabled. <timeout_tag> = nn will set the timeout to nn (sec). If during a fit this timeout is reached, musrfit will terminate. This is used to prevent orphan musrfit process to jam the system.
+
--timeout <timeout_tag>
overwrites the predefined timeout of 3600 sec. <timeout_tag><=0 means the timeout facility is not enabled. <timeout_tag> > 0, e.g. nn will set the timeout to nn (sec). If during a fit this timeout is reached, musrfit will terminate. This is used to prevent orphan musrfit process to jam the system.
--help
displays a small help notice in the shell explaining the basic usage of the program
--version
prints the version number of musrfit
@@ -1044,6 +1039,17 @@ The PLOT block is intended to collect all the information needed for the graphic
If no plot range is given at all, the fit range of the first run also serves as time window for the plot. In the case no information on the axis of ordinates is available, the plotting range is chosen so that all data can be presented.
It is possible to define multiple PLOT blocks. Each PLOT block generates its own ROOT canvas.
+
+ A few comments concerning the rotating reference frame (rrf) plot option: the idea of the rrf is to transform a high frequency μSR spectrum into a low frequency spectrum. This is essentially done by multiplying the original asymmetry by . This leads to two frequency shifted copies of the original , one shifted downwards in frequency by (to wanted one) and one upwards (unwanted one). In order to get rid of the upward shifted spectrum, the rrf_packing is used, we just over-bin the high frequency copy (for now. In the future this will be dealt with FIR filtering)! The theory, however, is filtered via Kaiser filter. Here a short example:
+
+
I am very much indebted to BMW for his rigorous testing of musrfit, his many useful suggestions, contributions, and for the largest part of the user manual of musrfit which makes it accessible to a broader audience! Many thanks Bastian!
Setting up musrfit on Different Platforms
@@ -339,7 +334,7 @@ musrview test-histo-ROOT-NPP.msr
Notes
-1: In case only a single user is working at the machine it might be considerable to change the ownership of the ROOT folder so that the user has easy write access to this directory:
+1: In case only a single user is working at the machine it might be considerable to change the ownership of the ROOT folder so that the user has easy write access to this directory: 2: When using GCC ≥ 4.2 please make sure that the environment variables USE_PARALLEL_MINUIT2 and USE_OPENMP are not set! Otherwise MINUIT2 will be compiled with parallelization support and cannot be used together with musrfit afterwards since the musrfit code is not fully thread-safe! When compiled with GCC ≥ 4.2 musrfit itself will parallelize the χ2 calculation.
@@ -529,7 +524,7 @@ With Mac OS X the situation is up to some extent similar like on MS Windows but
5.1 Requirements (MacPorts)
5.1.1 Everything but ROOT and NeXus
Before proceeding with the usage of the MacPorts system first a few useful tools provided by Apple together with OS X (on the installation DVD/CDs) should be installed:
Useful developer tools including for instance the GNU compiler collection. Starting from XCode >= 4.3 the command line tools need to be installed manually.
X11
The X-window system (automatically installed on 10.5 Leopard and 10.6 Snow Leopard)
@@ -586,9 +581,12 @@ For installing the ROOT system there are two independent Visit the ROOTweb page and download the packed precompiled binary version matching the OS X version. Then unpack the bundle to its final destination (e.g. /opt/root-system).
If there is no precompiled binary version of ROOT available for your system or e.g. ROOT should be compiled with another version of GCC visit the web page and download the 'complete source tree for all systems'. Then unpack this source tree to its destination (e.g. /opt/root-system). In case only a single user is working at the machine it might be considerable to change the ownership of the ROOT folder so that the user ("username" in the example) has easy write access to this directory:
sudo chown -R username:staff /opt/root-system/
Finally, ROOT can be configured (here using the minimal set of options) and compiled as stated right below:
cd /opt/root-system
-./configure --gminimal --enable-asimage --enable-mathmore --enable-minuit2 --enable-xml
+./configure --gminimal --enable-fink --enable-asimage --enable-mathmore --enable-minuit2 --enable-xml
make
+
In case you are just migrating to the latest Mac OS X version (e.g. from 10.7 to 10.8.1) often for a period of a few weeks it is necessary to work with the SVN trunk version of ROOT, i.e. that you have to checkout ROOT via svn:
+svn co https://root.cern.ch/svn/root/trunk root
+
In order to finalize the ROOT installation and to prepare already the installation of musrfit and musrgui / musredit this is a good time for setting necessary environment variables for the use in Mac OS X. Put the following lines (without the comments in parentheses and with the paths adjusted to your local installation) into the file ~/.MacOSX/environment.plist and re-login:
@@ -802,30 +800,81 @@ cd doc/examples
musrview test-histo-ROOT-NPP.msr
--- BMW & AS
@@ -318,166 +313,93 @@ Besides the functions described above and which are mostly interfacing mus
For reporting bugs or requesting new features and improvements please use the PSI Tracker or send an e-mail to A. Suter.
--- BMW & AS
Introduction
@@ -264,30 +259,81 @@ RUN 2008/lem08_his_8472 MUE4 PSI ROOT-NPP (name beamline institute dat
In the above example musrfit reads the data from the file superconductor-data.db; the x and y data are specified by the DB parameter names range and field. An alternative specification of the x and y data by the parameter number in the DB file is also possible!
The μSR-data-analysis process using musrfit is based on so-called msr files. These files contain all information needed for the analysis such as names of the data files, a theory function, fit and plot parameters, and so on. It is the idea of this page to explain the basic use of an msr file and the different programs of the musrfit suite using the example of a single-histogram fit to time-differential transverse-field μSR data. For a complete description of all options please refer to the manual.
@@ -275,106 +270,93 @@ This page only summarizes the very basic features and options of the programs co
by 
. This leads to two frequency shifted copies of the original 
(to wanted one) and one upwards (unwanted one). In order to get rid of the upward shifted spectrum, the 
