Namespace for the RooStats classes. More...

Namespaces
namespace	HistFactory

namespace	NumberCountingUtils

Classes
class	AcceptanceRegion

class	AsymptoticCalculator
	Hypothesis Test Calculator based on the asymptotic formulae for the profile likelihood ratio. More...

class	BayesianCalculator
	BayesianCalculator is a concrete implementation of IntervalCalculator, providing the computation of a credible interval using a Bayesian method. More...

class	BernsteinCorrection
	BernsteinCorrection is a utility in RooStats to augment a nominal PDF with a polynomial correction term. More...

class	BranchStore

class	CombinedCalculator
	CombinedCalculator is an interface class for a tools which can produce both RooStats HypoTestResults and ConfIntervals. More...

class	ConfidenceBelt
	ConfidenceBelt is a concrete implementation of the ConfInterval interface. More...

class	ConfInterval
	ConfInterval is an interface class for a generic interval in the RooStats framework. More...

class	DebuggingSampler

class	DebuggingTestStat

class	DetailedOutputAggregator
	This class is designed to aid in the construction of RooDataSets and RooArgSets, particularly those naturally arising in fitting operations. More...

class	FeldmanCousins
	The FeldmanCousins class (like the Feldman-Cousins technique) is essentially a specific configuration of the more general NeymanConstruction. More...

class	FrequentistCalculator
	Does a frequentist hypothesis test. More...

class	Heaviside
	Represents the Heaviside function. More...

class	HLFactory
	HLFactory is an High Level model Factory allows you to describe your models in a configuration file (datacards) acting as an interface with the RooFactoryWSTool. More...

class	HybridCalculator
	Same purpose as HybridCalculatorOriginal, but different implementation. More...

class	HybridPlot
	This class provides the plots for the result of a study performed with the HybridCalculatorOriginal class. More...

class	HybridResult
	Class encapsulating the result of the HybridCalculatorOriginal. More...

class	HypoTestCalculator
	HypoTestCalculator is an interface class for a tools which produce RooStats HypoTestResults. More...

class	HypoTestCalculatorGeneric
	Common base class for the Hypothesis Test Calculators. More...

class	HypoTestInverter
	A class for performing a hypothesis test inversion by scanning the hypothesis test results of a HypoTestCalculator for various values of the parameter of interest. More...

class	HypoTestInverterPlot
	Class to plot a HypoTestInverterResult, the output of the HypoTestInverter calculator. More...

class	HypoTestInverterResult
	HypoTestInverterResult class holds the array of hypothesis test results and compute a confidence interval. More...

