JFIT: a framework to obtain combined experimental results through joint fits
A master-worker architecture is presented for obtaining combined experimental results through joint fits of datasets from several experiments. The design of the architecture allows such joint fits to be performed keeping the data separated, in its original format, and using independent fitting environments. This allows the benefits of joint fits, such as ensuring that correlations are correctly taken into account and better determination of nuisance parameters, to be harnessed without the need to reformat data samples or to rewrite existing fitting code. The Jfit framework is a C++ implementation of this idea in the Laura package, using dedicated classes of the Root package. We present the Jfit framework, give instructions for its use, and demonstrate its functionalities with concrete examples.
Jfit: a framework to obtain combined experimental results through joint fits
E. Ben-Haim, R. Brun, B. Echenard, T.E. Latham
Laboratoire de Physique Nucléaire et de Hautes Energies (LPNHE), IN2P3/CNRS, Université Pierre et Marie Curie-Paris 6, Université Denis Diderot-Paris 7
European Organization for Nuclear Research (CERN), Geneva, Switzerland
California Institute of Technology, Pasadena, California 91125, USA
Department of Physics, University of Warwick, Coventry CV4 7AL, United Kingdom
In the vast majority of cases, high energy physics experiments obtain measurements by performing a minimum chi-square or a maximum-likelihood fit to their data to extract observables of interest. Combining results of different experiments is routinely performed, using different well-established methods and dedicated tools. In the simplest approach, which is often used, measured observables are assumed to be normally distributed and standard statistical prescriptions are readily applied. However, there are situations in which the procedure is challenging even with the simple normal-distribution hypothesis, in particular for measurements involving a large number of parameters (including nuisance parameters). The size of the covariance matrices, when available, makes the procedure tedious and prone to errors. When non-Gaussian uncertainties are taken into account the combination procedure becomes much more complicated, as working with the actual likelihood or chi-square functions is generally needed. This is indispensable in many complex measurements, in cases with small sample sizes and combination of upper limits. Often only a partial likelihood or chi-square function is considered, which is the projection of the full function on particular parameters of interest, assuming that they are uncorrelated with the other parameters. Ideally, combining measurements should be done by fitting simultaneously the different data samples by means of a joint fit.
The straightforward way to perform joint fits involves collecting data in a common format, and has been implemented, among others, in the RooFit package . This solution could however be inefficient if dedicated fitting frameworks have already been developed, especially for complex fit models. It may also raise issues with data access policies of each experiment. An alternative approach consists of performing a joint fit while keeping the data separated. This can be achieved using a master-worker architecture, in which the master drives the fit by combining the values of the likelihood functions returned by several workers, each of which is specific to an experiment and accesses its own dataset.
In this paper we present Jfit: an implementation of this idea within the Laura package  that uses several classes from the Root framework . In Sec. 2, we revisit the general formalism of joint fitting, and briefly advocate its advantages. In Sec. 3 we explain the concept of the master-worker architecture and describe in detail the Jfit implementation of such an architecture in the C++ programming language. We also provide details of how to minimally adapt existing fitting codes in order to use them within the framework.
2 Joint fits and their benefits
The formalism to combine several measurements by performing a joint maximum-likelihood fit
where is a random variable (or a set of several random variables) with corresponding ensembles of independent observations, designated by and , in the two datasets; and are the probability density functions followed by in the two datasets; denotes the parameters of interest that are shared by the two datasets, and have to be simultaneously extracted from both (common parameters); and are parameters that are specific for and (specific parameters).
Joint fitting to combine results from two experiments has many advantages compared to naïve averaging methods. These benefits mainly derive from the fact that joint fits take into account the correlations between all fit parameters, not just those of primary interest. The exploration of the full likelihood surface, rather than some projection of it, can result in a more reliable estimation of both the central value and the statistical uncertainties. These uncertainties can also be reduced because common nuisance parameters can be better constrained, which leads to improved precision on the parameters of interest.
The estimation of systematic uncertainties is also made more straightforward. In particular, uncertainties originating from an external source, such as a measured property of a background process, can be accounted for simply by repeating the joint fits using a set of modified assumptions about that external input. Furthermore, the need to assume a particular degree of correlation among the experiments is eliminated. When performing naïve averages, systematic uncertainties are generally taken to be either fully correlated or completely uncorrelated among the experiments whose results are being combined. But in reality there can be differences in how each experiment is affected. For example, when performing a fit to an invariant mass distribution, different patterns of migration between event species in each experiment may lead to quite different effects on the signal yield when varying the rate of a particular background.
All of the benefits mentioned here are demonstrated by two examples from the domain of high energy physics, which are presented in Appendix B. The joint fits in the examples were realised by applying the Jfit implementation described in Sec. 3. In addition, it is noted that there are other positive side effects of joint fitting, besides those that are exemplified in the appendices, arising from obliging collaborations to coordinate their models and conventions prior to performing their analyses.
3 The master-worker architecture and the JFIT framework
In the master-worker approach, the master drives the fit by sending sets of parameters to the experiment-specific workers. Each worker returns the value of the likelihood function to the master, which in turn updates the parameters using an optimisation routine, such as the MIGRAD algorithm of the MINUIT optimisation package , which is widely used in the field of high energy physics. The procedure is repeated until the fit has converged. This architecture keeps the calculation of the individual likelihood functions and separate, allowing a flexible treatment of any experiment-specific parameters, which can either be controlled by the master, or declared only within the corresponding worker. In the second case, the workers perform an additional minimisation with respect to their specific parameters at each step of the procedure, keeping the common parameters fixed. The values of the minimised functions are then returned to the master. Performing joint fits using such an architecture has several advantages:
any fitting algorithm can be readily incorporated as a worker in this scheme;
there is no requirement that the workers be homogeneous;
the data do not need to be rewritten in any external format and can be readily used;
experimental collaborations can keep private their data and procedures.
The Jfit framework is an open-source implementation of a master-worker architecture in the C++ programming language. It has been developed within the Laura package , using elements from the Root data analysis framework . While the main purpose of the Laura package is performing Dalitz-plot analyses in high-energy physics, Jfit can be easily used in other contexts. The structure of the Jfit implementation is based on the following steps:
Initialisation: both master and workers initialise their internal structure to either drive the fit (master) or calculate the likelihood given a set of parameters (workers).
Synchronisation: the master-worker communications are handled using several classes in the Root framework.
3The master starts a server, by instantiating a TServerSocket object with the number of the port to which it should be bound, and waits for the worker nodes to connect. To establish a connection, each worker instantiates a TSocket object by specifying the hostname and port number of the master. The master receives the connection in the form of another TSocket object, which it stores in a TMonitor instance. The connections can be secured, e.g. via ssh, if required. After successfully connecting, each worker awaits instructions from the master. There then follows an exchange of information regarding the parameters known to each worker and their initial values. All such communications in this and subsequent steps are conducted using instances of the TMessage class, which is a I/O buffer into which basic types and more complex objects can be serialised for transmission via the network sockets.
Minimisation: the master starts the fitting procedure by sending a set of parameter values to the workers and waits for their replies. Upon receipt of the parameters, each worker calculates the value of its corresponding likelihood function and sends the result back to the master. The worker results are then combined by the master and given to the optimiser, which updates the fit parameters and the master then sends a new request to the workers. This step is repeated until convergence is achieved. The uncertainties on the parameters are evaluated by a dedicated procedure that uses the same logic and tools for the communication between the master and workers.
Termination: the master returns the results of the fit and terminates the connections with the workers.
The master routines are implemented within the LauSimFitMaster class  in the Laura package, while the communication methods of the workers are implemented in the LauSimFitSlave abstract base class . The main tasks of the master are to set up and provide the appropriate information to the minimiser, to keep track of which fit parameters are associated with which of the workers, and to communicate with the workers so as to delegate the calculation of the likelihood and other pre- and post-processing tasks. The worker communication methods respond to the various messages from the master and call the appropriate pure virtual member function, the implementation of which in the concrete derived classes should then perform the required actions.
As a consequence, a large fraction of code developed by each experiment to perform dedicated fits can be readily reused in this scheme; it requires only the addition of a class that inherits from LauSimFitSlave. This class should implement the functions that are pure virtual in the base class in such a way as to call the appropriate parts of the pre-existing code to perform the actions required at each stage of the fit (e.g., calculating the likelihood value). Internal changes in one experiment (e.g. new data format or additional specific parameters) require only a modification of this class and are otherwise completely transparent to the framework. More specifically, to write a class that inherits from LauSimFitSlave involves writing the implementation of the following eight pure virtual member functions:
initialise: perform any actions required to ensure that the fit model is ready to be applied to the data;
verifyFitData: read the data to be fitted and verify that all required variables are present; the name of the data file and (optionally) the name of a particular structure within the file, e.g. a Root tree, will have been provided by the user when calling the LauSimFitSlave::runSlave function and they are passed on as arguments to this function;
prepareInitialParArray: the fit parameters that are to be varied in the fit should be inserted, in the form of LauParameter objects, into the TObjArray that is the argument to the function;
readExperimentData: read the data for the current experiment into memory;
cacheInputFitVars: allow the fit model to cache any information that it can from the data;
setParsFromMinuit: update all fit parameters with the new values provided by the minimiser;
getTotNegLogLikelihood: calculate the negative log likelihood;
finaliseExperiment: store the fit results, in particular the fit status, negative log likelihood, covariance matrix and final parameter values and uncertainties; perform any necessary post-processing (e.g. rotation of phases into a particular interval) of the parameters and then return them to the master.
An example of such a derived class, which uses the RooFit framework to build the fit model and evaluate the likelihood, is shown in Appendix C.
It is important to note that the Jfit framework can also be used to perform simultaneous fits to different datasets within an experiment. For example, it has been used in Ref.  to account for the different variation over phase space of the signal reconstruction efficiency in different trigger categories. In addition, it has been used in Ref.  to enable the extraction of both -violation and hadronic parameters from a simultaneous fit to multiple decay channels.
The overhead introduced by the Jfit framework itself is small. For instance, in the example in Appendix B.2 the mean time for each individual fit to be performed was 33 seconds (with an RMS of 6 seconds), while the joint fits using Jfit took 35 seconds (with an RMS of 5 seconds).
In this paper, we have presented Jfit: a software framework for obtaining combined experimental results through joint fits of datasets from several experiments. The primary goal of the Jfit framework is to permit experimental collaborations to straightforwardly perform joint fits by allowing them to plug in their existing fitting software and to use their data in its original format. It is implemented in the Laura Dalitz-plot analysis package , using the network communication classes (TMessage, TMonitor, TServerSocket and TSocket) from the Root framework. The use of Jfit is not limited to the context of Dalitz-plot analyses.
Advantages of joint fitting have been discussed. Correctly accounting for correlations between parameters in likelihood functions in different experiments, which is an intrinsic property of such fits, results in improved combinations, and more reliable uncertainties. Thus, these fits provide a means to better exploit data from multiple experiments. The Jfit framework, based on a master-worker architecture, allows joint fits to be performed keeping the data separated and using independent, heterogeneous fitting programs. It simplifies the process with respect to data access policies and allows existing code to be reused with minimal changes, thus saving resources.
The work presented in this paper was started in the purpose of performing joint analyses between the BABAR and Belle collaborations. We would like to thank François Le Diberder both for initiating and generating interest in this project among the BABAR and Belle collaborations and the authors of Root, and for fruitful discussions concerning this paper. We would also like to thank Roger Barlow for his extremely valuable advice and comments regarding the statistical aspects and examples, and Tim Gershon and Matthew Charles for their very helpful input on the manuscript. This work is supported by the Science and Technology Facilities Council (United Kingdom), the European Research Council under FP7, and the US Department of Energy under grants DE-FG02-92ER40701 and DE-SC0011925.
Appendix A Maximum-likelihood estimation
Maximum-likelihood estimation is a widely-used method of fitting parameters of a model to some data and providing an estimate of their uncertainties. Here we briefly review this technique; more details can be found in statistics textbooks, and, for example, in Ref. .
Consider a set of independent observations of a random variable following a probability density function modelled by , where denotes the unknown model parameter(s) that should be estimated. Both and can be multidimensional. The likelihood function is defined as:
Since the observations are given, the likelihood is only a function of . The resulting estimate of the parameter is defined as the value that maximises the likelihood, i.e.
It is often convenient to minimise the negative logarithm of the likelihood (NLL) instead of maximising the likelihood, which yields the same value of . If the number of observations is random, an additional term is usually included in the likelihood to form the so-called extended likelihood:
where denotes the expected number of events. Obtaining combined measurements from several datasets is achieved by maximising the product of likelihoods from the different datasets, as discussed in Sec. 2.
The minimisation of the NLL can be, and usually is, done numerically. Among the packages available to perform this task, MINUIT  is one of the most popular in the field of high energy physics. Its default algorithm, MIGRAD, is based on a variable-metric method that computes the value of the function and its gradient at each step of the procedure. If the functional form of the derivative is not, or cannot be supplied by the user, the gradient is evaluated by finite differences. The minimisation stops when the difference of the value of the function between two successive steps reaches a specific threshold. Parabolic uncertainties on the parameters are estimated by inverting the matrix of second derivatives evaluated at the minimum of the function. In the case of non-Gaussian likelihood, the uncertainties are estimated by an algorithm that scans the likelihood for each parameter separately, minimising the likelihood each time with respect to the remaining parameters.
Appendix B Examples demonstrating the benefits of joint fitting
All the fits performed within the two examples described in this appendix have been realised by applying the Jfit framework.
b.1 Resonance mass and rate measurement
As a first example, we examine the problem of combining the results of two experiments that found a resonance in an invariant mass spectrum, at a mass of . The parameters of interest are:
the mass of the resonance, ;
its observed rate in the final state under study, which results from the product of the production cross section, , and the decay branching fraction, , normalised to its expected value, e.g., that predicted by a particular model, .
These are obtained from a one-dimensional maximum-likelihood fit to the distribution of invariant mass, , of the final-state particles.
Samples corresponding to the datasets of experiments 1 and 2 are generated in the invariant-mass range according to a model containing three events species: signal, peaking background and combinatorial background. Signal events are generated from a sum of two Crystal Ball (CB) functions : core and tail, with different peak positions. Peaking and combinatorial background events are generated from a Gaussian and a fourth order Chebyshev polynomial function, respectively. This model is roughly inspired by the search for the Standard Model Higgs boson from ATLAS  and CMS , although, with rather different event yields and signal to background ratios. For simplicity, the same signal and background models are used to generate events for both experiments. Hence, both the underlying physics and some experimental factors, such as the resolution, are assumed to be unique. However, to emulate in a simple way different overall efficiencies and event-selection strategies, the datasets corresponding to the two experiments have significantly different numbers of signal and background events. In both cases, the mean value of the signal yield corresponds to . Five hundred pairs of datasets are generated, where the numbers of events of each species are Poisson-distributed, using probability density functions (PDFs) that are summarised in Table 1. The invariant mass distribution of experiment 1 is shown in Fig. 1.
|Signal||Sum of two CB functions (core and tail)||(experiment 1)||3000|
|Fraction of tail||10%|
|Peaking background||Gaussian||(experiment 1)||1000|
|Combinatorial background||\nth4 order Chebyshev polynomial||(experiment 1)||60000|
The maximum-likelihood fits are performed in the same invariant-mass range, . Again, the same model is used for the two experiments. However, the fitted model differs slightly from that used to generate events in order to account for the lack of knowledge of the underlying physics. The invariant mass of the signal is modelled by the sum of a Crystal Ball function, describing the core distribution, and a Gaussian describing the tails. Backgrounds are modelled by the same functional forms used to generate events. The signal peak position and all the combinatorial background parameters are varied in the fit, as well as the yields of the three events species. All the other parameters are fixed. The PDFs used in the fits are summarised in Table 2.
|Signal||Sum of a core CB function and a Gaussian tail||varied|
|Fraction of tail||Gen.|
|Combinatorial background||\nth4 order Chebyshev polynomial||varied|
|, , ,||varied|
After fitting each of the individual samples, we obtain combined results for the mass of the resonance and its rate by two different methods:
a naïve average of the individual results, taking into account the parabolic uncertainties of the fits to the individual samples;
a joint fit to the two samples in the Jfit framework, using the full likelihood function.
As the likelihood functions are fairly Gaussian, asymmetric uncertainties have not been considered for the naïve averaging. The typical statistical uncertainty obtained by the two methods is (corresponding to a relative uncertainty) for the normalised rate and for the mass of the resonance. Moreover, no bias has been observed in the extraction of the mass of the resonance by the two methods, while they both show a negative bias in the extraction of the rate, as expected from the different signal models used to generate and fit the data samples: the former has a wider signal peak than the latter. The results of the two methods for the resonance rate are compared in Fig. 2. In this particular case, the bias induced by the two methods is similar and thus the central values are in good agreement. There is a small effect on the statistical uncertainty, which is very slightly larger in naïve averages. This behaviour may differ, in size and direction, in other cases. However, as the joint fits correctly take into account all correlations, they provide more reliable results.
We expect larger differences between the two combination methods to arise when systematic uncertainties are evaluated. Parameters of the peaking background are considered to be badly known and, as such, to be sources of systematic uncertainties. To evaluate the effect from the width of the distribution, the corresponding PDF parameter is fixed to values above and below its nominal value, namely 3.0 and 7.0. The variations of the resulting resonance mass and rate are considered as systematic uncertainties. The same procedure is applied in individual and joint fits. Figure 3 shows a comparison between the systematic uncertainties obtained in naïve averages, where the individual systematic effects are considered to be 100% correlated, and in joint fits. Differences are due to the fact that correlations are correctly taken into account in joint fitting. The comparison shows clearly that the effect on systematic uncertainties can be large (in some cases around 50% of the statistical uncertainty or 10% of the systematic uncertainty), and they may be either underestimated or overestimated by naïvely averaging the results.
b.2 Amplitude analysis of a hadronic three-body -meson decay
A second example is from the domain of flavour physics. It involves a larger number of parameters in the fit, and illustrates other advantages of joint fitting. For simplicity, we consider signal events only.
A key part of the physics programme of the -factories, BABAR and Belle, consisted of amplitude (Dalitz-plot) analyses of 3-body -meson decays . More recently such studies are performed by the LHCb experiment (see, for example, Refs.[14, 15, 16]), and, in the near future, will be also undertaken by Belle-II. These analyses provide measurements of CKM angles and access to observables sensitive to physics beyond the Standard Model of particle physics as well as information on the resonant structure of decays.
In general, Dalitz-plot analyses are limited by the sample size, and they usually have a strong dependence on model assumptions. Due to these characteristics, a joint analysis, profiting in a coherent way of all the available data, could be a particularly fruitful approach compared to a simple combination of results from separate analyses. One of the first steps in Dalitz-plot analyses consists of determining which resonant or non-resonant intermediate states should be included as components of the signal model. It is important to notice that minor, poorly determined signal components are a major source of the so called âmodel uncertaintyâ that is often a large systematic effect in such analyses. A joint analysis provides a more powerful determination of the components to be included in the signal model, and allows setting better limits on minor components. Another source of model dependence comes from the choice of particular parameterisations of intermediate decay modes in the signal model (e.g., resonance lineshapes and phase conventions). The fact that different collaborations often use different parameterisations can lead to difficulties in comparing their results. In some cases a direct comparison of such results can be less meaningful; they are less useful for the community, and averaging them becomes non trivial. Besides the benefit of grouping the expertise of the different collaborations, the coordination of signal models, which is a sine qua non for a joint fit, is therefore beneficial. These advantages of joint fits are not explicitly illustrated in this work.
To exemplify direct advantages of joint fitting, we use the result of the BABAR Dalitz-plot analysis of decays . This analysis provided -averaged branching fractions and direct asymmetries for intermediate resonant and non-resonant contributions. It reported evidence for direct violation in the decay , with a -violation parameter , where the first quoted uncertainty is statistical, the second is systematic, and the third is the model uncertainty mentioned above. The Belle collaboration also reported evidence of direct violation in the same decay mode  with a similar significance. In such a situation, being able to obtain a combined result is strongly motivated.
In the BABAR analysis, the contributions of the different intermediate states in the decay were obtained from a maximum-likelihood fit of the distribution of events in the Dalitz plot formed from the two variables and . As in many other Dalitz-plot analyses, the total signal amplitudes and for and decays, respectively, were given in the isobar formalism, by
where is a given intermediate decay mode. The distributions are the lineshapes (e.g., Breit–Wigner functions) describing the dynamics of the decay amplitudes, and the complex coefficients and contain all the weak-phase dependence and are measured relative to one of the contributing channels. They were parameterised as
where and are -violating parameters.
We generate signal-only datasets from the results of this analysis. The sample size is Poisson-distributed with an expected value of , which is the signal yield obtained in the fit to the BABAR data . We then consider each of the possible pairwise combinations of these samples as datasets from two different experiments. For the purpose of this example we focus on one of the parameters of interest of the BABAR analysis: the violating parameter of the contribution, . The value used to generate events is that measured by BABAR, namely . After fitting each of the individual samples with the model used for event generation, we obtain combined results for by three different methods:
a naïve average of the individual results for , taking into account the parabolic uncertainties of the fits to the individual samples;
a naïve average, taking into account the asymmetric uncertainties of the individual fits
4, following the prescription from Ref.  (denoted );
a joint fit to the two samples in the Jfit framework, using the full likelihood function (denoted ).
The results obtained from methods 1 and 2 above are found to be equivalent: in the present case, with a very few exceptions, the effect of the asymmetric nature of the likelihood is negligible comparing to the statistical uncertainty. The results obtained from methods 2 and 3 are compared in Fig. 4, and show a much larger difference. The distribution of the difference between results obtained by the two methods has a full width at half maximum of approximately of the typical statistical uncertainty on in fits to individual datasets (which is ).
We perform likelihood scans as a function of for several individual datasets and their corresponding joint fits, i.e., we fix to several consecutive values, for each of which the fit is repeated. The other parameters are free to vary as in the nominal fit. We compare the sum of one-dimensional log-likelihood functions obtained from scans of two datasets, to the full likelihood scan obtained with the corresponding Jfit-framework fit. One such comparison, which is more extreme than the average case, but not uncommon, is shown in Fig. 5. It illustrates the fact that even if two experiments provide their likelihood dependences on a particular subset of parameters, obtaining a combined result by summing these functions is in general not equivalent to performing a joint fit. Indeed, values of nuisance parameters, for which combined results are not desired, generally differ between the joint fit and the individual fits. Note that in the particular case shown in Fig. 5 the minimum obtained from the joint fit does not lie between the two minima obtained from the individual fits but is located at a more negative value and, in fact, is closer to the generated value of . It also has a smaller uncertainty than the other combination. This indicates that even in well-behaved cases and even if the combination is performed by summing partial likelihood functions, neglecting correlations may result in biases.
To evaluate how often one of the features illustrated in Fig. 5 occurs, the distance of combined results to the generated value of has been studied. For each of the 4950 pairwise combinations of datasets, we compute , and , where is the generated value of . The distances and are then compared. This study shows that results obtained by joint fits are more often closer to the generated value than those obtained by naïve averages due to the fact that they fully account for the correlations between the fit variables. Figure 6 shows versus in the different pairwise combinations and the distribution of the difference between the former and the latter. This example shows that, while both methods can yield unbiased results, joint fits are more often closer to the true value. Moreover, to clarify the presence of the non-Gaussian tails in the distribution of differences, it is overlaid with a Gaussian fitted to its central region ; numbers of positive and negative entries in the distribution, excluding the ranges corresponding to one, two and three standard deviations of the Gaussian are given in Table 3. Comparison of the statistical uncertainties obtained from naïve averages and joint fits are shown in Fig. 7. In of the cases the uncertainty obtained from a joint fit is smaller.
|Excluded||Number of||Number of|
|region ()||positive entries||negative entries|
We stress that the example given here is not extreme: likelihoods are nearly Gaussian and are rather well behaved, as can be seen in Fig. 5. In cases where the likelihood presents strong non-linear features, such as asymmetric functions that cannot be well described by a bifurcated Gaussian, or if it has multiple minima, the difference between naïve averaging and joint fitting could be much larger. In practice, multiple solutions appear in nearly all the Dalitz-plot analyses performed by the factories; they represent one of the major difficulties in these analyses. Clearly, a joint fit allows to resolve better the global minimum from the mirror solutions.
Appendix C Example worker class
In this section we give an example implementation of a worker class, LauRooFitSlave, that is derived from the LauSimFitSlave base class. The particular implementation uses classes from the RooFit framework  to describe the fit model, store the data to be fitted and to evaluate the likelihood function. It is sufficiently general to cover the majority of RooFit-based fitting scenarios and can be quite straightforwardly extended to include those with conditional observables, fitting only subsets of the data, etc. The implementations of the constructor and destructor, each of the eight pure virtual member functions mentioned in Section 3, as well as some additional utility functions, are given with some accompanying explanatory text. For the full documentation and source code please see Ref. .
c.1 Class data members
The data members of the class are as follows:
c.2 Constructor and destructor
The constructor takes as arguments the fit model, a flag to indicate whether or not the fit is an extended fit, the fit variables, and the name of the variable in the data that should be used as an event-by-event weight (if any):
The destructor cleans up any allocated memory:
c.3 Utility functions
The cleanData utility function cleans up the memory associated with the data storage. The convertToLauParmaeter and convertToLauParmaeters functions convert the RooFit versions of the fit parameters (either RooRealVar or RooFormulaVar objects) into LauParameter objects.
c.4 The initialise function
c.5 The verifyFitData function
c.6 The prepareInitialParArray function
c.7 The getTotNegLogLikelihood function
c.8 The setParsFromMinuit function
c.9 The readExperimentData function
c.10 The finaliseExperiment function
- The formalism is discussed here in terms of likelihood, but the benefits of joint fitting also apply when using a minimum chi-square fit.
- A brief review of the maximum-likelihood estimation method is given in Appendix A.
This implementation is inspired by the Root macros:
- The asymmetric uncertainties are obtained from the MINOS routine of the MINUIT package.
- The web page of the RooFit project: http://roofit.sourceforge.net
- J. Back et al., arXiv:1711.09854 [hep-ex], submitted to Comput. Phys. Commun. The web page of the Laura project: http://laura.hepforge.org
- R. Brun and F. Rademakers, Nucl. Instrum. Meth. A 389 (1997) 81. The web page of the Root project: http://root.cern.ch
- F. James and M. Roos, Comput. Phys. Commun. 10 (1975) 343. C++ translation of MINUIT: http://root.cern.ch/root/html/TMinuit.html
- The Doxygen documentation for the LauSimFitMaster class in Laura: http://laura.hepforge.org/doc/doxygen/v3r4/classLauSimFitMaster.html
- The Doxygen documentation for the LauSimFitSlave class in Laura: http://laura.hepforge.org/doc/doxygen/v3r4/classLauSimFitSlave.html
- R. Aaij et al. (LHCb Collaboration), Phys. Rev. D 91, 092002 (2015).
- R. Aaij et al. (LHCb Collaboration), Phys. Rev. D 93, 112018 (2016), Erratum: Phys. Rev. D 94, 079902 (2016).
- C. Patrignani et al. (Particle Data Group), Chin. Phys. C 40, 100001 (2016).
- M.J. Oreglia, Ph.D Thesis, SLAC-236(1980), Appendix D; J.E. Gaiser, Ph.D Thesis, SLAC-255(1982), Appendix F; T. Skwarnicki, Ph.D Thesis, DESY F31-86-02(1986), Appendix E.
- G. Aad et al. (ATLAS Collaboration), Phys. Lett. B 716, 1 (2012).
- S. Chatrchyan et al. (CMS Collaboration), Phys. Lett. B 716, 30 (2012).
- Ed. A.J. Bevan, B. Golob, Th. Mannel, S. Prell, and B.D. Yabsley, Eur. Phys. J. C 74, 3026 (2014).
- R. Aaij et al. (LHCb Collaboration), Phys. Rev. D 87, 072004 (2013).
- R. Aaij et al. (LHCb Collaboration), Phys. Rev. D 90, 072003 (2014).
- R. Aaij et al. (LHCb Collaboration), arXiv:1712.09320 [hep-ex], submitted to Phys. Rev. Lett.
- B. Aubert et al. (BABAR Collaboration), Phys. Rev. D 78, 012004 (2008).
- A. Garmash et al. (Belle Collaboration), Phys. Rev. Lett. 96, 251803 (2006).
- The Doxygen documentation for the LauRooFitSlave class in Laura: http://laura.hepforge.org/doc/doxygen/v3r4/classLauRooFitSlave.html