File	Date	Author	Commit
doc	2012-10-12	FF Wilson	[5502fa] Commit V00-02-02 as 1st version in git repository
GNUmakefile	2012-10-12	FF Wilson	[5502fa] Commit V00-02-02 as 1st version in git repository
History	2013-10-30	FF Wilson	[dbbcb5] Commit V00-02-06
README	2012-10-12	FF Wilson	[5502fa] Commit V00-02-02 as 1st version in git repository
RooBallack.cc	2012-10-12	FF Wilson	[5502fa] Commit V00-02-02 as 1st version in git repository
RooBallack.rdl	2012-10-12	FF Wilson	[5502fa] Commit V00-02-02 as 1st version in git repository
RooBinnedPdf.cc	2012-10-12	FF Wilson	[5502fa] Commit V00-02-02 as 1st version in git repository
RooBinnedPdf.rdl	2012-10-12	FF Wilson	[5502fa] Commit V00-02-02 as 1st version in git repository
RooCruijff.cc	2012-10-12	FF Wilson	[5502fa] Commit V00-02-02 as 1st version in git repository
RooCruijff.rdl	2012-10-12	FF Wilson	[5502fa] Commit V00-02-02 as 1st version in git repository
RooFlatte.cc	2012-10-12	FF Wilson	[5502fa] Commit V00-02-02 as 1st version in git repository
RooFlatte.rdl	2012-10-12	FF Wilson	[5502fa] Commit V00-02-02 as 1st version in git repository
RooGounarisSakurai.cc	2012-10-12	FF Wilson	[5502fa] Commit V00-02-02 as 1st version in git repository
RooGounarisSakurai.rdl	2012-10-12	FF Wilson	[5502fa] Commit V00-02-02 as 1st version in git repository
RooLass.cc	2012-10-12	FF Wilson	[5502fa] Commit V00-02-02 as 1st version in git repository
RooLass.rdl	2012-10-12	FF Wilson	[5502fa] Commit V00-02-02 as 1st version in git repository
RooOsipDisc.cc	2012-10-12	FF Wilson	[5502fa] Commit V00-02-02 as 1st version in git repository
RooOsipDisc.rdl	2012-10-12	FF Wilson	[5502fa] Commit V00-02-02 as 1st version in git repository
RooRelBreitWigner.cc	2012-10-12	FF Wilson	[5502fa] Commit V00-02-02 as 1st version in git repository
RooRelBreitWigner.rdl	2012-10-12	FF Wilson	[5502fa] Commit V00-02-02 as 1st version in git repository
RooThreshold.cc	2012-10-12	FF Wilson	[5502fa] Commit V00-02-02 as 1st version in git repository
RooThreshold.rdl	2012-10-12	FF Wilson	[5502fa] Commit V00-02-02 as 1st version in git repository
rarAdd.cc	2012-10-12	FF Wilson	[5502fa] Commit V00-02-02 as 1st version in git repository
rarAdd.rdl	2012-10-12	FF Wilson	[5502fa] Commit V00-02-02 as 1st version in git repository
rarArgusBG.cc	2012-10-12	FF Wilson	[5502fa] Commit V00-02-02 as 1st version in git repository
rarArgusBG.rdl	2012-10-12	FF Wilson	[5502fa] Commit V00-02-02 as 1st version in git repository
rarBallack.cc	2012-10-12	FF Wilson	[5502fa] Commit V00-02-02 as 1st version in git repository
rarBallack.rdl	2012-10-12	FF Wilson	[5502fa] Commit V00-02-02 as 1st version in git repository
rarBasePdf.cc	2013-10-30	FF Wilson	[dbbcb5] Commit V00-02-06
rarBasePdf.rdl	2012-10-12	FF Wilson	[5502fa] Commit V00-02-02 as 1st version in git repository
rarBifurGauss.cc	2012-10-12	FF Wilson	[5502fa] Commit V00-02-02 as 1st version in git repository
rarBifurGauss.rdl	2012-10-12	FF Wilson	[5502fa] Commit V00-02-02 as 1st version in git repository
rarBinned.cc	2012-10-12	FF Wilson	[5502fa] Commit V00-02-02 as 1st version in git repository
rarBinned.rdl	2012-10-12	FF Wilson	[5502fa] Commit V00-02-02 as 1st version in git repository
rarCBShape.cc	2012-10-12	FF Wilson	[5502fa] Commit V00-02-02 as 1st version in git repository
rarCBShape.rdl	2012-10-12	FF Wilson	[5502fa] Commit V00-02-02 as 1st version in git repository
rarCompBase.cc	2012-10-12	FF Wilson	[5502fa] Commit V00-02-02 as 1st version in git repository
rarCompBase.rdl	2012-10-12	FF Wilson	[5502fa] Commit V00-02-02 as 1st version in git repository
rarConfig.cc	2013-10-30	FF Wilson	[dbbcb5] Commit V00-02-06
rarConfig.rdl	2012-10-12	FF Wilson	[5502fa] Commit V00-02-02 as 1st version in git repository
rarCruijff.cc	2012-10-12	FF Wilson	[5502fa] Commit V00-02-02 as 1st version in git repository
rarCruijff.rdl	2012-10-12	FF Wilson	[5502fa] Commit V00-02-02 as 1st version in git repository
rarDatasetDef.cc	2012-10-12	FF Wilson	[5502fa] Commit V00-02-02 as 1st version in git repository
rarDatasetDef.rdl	2012-10-12	FF Wilson	[5502fa] Commit V00-02-02 as 1st version in git repository
rarDatasets.cc	2012-10-12	FF Wilson	[5502fa] Commit V00-02-02 as 1st version in git repository
rarDatasets.rdl	2012-10-12	FF Wilson	[5502fa] Commit V00-02-02 as 1st version in git repository
rarDecay.cc	2012-10-12	FF Wilson	[5502fa] Commit V00-02-02 as 1st version in git repository
rarDecay.rdl	2012-10-12	FF Wilson	[5502fa] Commit V00-02-02 as 1st version in git repository
rarExp.cc	2012-10-12	FF Wilson	[5502fa] Commit V00-02-02 as 1st version in git repository
rarExp.rdl	2012-10-12	FF Wilson	[5502fa] Commit V00-02-02 as 1st version in git repository
rarFit.cc	2012-10-12	FF Wilson	[5502fa] Commit V00-02-02 as 1st version in git repository
rarFlatte.cc	2012-10-12	FF Wilson	[5502fa] Commit V00-02-02 as 1st version in git repository
rarFlatte.rdl	2012-10-12	FF Wilson	[5502fa] Commit V00-02-02 as 1st version in git repository
rarGaussModel.cc	2012-10-12	FF Wilson	[5502fa] Commit V00-02-02 as 1st version in git repository
rarGaussModel.rdl	2012-10-12	FF Wilson	[5502fa] Commit V00-02-02 as 1st version in git repository
rarGaussian.cc	2012-10-12	FF Wilson	[5502fa] Commit V00-02-02 as 1st version in git repository
rarGaussian.rdl	2012-10-12	FF Wilson	[5502fa] Commit V00-02-02 as 1st version in git repository
rarGeneric.cc	2012-10-12	FF Wilson	[5502fa] Commit V00-02-02 as 1st version in git repository
rarGeneric.rdl	2012-10-12	FF Wilson	[5502fa] Commit V00-02-02 as 1st version in git repository
rarGounarisSakurai.cc	2012-10-12	FF Wilson	[5502fa] Commit V00-02-02 as 1st version in git repository
rarGounarisSakurai.rdl	2012-10-12	FF Wilson	[5502fa] Commit V00-02-02 as 1st version in git repository
rarHistPdf.cc	2012-10-12	FF Wilson	[5502fa] Commit V00-02-02 as 1st version in git repository
rarHistPdf.rdl	2012-10-12	FF Wilson	[5502fa] Commit V00-02-02 as 1st version in git repository
rarKeys.cc	2012-10-12	FF Wilson	[5502fa] Commit V00-02-02 as 1st version in git repository
rarKeys.rdl	2012-10-12	FF Wilson	[5502fa] Commit V00-02-02 as 1st version in git repository
rarLass.cc	2012-10-12	FF Wilson	[5502fa] Commit V00-02-02 as 1st version in git repository
rarLass.rdl	2012-10-12	FF Wilson	[5502fa] Commit V00-02-02 as 1st version in git repository
rarMLFitter.cc	2013-10-30	FF Wilson	[dbbcb5] Commit V00-02-06
rarMLFitter.rdl	2012-10-12	FF Wilson	[5502fa] Commit V00-02-02 as 1st version in git repository
rarMLPdf.cc	2012-10-12	FF Wilson	[5502fa] Commit V00-02-02 as 1st version in git repository
rarMLPdf.rdl	2012-10-12	FF Wilson	[5502fa] Commit V00-02-02 as 1st version in git repository
rarMinuit.cc	2012-10-12	FF Wilson	[5502fa] Commit V00-02-02 as 1st version in git repository
rarMinuit.rdl	2012-10-12	FF Wilson	[5502fa] Commit V00-02-02 as 1st version in git repository
rarMultPdf.cc	2012-10-12	FF Wilson	[5502fa] Commit V00-02-02 as 1st version in git repository
rarMultPdf.rdl	2012-10-12	FF Wilson	[5502fa] Commit V00-02-02 as 1st version in git repository
rarNLL.cc	2012-10-12	FF Wilson	[5502fa] Commit V00-02-02 as 1st version in git repository
rarNLL.rdl	2013-10-30	FF Wilson	[dbbcb5] Commit V00-02-06
rarNovosibirsk.cc	2012-10-12	FF Wilson	[5502fa] Commit V00-02-02 as 1st version in git repository
rarNovosibirsk.rdl	2012-10-12	FF Wilson	[5502fa] Commit V00-02-02 as 1st version in git repository
rarOsipDisc.cc	2012-10-12	FF Wilson	[5502fa] Commit V00-02-02 as 1st version in git repository
rarOsipDisc.rdl	2012-10-12	FF Wilson	[5502fa] Commit V00-02-02 as 1st version in git repository
rarPoly.cc	2012-10-12	FF Wilson	[5502fa] Commit V00-02-02 as 1st version in git repository
rarPoly.rdl	2012-10-12	FF Wilson	[5502fa] Commit V00-02-02 as 1st version in git repository
rarProd.cc	2012-10-12	FF Wilson	[5502fa] Commit V00-02-02 as 1st version in git repository
rarProd.rdl	2012-10-12	FF Wilson	[5502fa] Commit V00-02-02 as 1st version in git repository
rarRelBreitWigner.cc	2012-10-12	FF Wilson	[5502fa] Commit V00-02-02 as 1st version in git repository
rarRelBreitWigner.rdl	2012-10-12	FF Wilson	[5502fa] Commit V00-02-02 as 1st version in git repository
rarSPlot.cc	2012-10-12	FF Wilson	[5502fa] Commit V00-02-02 as 1st version in git repository
rarSPlot.rdl	2012-10-12	FF Wilson	[5502fa] Commit V00-02-02 as 1st version in git repository
rarSimPdf.cc	2012-10-12	FF Wilson	[5502fa] Commit V00-02-02 as 1st version in git repository
rarSimPdf.rdl	2012-10-12	FF Wilson	[5502fa] Commit V00-02-02 as 1st version in git repository
rarStep.cc	2012-10-12	FF Wilson	[5502fa] Commit V00-02-02 as 1st version in git repository
rarStep.rdl	2013-10-30	FF Wilson	[dbbcb5] Commit V00-02-06
rarStrParser.cc	2012-10-12	FF Wilson	[5502fa] Commit V00-02-02 as 1st version in git repository
rarStrParser.rdl	2012-10-12	FF Wilson	[5502fa] Commit V00-02-02 as 1st version in git repository
rarThreshold.cc	2012-10-12	FF Wilson	[5502fa] Commit V00-02-02 as 1st version in git repository
rarThreshold.rdl	2012-10-12	FF Wilson	[5502fa] Commit V00-02-02 as 1st version in git repository
rarToyList.cc	2012-10-12	FF Wilson	[5502fa] Commit V00-02-02 as 1st version in git repository
rarToyList.rdl	2012-10-12	FF Wilson	[5502fa] Commit V00-02-02 as 1st version in git repository
rarTriGauss.cc	2012-10-12	FF Wilson	[5502fa] Commit V00-02-02 as 1st version in git repository
rarTriGauss.rdl	2012-10-12	FF Wilson	[5502fa] Commit V00-02-02 as 1st version in git repository
rarTwoGauss.cc	2012-10-12	FF Wilson	[5502fa] Commit V00-02-02 as 1st version in git repository
rarTwoGauss.rdl	2012-10-12	FF Wilson	[5502fa] Commit V00-02-02 as 1st version in git repository
rarUniform.cc	2012-10-12	FF Wilson	[5502fa] Commit V00-02-02 as 1st version in git repository
rarUniform.rdl	2012-10-12	FF Wilson	[5502fa] Commit V00-02-02 as 1st version in git repository
rarUsrPdf.cc	2012-10-12	FF Wilson	[5502fa] Commit V00-02-02 as 1st version in git repository
rarUsrPdf.rdl	2012-10-12	FF Wilson	[5502fa] Commit V00-02-02 as 1st version in git repository
rarVersion.hh	2013-10-30	FF Wilson	[dbbcb5] Commit V00-02-06
rarVoigtian.cc	2012-10-12	FF Wilson	[5502fa] Commit V00-02-02 as 1st version in git repository
rarVoigtian.rdl	2012-10-12	FF Wilson	[5502fa] Commit V00-02-02 as 1st version in git repository
submitToy	2012-10-12	FF Wilson	[5502fa] Commit V00-02-02 as 1st version in git repository

