1HISTTOWORKSPACE(1) General Commands Manual HISTTOWORKSPACE(1)
2
6 hist2workspace - utility to create RooFit/RooStats workspace from his‐
7 tograms
8
10 hist2workspace [option] input.xml
11
13 hist2workspace is a utility to create RooFit/RooStats workspace from
14 histograms
15
17 -standard_form default model, which creates an extended PDF that inter‐
18 polates between RooHistFuncs. This is much faster for models with many
19 bins and uses significantly less memory.
20 -number_counting_form this was the original model in 5.28 (without
21 patches). It uses a Poisson for each bin of the histogram. This can
22 become slow and memory intensive when there are many bins.
23
25 The ROOT release ships with a script prepareHistFactory in the $ROOT‐
26 SYS/bin directory that prepares a working area. It creates a results/,
27 data/, and config/ directory. It also copies the HistFactorySchema.dtd
28 and example XML files into the config/ directory. Additionally, it
29 copies a root file into the data/ directory for use with the examples.
30
32 This file is located in $ROOTSYS/etc/ specifies the XML schema. It is
33 typically placed in the config/ directory of a working area together
34 with the top-level XML file and the individual channel XML files. The
35 user should not modify this file.
36 The HistFactorySchema.dtd is commented to specify exactly the meaning
37 of the various options.
38
42 (see for example $ROOTSYS/tutorials/histfactory/example.xml) This file
43 is edited by the user. It specifies
44 - A top level 'Combination' that is composed of:
45 - several 'Channels', which are described in separate XML files.
46 - several 'Measurements' (corresponding to a full fit of the model)
47 each of which specifies
48 - a name for this measurement to be used in tables and files
49 - what is the luminosity associated to the measurement in pico‐
50 barns
51 - which bins of the histogram should be used
52 - what is the relative uncertainty on the luminosity
53 - what is (are) the parameter(s) of interest that will be mea‐
54 sured
55 - which parameters should be fixed/floating (eg. nuisance parame‐
56 ters)
57 - which type of constraints are desired
58 - Gaussian by default
59 - Gamma, LogNormal, and Uniform are also supported
60 - if the tool should export the model only and skip the default
61 fit
62
65 (see for example $ROOTSYS/tutorials/histfactory/example_channel.xml)
66 This file is edited by the user. It specifies for each channel
67 - observed data
68 - if absent the tool will use the expectation, which is useful for
69 expected sensitivity
70 - several 'Samples' (eg. signal, bkg1, bkg2, ...), each of which has:
71 - a name
72 - if the sample is normalized by theory (eg N = L*sigma) or not (eg.
73 data driven)
74 - a nominal expectation histogram
75 - a named 'Normalization Factor' (which can be fixed or allowed to
76 float in a fit)
77 - several 'Overall Systematics' in normalization with:
78 - a name
79 - +/- 1 sigma variations (eg. 1.05 and 0.95 for a 5% uncertainty)
80 - several 'Histogram Systematics' in shape with:
81 - a name (which can be shared with the OverallSyst if correlated)
82 - +/- 1 sigma variational histograms
83
85 Kyle Cranmer , Akira Shibata , and Dominique Tardif
86
88 This library is free software; you can redistribute it and/or modify it
89 under the terms of the GNU Lesser General Public License as published
90 by the Free Software Foundation; either version 2.1 of the License, or
91 (at your option) any later version.
92 This library is distributed in the hope that it will be useful, but
94 WITHOUT ANY WARRANTY; without even the implied warranty of MER‐
95 CHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser
96 General Public License for more details.
97 You should have received a copy of the GNU Lesser General Public
99 License along with this library; if not, write to the Free Software
100 Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301
101 USA
102 DEC. 2010 HISTTOWORKSPACE(1)