How to use the Vancouver fitprogram MSRFIT

Running the program

To start the program you have to type

$run MSRFIT.exe

Comment: Of course you have to specify as well the directory that holds MSRFIT.exe if it's different from your current one. In Munich the symbol nmsr stands for run sys$public:[musr]nmsrfit.exe. The updated version for decwindows holds sys$data:[musr.triumf]msrfit_31jul95.

You'll then get the prompt

TITLE (or Filename)>

Here you have to type the name of the initialfile filename.i (see How to create an initialfile ). The extension of an initialfile has to start with "i", a maximum of three letters is allowed. NMSRFIT will then show you the parameterlist (click here) of the initialfile and also runnumber(s) and label(s) of the run(s) which are specified in the SPECTRUM commands of the initialfile (click here). After this listing the prompt

GUESS >

appears. Here a couple of commands are available. By typing "?&quiot; you'll get a list of available commands:

      
DESCRIBE  MAPPING  QUALITY  SPECTRUM  SIGNAL  PLOT  CHANGE
WRITE  IND_VAR

Here's what these commands do:

DESCRIBE Describes fit function for single histogramm fit (click here or here).

MAPPING Shows title of the initialfile, how many spectra and signals are defined and displays the spectrum and signal parameters (``mapping'').

QUALITY This command does not work in GUESS> but only in RESULTS> and in STATUS>.

This command shows you the number of degrees of freedom, chisquare and the standard deviations received for the fit. Furthermore it gives the same information as under the command SPECTRUM (see next item) except for the fitted value of alpha .

SPECTRUM Gives chisquare and both the number of available bins and how many bins are combined.
You can see the time intervall and background in raw bins as defined in SPECTRUM commands as well as the parameter alpha as defined in the parameterlist.

SIGNAL Shows list of parameters used in SIGNAL commands.

PLOT Command to get graphics (click here)

CHANGE Here parameters can be changed from the initial guess (to get a list of the parameters declared in die initialfile enter -1).

WRITE Here you can specifiy/change the filename of the outputfile (click here).

IND_VAR Here you can enter the independent variable, e.g. field or temperature and errors.

Notice: Commands may be truncated to two characters.

With entering <RET> at GUESS> you'll get into the fit routine

MINUIT>

Here the following commands are available:

       MINIMIZE    SEEK        SIMPLEX     MIGRAD      MINOS
       PUNCH       PRINTOUT    END         FIX         RESTORE
       EXIT        GRADIENT    CALL FCN    MATOUT      COVARIAN
       IMPROVE     ERROR DE    PAGE        HESSE       CONTOUR
       STANDARD                                        END RETU
also  "PEEK"=FCN     5.             and   "CHAN"=FCN     6.

Notice: Commands should not contain leading or embedded blanks, but may be truncated to three characters.

You can quit the MINUIT subroutine by entering exit. You'll then get the prompt

RESULTS>

Here the same commands are available as in GUESS>, but this time the fitted results for the parameters are displayed. Here the QUALITY command works.

Entering <RET> at RESULTS> you'll be asked for the name of the output file:

Input file was MIN=WURZEL.I
Answer file is >

If you don't want to change the name of the outputfile, which was specified in the initialfile or in GUESS> then simply press <RET>. You'll then be asked

Want one last chance to Plot?

If you answer n(o) or simply enter <RET> then the program will finish. If you answer y(es) then the prompt

STATUS>

will appear which is equal to RESULTS> and allows the same commands. Entering <RET> at STATUS> will end the program.

`DESCRIBE`	Describes fit function for single histogramm fit (click here or here).
`MAPPING`	Shows title of the initialfile, how many spectra and signals are defined and displays the spectrum and signal parameters (``mapping'').
`QUALITY`	This command does not work in `GUESS>` but only in `RESULTS>` and in `STATUS>`.
	This command shows you the number of degrees of freedom, `chisquare` and the standard deviations received for the fit. Furthermore it gives the same information as under the command `SPECTRUM` (see next item) except for the fitted value of `alpha` .
`SPECTRUM`	Gives `chisquare` and both the number of available bins and how many bins are combined.
	You can see the time intervall and background in raw bins as defined in `SPECTRUM commands` as well as the parameter `alpha` as defined in the parameterlist.
`SIGNAL`	Shows list of parameters used in `SIGNAL commands`.
`PLOT`	Command to get graphics (click here)
`CHANGE`	Here parameters can be changed from the initial guess (to get a list of the parameters declared in die initialfile enter `-1`).
`WRITE`	Here you can specifiy/change the filename of the outputfile (click here).
`IND_VAR`	Here you can enter the independent variable, e.g. field or temperature and errors.