Read Me

RooRarFit is a General Maximum Likelihood Fitter Package based on ROOT/RooFit

Documentation
-------------

See the website at http://rarfit.sourceforge.net. The source code for
the documentation is included in the download file and can be
recreated using doxygen or makeinfo. See make file in ./doc
subdirectory.

Installation
------------

Download the tar file from http://rarfit.sourceforge.net. Before
compiling, make sure ROOT is installed (http://root.cern.ch/drupal)
and that $ROOTSYS is defined.

> echo $ROOTSYS
> tar -zxvf RooRarFit.VXX-YY-ZZZ.tar.gz
> cd RooRarFit
> make -f GNUmakefile bin

This will create the executable in ./tmp

> ./tmp/rarFit

Assuming ./tmp is in your path, you can run the code using some of the
examples from below e.g. :

> rarFit -A PdfAct doc/tutorial/tutorial.config

Regression testing data
-----------------------

To generate a dataset that can be used for regression testing or tutorials:

) make sure $ROOTSYS is defined
) create a subdirectory ./Ntuples
) run the command:
> $ROOTSYS/bin/root -b -q -l doc/tutorial/make_data.C |& tee make_data.txt

This will create 3 datasets (in ascii and root format) in ./Ntuples

Ntuples/tut_bkg.{dat,root}
Ntuples/tut_signal.{dat,root}
Ntuples/tut_uds.{dat,root}

