Logo ROOT  
Reference Guide
No Matches
Go to the documentation of this file.
2 * Project: RooFit
3 * Author:
4 * Will Buttinger, RAL 2022
5 *
6 * Copyright (c) 2022, CERN
7 *
8 * Redistribution and use in source and binary forms,
9 * with or without modification, are permitted according to the terms
10 * listed in LICENSE (http://roofit.sourceforge.net/license.txt)
11 */
13/** \class ROOT::Experimental::RooBrowser
14\ingroup RooFit
16 \image html RooBrowser.png width=50%
18To get started with the RooBrowser, open any ROOT file containing a workspace
19 and then create an instance of the `ROOT::Experimental::RooBrowser` just like
20 creating an instance of a `TBrowser`. A window will be displayed with a navigable
21 tree structure on the left that lets you explore the content of the workspaces
22 present in the loaded file. Note that additional files, <b>including json workspace files</b>,
23 can be loaded through the `Browser --> Open` menu in the top left corner.
25The context menu for each node (access by right clicking on the node) in the tree structure can be used to get more
26information about the node. In particular, the `Draw` command can be selected on many of the nodes that are part of a
27statistical model, which will visualize that part of the model in the browser window. A number of options are available
28for the `Draw` command, including (some options can be combined):
30 - "e" : calculate and visualize propagated model uncertainty
31 - "auxratio" : Draw a ratio auxiliary plot below the main plot
32 - "auxsignif" : Draw a significance auxiliary plot below the main plot
33 - "pull" : show panel of current parameter values, which can be dragged in order to change the values and visualize the
34effect on the model (very experimental feature).
36 Once a node has been drawn, the styling of subsequent draws can be controlled through `TStyle` objects
37 that will now appear in the `objects` folder in the workspace.
39A model can be fit to a dataset from the workspace using the `fitTo` context menu command and specifying
40 the name of a dataset in the workspace (if no name is given, an expected dataset corresponding to the
41 current state of the model will be used). A dialog will display the fit result status code when the
42 fit completes and then a `fits` folder will be found under the workspace (the workspace may need to
43 be collapsed and re-expanded to make it appear) where the fit result can be found, selected, and visualized.
44 In multi-channel models the channels that are included in the fit can be controlled with the checkboxes
45 in the browser. Clicking the checkbox will cycle through three states: checked, unchecked with
46 grey-underline, and checked with grey-underline. The grey-underline indicates that channel wont be
47 included in the fit (and will appear greyed out when the model is visualized)
49Many more features are available in the `RooBrowser`, and further documentation and development can be found at
50 the <a href="https://gitlab.cern.ch/will/xroofit">xRooFit</a> repository, which is the library where the browser has
51 been originally developed. The author (Will Buttinger) is also very happy to be contacted with questions or
52 feedback about this new functionality.
54 */
56#ifndef RooFit_RooBrowser_h
57#define RooFit_RooBrowser_h
61namespace ROOT::Experimental {
62using RooBrowser = XROOFIT_NAMESPACE::xRooBrowser;
RooFit::Detail::XRooFit ::xRooBrowser RooBrowser
Definition RooBrowser.h:62