// @(#)root/roostats:$Id: TestStatSampler.h 26805 2009-01-13 17:45:57Z cranmer $
// Author: Kyle Cranmer, Lorenzo Moneta, Gregory Schott, Wouter Verkerke
/*************************************************************************
 * Copyright (C) 1995-2008, Rene Brun and Fons Rademakers.               *
 * All rights reserved.                                                  *
 *                                                                       *
 * For the licensing terms see $ROOTSYS/LICENSE.                         *
 * For the list of contributors see $ROOTSYS/README/CREDITS.             *
 *************************************************************************/

#ifndef ROOSTATS_TestStatSampler
#define ROOSTATS_TestStatSampler

//_________________________________________________
/*
BEGIN_HTML
<p>
TestStatSampler is an interface class for a tools which produce RooStats SamplingDistributions.  
Tools that implement this interface are expected to be used for coverage studies, the Neyman Construction, etc.
</p>
END_HTML
*/
//

#ifndef ROOT_Rtypes
#include "Rtypes.h"
#endif

class RooAbsArg; 

namespace RooStats {

   class SamplingDistribution; 

   class TestStatSampler {

   public:
     //     TestStatSampler();
     virtual ~TestStatSampler() {}
    
      // Main interface to get a ConfInterval, pure virtual
      virtual SamplingDistribution* GetSamplingDistribution(RooArgSet& paramsOfInterest) = 0; 

      // Main interface to evaluate the test statistic on a dataset
      virtual Double_t EvaluateTestStatistic(RooAbsData& data, RooArgSet& paramsOfInterest) = 0;

      // Get the TestStatistic
      virtual const RooAbsArg* GetTestStatistic()  const = 0;  
    
      // Get the Confidence level for the test
      virtual Double_t ConfidenceLevel()  const = 0;  

      // Common Initialization
      virtual void Initialize(RooAbsArg& testStatistic, RooArgSet& paramsOfInterest, RooArgSet& nuisanceParameters) = 0;

      // Set the Pdf, add to the the workspace if not already there
      virtual void SetPdf(RooAbsPdf&) = 0;

      // specify the parameters of interest in the interval
      virtual void SetParameters(RooArgSet&) = 0;
      // specify the nuisance parameters (eg. the rest of the parameters)
      virtual void SetNuisanceParameters(RooArgSet&) = 0;
      // specify the observables in the dataset (needed to evaluate the test statistic)
      virtual void SetObservables(RooArgSet& ) = 0;

      // set the size of the test (rate of Type I error) ( Eg. 0.05 for a 95% Confidence Interval)
      virtual void SetTestSize(Double_t size) = 0;
      // set the confidence level for the interval (eg. 0.95 for a 95% Confidence Interval)
      virtual void SetConfidenceLevel(Double_t cl) = 0;

      // Set the TestStatistic (want the argument to be a function of the data & parameter points
      virtual void SetTestStatistic(RooAbsArg&)  const = 0;  
      

   protected:
      ClassDef(TestStatSampler,1)   // Interface for tools setting limits (producing confidence intervals)
   };
}


#endif