The dataset is a simulated B0/B0bar (or B+/B-) decay at the
b-factories. The dataset can be used to measure branching fractions,
charge CP asymmetries and Time-dependent CP Violation with
event-by-event errors.

The datasets contain the following variables:

) mes : B mass (GeV/c^2).
) deltae : Difference in energy of B and sqrt(s)/2 (GeV).
) mass : A resonance mass (GeV/c^2).
) nn : a Multi-Variate distribution (e.g. Fisher).
) dt : Time difference between the two B decays (ps).
) tag : Flavour tag (B0=1,B0bar=-1) if data treated as B0/B0bar decay.
) sigmode : a flag that indicates if the K* decayed to K+pi- or K0s
pi0. This can be used as a test of Simultaneous fits and branching
fraction measurements.
) charge : the charge (B+=+1,B-=-1) if data treated as B+/B-
decay. The signal has a charge asymmetry Acp = -0.05.
) run : a run number (500/1000=signal, 2000=uds, 3000=bkg).
) dterr : the error on the time difference, dt (ps).

Configuration files
-------------------

Once the dataset has been generated, the configuration files can be
used to test various aspects of RooRarFit

Example 1 (Yields and Actions):
------------------------------

) To fit the PDFs for a signal yield measurement

> rarFit -A PdfAct doc/tutorial/tutorial.config 

) To extract the yield form a simulated "real" dataset