class	HypoTestPlot
	This class provides the plots for the result of a study performed with any of the HypoTestCalculatorGeneric (e.g. More...

class	HypoTestResult
	HypoTestResult is a base class for results from hypothesis tests. More...

class	IntervalCalculator
	IntervalCalculator is an interface class for a tools which produce RooStats ConfIntervals. More...

struct	LikelihoodFunction

class	LikelihoodInterval
	LikelihoodInterval is a concrete implementation of the RooStats::ConfInterval interface. More...

class	LikelihoodIntervalPlot
	This class provides simple and straightforward utilities to plot a LikelihoodInterval object. More...

class	MarkovChain
	Stores the steps in a Markov Chain of points. More...

class	MaxLikelihoodEstimateTestStat
	MaxLikelihoodEstimateTestStat: TestStatistic that returns maximum likelihood estimate of a specified parameter. More...

class	MCMCCalculator
	Bayesian Calculator estimating an interval or a credible region using the Markov-Chain Monte Carlo method to integrate the likelihood function with the prior to obtain the posterior function. More...

class	MCMCInterval
	MCMCInterval is a concrete implementation of the RooStats::ConfInterval interface. More...

class	MCMCIntervalPlot
	This class provides simple and straightforward utilities to plot a MCMCInterval object. More...

class	MetropolisHastings
	This class uses the Metropolis-Hastings algorithm to construct a Markov Chain of data points using Monte Carlo. More...

class	ModelConfig
	ModelConfig is a simple class that holds configuration information specifying how a model should be used in the context of various RooStats tools. More...

class	NeymanConstruction
	NeymanConstruction is a concrete implementation of the NeymanConstruction interface that, as the name suggests, performs a NeymanConstruction. More...

class	NuisanceParametersSampler
	Helper class for ToyMCSampler. More...

class	NumberCountingPdfFactory
	A factory for building PDFs and data for a number counting combination. More...

class	NumEventsTestStat
	NumEventsTestStat is a simple implementation of the TestStatistic interface used for simple number counting. More...

class	PdfProposal
	PdfProposal is a concrete implementation of the ProposalFunction interface. More...

class	PointSetInterval
	PointSetInterval is a concrete implementation of the ConfInterval interface. More...

class	PosteriorCdfFunction

class	PosteriorFunction

class	PosteriorFunctionFromToyMC
	Posterior function obtaining sampling toy MC for the nuisance according to their pdf. More...

class	ProfileInspector
	Utility class to plot conditional MLE of nuisance parameters vs. More...

class	ProfileLikelihoodCalculator
	The ProfileLikelihoodCalculator is a concrete implementation of CombinedCalculator (the interface class for tools which can produce both a RooStats HypoTestResult and ConfInterval). More...

class	ProfileLikelihoodTestStat
	ProfileLikelihoodTestStat is an implementation of the TestStatistic interface that calculates the profile likelihood ratio at a particular parameter point given a dataset. More...

class	ProposalFunction
	ProposalFunction is an interface for all proposal functions that would be used with a Markov Chain Monte Carlo algorithm. More...

class	ProposalHelper

class	RatioOfProfiledLikelihoodsTestStat
	TestStatistic that returns the ratio of profiled likelihoods. More...

struct	RooStatsConfig

class	SamplingDistPlot
	This class provides simple and straightforward utilities to plot SamplingDistribution objects. More...

class	SamplingDistribution
	This class simply holds a sampling distribution of some test statistic. More...

class	SamplingSummary

class	SamplingSummaryLookup

class	SequentialProposal
	Class implementing a proposal function that samples the parameter space by moving only in one coordinate (chosen randomly) at each step. More...

class	SimpleInterval
	SimpleInterval is a concrete implementation of the ConfInterval interface. More...

class	SimpleLikelihoodRatioTestStat
	TestStatistic class that returns -log(L[null] / L[alt]) where L is the likelihood. More...

class	SPlot
	A class to calculate "sWeights" used to create an "sPlot". More...

class	TestStatistic
	TestStatistic is an interface class to provide a facility for construction test statistics distributions to the NeymanConstruction class. More...

class	TestStatSampler
	TestStatSampler is an interface class for a tools which produce RooStats SamplingDistributions. More...

class	ToyMCImportanceSampler
	ToyMCImportanceSampler is an extension of the ToyMCSampler for Importance Sampling. More...

class	ToyMCSampler
	ToyMCSampler is an implementation of the TestStatSampler interface. More...

class	UniformProposal
	UniformProposal is a concrete implementation of the ProposalFunction interface for use with a Markov Chain Monte Carlo algorithm. More...

class	UpperLimitMCSModule
	This class allow to compute in the ToyMcStudy framework the ProfileLikelihood upper limit for each toy-MC sample generated. More...

Enumerations
enum	toysStrategies { EQUALTOYSPERDENSITY , EXPONENTIALTOYDISTRIBUTION }

Functions
double	AsimovSignificance (double s, double b, double sigma_b=0.0)
	Compute the Asimov Median significance for a Poisson process with s = expected number of signal events, b = expected number of background events and optionally sigma_b = expected uncertainty of background events.

BranchStore *	CreateBranchStore (const RooDataSet &data)

void	FactorizePdf (const RooArgSet &observables, RooAbsPdf &pdf, RooArgList &obsTerms, RooArgList &constraints)

void	FactorizePdf (RooStats::ModelConfig &model, RooAbsPdf &pdf, RooArgList &obsTerms, RooArgList &constraints)

void	FillTree (TTree &myTree, const RooDataSet &data)

TTree *	GetAsTTree (TString name, TString desc, const RooDataSet &data)
	Create a TTree with the given name and description. All RooRealVars in the RooDataSet are represented as branches that contain values of type double.

RooStatsConfig &	GetGlobalRooStatsConfig ()
	Retrieve the config object which can be used to set flags for things like offsetting the likelihood or using the error wall for the minimiser.

bool	IsNLLOffset ()
	Function returning if the flag to check if the flag to use NLLOffset is set.

RooAbsPdf *	MakeNuisancePdf (const RooStats::ModelConfig &model, const char *name)

RooAbsPdf *	MakeNuisancePdf (RooAbsPdf &pdf, const RooArgSet &observables, const char *name)
	extract constraint terms from pdf

RooWorkspace *	MakeReducedWorkspace (RooWorkspace oldWS, const char newName, bool copySnapshots, const char mcname, const char newmcname, bool copyData=true)
	function that clones a workspace, copying all needed components and discarding all others

RooAbsPdf *	MakeUnconstrainedPdf (const RooStats::ModelConfig &model, const char *name=nullptr)

RooAbsPdf *	MakeUnconstrainedPdf (RooAbsPdf &pdf, const RooArgSet &observables, const char *name=nullptr)
	remove constraints from pdf and return the unconstrained pdf

std::string const &	NLLOffsetMode ()
	Test what offsetting mode RooStats should use by default.

void	PrintListContent (const RooArgList &l, std::ostream &os=std::cout)
	useful function to print in one line the content of a set with their values

double	PValueToSignificance (double pvalue)
	returns one-sided significance corresponding to a p-value

RooStats::HLFactory TNamed	R__DEPRECATED (6, 38, "Outdated higher-level interface around RooWorkspace. Use RooWorkspace directly.")

void	RandomizeCollection (RooAbsCollection &set, bool randomizeConstants=true)
	assuming all values in set are RooRealVars, randomize their values

void	RemoveConstantParameters (RooArgList &set)

void	RemoveConstantParameters (RooArgSet *set)

bool	SetAllConstant (const RooAbsCollection &coll, bool constant=true)
	utility function to set all variable constant in a collection (from G.

void	SetNLLOffsetMode (std::string const &mode)
	Function to set a global flag in RooStats to use NLL offset when performing nll computations.

void	SetParameters (const RooArgSet desiredVals, RooArgSet paramsToChange)

double	SignificanceToPValue (double Z)
	returns p-value corresponding to a 1-sided significance

RooAbsPdf *	StripConstraints (RooAbsPdf &pdf, const RooArgSet &observables)

void	UseNLLOffset (bool on)
	Use an offset in NLL calculations.

Variables
const ROOT::Math::RootFinder::EType	kRootFinderType = ROOT::Math::RootFinder::kBRENT

Detailed Description

Namespace for the RooStats classes.

All the classes of the RooStats package are in the RooStats namespace. In addition the namespace contain a set of utility functions.

Enumeration Type Documentation

◆ toysStrategies

enum RooStats::toysStrategies

Enumerator
EQUALTOYSPERDENSITY
EXPONENTIALTOYDISTRIBUTION

Definition at line 20 of file ToyMCImportanceSampler.h.

Function Documentation

◆ AsimovSignificance()

double RooStats::AsimovSignificance	(	double	s,
		double	b,
		double	sigma_b = 0.0 )

Compute the Asimov Median significance for a Poisson process with s = expected number of signal events, b = expected number of background events and optionally sigma_b = expected uncertainty of background events.

Definition at line 59 of file RooStatsUtils.cxx.

◆ CreateBranchStore()

BranchStore * RooStats::CreateBranchStore ( const RooDataSet & data )

Definition at line 267 of file RooStatsUtils.cxx.

◆ FactorizePdf() [1/2]

void RooStats::FactorizePdf	(	const RooArgSet &	observables,
		RooAbsPdf &	pdf,
		RooArgList &	obsTerms,
		RooArgList &	constraints )

Definition at line 81 of file RooStatsUtils.cxx.

◆ FactorizePdf() [2/2]

void RooStats::FactorizePdf	(	RooStats::ModelConfig &	model,
		RooAbsPdf &	pdf,
		RooArgList &	obsTerms,
		RooArgList &	constraints )

Definition at line 114 of file RooStatsUtils.cxx.

◆ FillTree()

void RooStats::FillTree	(	TTree &	myTree,
		const RooDataSet &	data )

Definition at line 287 of file RooStatsUtils.cxx.

◆ GetAsTTree()

TTree * RooStats::GetAsTTree	(	TString	name,
		TString	desc,
		const RooDataSet &	data )

Create a TTree with the given name and description. All RooRealVars in the RooDataSet are represented as branches that contain values of type double.

Definition at line 311 of file RooStatsUtils.cxx.

◆ GetGlobalRooStatsConfig()

RooStatsConfig & RooStats::GetGlobalRooStatsConfig ( )

Retrieve the config object which can be used to set flags for things like offsetting the likelihood or using the error wall for the minimiser.

Definition at line 54 of file RooStatsUtils.cxx.

◆ IsNLLOffset()

bool RooStats::IsNLLOffset ( )

inline

Function returning if the flag to check if the flag to use NLLOffset is set.

Deprecated: Use NLLOffsetMode().

Definition at line 143 of file RooStatsUtils.h.

◆ MakeNuisancePdf() [1/2]

RooAbsPdf * RooStats::MakeNuisancePdf	(	const RooStats::ModelConfig &	model,
		const char *	name )

Definition at line 137 of file RooStatsUtils.cxx.

◆ MakeNuisancePdf() [2/2]

RooAbsPdf * RooStats::MakeNuisancePdf	(	RooAbsPdf &	pdf,
		const RooArgSet &	observables,
		const char *	name )

extract constraint terms from pdf

Definition at line 125 of file RooStatsUtils.cxx.

◆ MakeReducedWorkspace()

RooWorkspace * RooStats::MakeReducedWorkspace	(	RooWorkspace *	oldWS,
		const char *	newName,
		bool	copySnapshots,
		const char *	mcname,
		const char *	newmcname,
		bool	copyData = true )

function that clones a workspace, copying all needed components and discarding all others

Definition at line 337 of file RooStatsUtils.cxx.

◆ MakeUnconstrainedPdf() [1/2]

RooAbsPdf * RooStats::MakeUnconstrainedPdf	(	const RooStats::ModelConfig &	model,
		const char *	name = nullptr )

Definition at line 221 of file RooStatsUtils.cxx.

◆ MakeUnconstrainedPdf() [2/2]

RooAbsPdf * RooStats::MakeUnconstrainedPdf	(	RooAbsPdf &	pdf,
		const RooArgSet &	observables,
		const char *	name = nullptr )

remove constraints from pdf and return the unconstrained pdf

Definition at line 210 of file RooStatsUtils.cxx.

◆ NLLOffsetMode()

std::string const & RooStats::NLLOffsetMode ( )

inline

Test what offsetting mode RooStats should use by default.

Definition at line 155 of file RooStatsUtils.h.

◆ PrintListContent()

void RooStats::PrintListContent	(	const RooArgList &	l,
		std::ostream &	os = std::cout )

useful function to print in one line the content of a set with their values

Definition at line 319 of file RooStatsUtils.cxx.

◆ PValueToSignificance()

double RooStats::PValueToSignificance ( double pvalue )

inline

returns one-sided significance corresponding to a p-value

Definition at line 49 of file RooStatsUtils.h.

◆ R__DEPRECATED()

RooStats::HLFactory TNamed RooStats::R__DEPRECATED	(	6	,
		38	,
		"Outdated higher-level interface around RooWorkspace. Use RooWorkspace directly."	)

◆ RandomizeCollection()

void RooStats::RandomizeCollection	(	RooAbsCollection &	set,
		bool	randomizeConstants = true )

inline

assuming all values in set are RooRealVars, randomize their values

Definition at line 98 of file RooStatsUtils.h.

◆ RemoveConstantParameters() [1/2]

void RooStats::RemoveConstantParameters ( RooArgList & set )

inline

Definition at line 75 of file RooStatsUtils.h.

◆ RemoveConstantParameters() [2/2]

void RooStats::RemoveConstantParameters ( RooArgSet * set )

inline

Definition at line 67 of file RooStatsUtils.h.

◆ SetAllConstant()

bool RooStats::SetAllConstant	(	const RooAbsCollection &	coll,
		bool	constant = true )

inline

utility function to set all variable constant in a collection (from G.

Petrucciani)

Definition at line 85 of file RooStatsUtils.h.

◆ SetNLLOffsetMode()

void RooStats::SetNLLOffsetMode ( std::string const & mode )

inline

Function to set a global flag in RooStats to use NLL offset when performing nll computations.

Note: Not all RooStats tools implement this capabilities.

Definition at line 150 of file RooStatsUtils.h.

◆ SetParameters()

void RooStats::SetParameters	(	const RooArgSet *	desiredVals,
		RooArgSet *	paramsToChange )

inline

Definition at line 63 of file RooStatsUtils.h.

◆ SignificanceToPValue()

double RooStats::SignificanceToPValue ( double Z )

inline

returns p-value corresponding to a 1-sided significance

Definition at line 54 of file RooStatsUtils.h.

◆ StripConstraints()

RooAbsPdf * RooStats::StripConstraints	(	RooAbsPdf &	pdf,
		const RooArgSet &	observables )

Definition at line 146 of file RooStatsUtils.cxx.

◆ UseNLLOffset()

void RooStats::UseNLLOffset ( bool on )

inline

Use an offset in NLL calculations.

Deprecated: Use SetNLLOffsetMode().

Definition at line 136 of file RooStatsUtils.h.

Variable Documentation

◆ kRootFinderType

const ROOT::Math::RootFinder::EType RooStats::kRootFinderType = ROOT::Math::RootFinder::kBRENT

Definition at line 99 of file BayesianCalculator.cxx.

Namespaces

Classes

Enumerations

Functions

Variables

Detailed Description

Enumeration Type Documentation

◆ toysStrategies

Function Documentation

◆ AsimovSignificance()

◆ CreateBranchStore()

◆ FactorizePdf() [1/2]

◆ FactorizePdf() [2/2]

◆ FillTree()

◆ GetAsTTree()

◆ GetGlobalRooStatsConfig()

◆ IsNLLOffset()

◆ MakeNuisancePdf() [1/2]

◆ MakeNuisancePdf() [2/2]

◆ MakeReducedWorkspace()

◆ MakeUnconstrainedPdf() [1/2]

◆ MakeUnconstrainedPdf() [2/2]

◆ NLLOffsetMode()

◆ PrintListContent()

◆ PValueToSignificance()

◆ R__DEPRECATED()

◆ RandomizeCollection()

◆ RemoveConstantParameters() [1/2]

◆ RemoveConstantParameters() [2/2]

◆ SetAllConstant()

◆ SetNLLOffsetMode()

◆ SetParameters()

◆ SignificanceToPValue()

◆ StripConstraints()

◆ UseNLLOffset()

Variable Documentation

◆ kRootFinderType