> rarFit -A MLAct doc/tutorial/tutorial.config 

) To generate projection plots of the yield

> rarFit -A ProjAct doc/tutorial/tutorial.config 

) To generate SPlot plots of the yield

> rarFit -A SPlotAct doc/tutorial/tutorial.config 

) To generate a scan of NLL around the yield minimum

> rarFit -A YieldScan doc/tutorial/tutorial.config 

Example 2 (Branching Fraction):
-------------------------------

) To fit the PDFs for a branching fraction:

> rarFit -A PdfAct -C BFAct doc/tutorial/tutorial.config 

) To extract the branching fraction from a simulated "real" dataset

> rarFit -A MLAct -C BFAct doc/tutorial/tutorial.config 

Example 3 (Charged asymmetries):
--------------------------------

) To fit the PDFs for a charged Acp measurement, first change
"simultaneousFit = no" to "simultaneousFit = yes". Then:

> rarFit -A PdfAct doc/tutorial/tutorial.config 

> rarFit -A MLAct doc/tutorial/tutorial.config 

Example 4 (Time dependent asymmetries)
--------------------------------------

) To fit the PDFs for a Time dependent measurement,

> rarFit -A PdfAct doc/tutorial/tutorial_v3.config 

> rarFit -A MLAct doc/tutorial/tutorial_v3.config