HistMan Class Reference

manage histograms. More...

#include <HistMan.h>

List of all members.

Public Member Functions
	HistMan (const char *base_directory="")
	HistMan (TFile &file, bool attach=true)
	HistMan (TFolder *folder, bool own=true)
	HistMan (const char **file_list, const char **hist_list)
	~HistMan ()
	Destructor deletes folder if owned.
TFolder &	BaseFolder ()
	Get the base HistMan. It will will create if not yet existing.
void	RegisterWithRoot ()
void	WriteOut (TFile &opened_file)
	Write hierachy of histograms to given TFile.
void	WriteOut (const char *filename)
	Write out hierachy to recreated file of given name.
TObject *	Adopt (const char *path, TObject *hist)
template<class THType>
THType *	Get (const char *pathname)
TObject *	GetObject (const char *pathname)
	Get the object at the given path.
template<class THType>
THType *	Book (const char *name, const char *title, int nbinsx, Axis_t xmin, Axis_t xmax, const char *path=".", Bool_t sumw2=kFALSE)
	A simplified histogram API is exported with the methods below.
template<class THType>
THType *	Book (const char *name, const char *title, int nbinsx, Axis_t xmin, Axis_t xmax, int nbinsy, Axis_t ymin, Axis_t ymax, const char *path=".", Bool_t sumw2=kFALSE)
bool	Fill1d (const char *pathname, Axis_t x, Stat_t w=1.0)
bool	Fill2d (const char *pathname, Axis_t x, Axis_t y, Stat_t w=1.0)
bool	FillProfile (const char *pathname, Axis_t x, Axis_t y, Stat_t w=1.0)
Private Attributes
TFolder *	fFolder
bool	fOwn

---

Detailed Description

manage histograms.

HistMan is a class that simplifies working with histograms. It provides a simple HBOOK like interface to booking and filling histograms. It also handles organizing them in a hierarchy based on named paths very much like the Unix filesystem. Finally it handles file I/O in a way that preserves this organization.

While in memory, the hierarchy is maintained with TFolders and on disk in TDirectories. The hierarchy can either be owned by the HistMan instance, and thus have the same persistency as the instance itself or it can be owned by ROOT. This latter case is the most useful one as it lets one create and destroy HistMan instance at will while the hierarchy is built up.

Regardless of the memory management, a HistMan instance is logically rooted at some point of the hierarchy. That is, any instance can only know about histograms and sub hierarchies that are on the branch on which the instance sits.

Definition at line 38 of file HistMan/HistMan.h.

---

Constructor & Destructor Documentation

HistMan::HistMan (  const char *  base_directory = ""  )

Create a HistMan with a TFolder created in the given base directory. This implies that ownership is given to gROOT's memory. Histograms will be visible in "//root/ROOT memory/HistMan/base_directory/" This is the most typical way to use HistMan. Definition at line 71 of file HistMan/HistMan.cxx. References BaseFolder(), fFolder, fOwn, and mkdir_p(). { fFolder = &this->BaseFolder(); fFolder = &mkdir_p(*fFolder,base_directory); fOwn = false; fFolder->SetOwner(true); }

HistMan::HistMan (  TFile &  file, bool  attach = true )

Create a Histman and try to attach the "HistMan" directory in the given file (such as would exist if the file was created by HistMan::WriteOut()). If fail, will act like Histman("") above. If successfull, the file is still used to store the histograms so must be kept open while they are to be used. If attach is false, the hierarchy is not attached to ROOT Memory. Definition at line 111 of file HistMan/HistMan.cxx. References BaseFolder(), directory_to_folder(), fFolder, fOwn, and mkdir_p(). { TDirectory* dir = dynamic_cast<TDirectory*>(file.Get("HistMan")); if (!dir) { cerr << "Failed to find HistMan folder in " << file.GetName() << endl; fFolder = &this->BaseFolder(); fFolder = &mkdir_p(*fFolder,""); fOwn = false; fFolder->SetOwner(true); return; } fFolder = directory_to_folder(*dir); if (attach) { fOwn = false; gROOT->Add(fFolder); } }

HistMan::HistMan (  TFolder *  folder, bool  own = true )

Create a HistMan. If "own" is true the folder is deleted along with this object. This will root the hierarchy in a uniquely named root folder (like HistFolderXXX). Definition at line 60 of file HistMan/HistMan.cxx. References fFolder, Form(), and histcount. : fFolder(folder) , fOwn(own) { if (!fFolder) { fFolder = new TFolder(Form("HistFolder%d",histcount), Form("Histogram Folder #%d",histcount)); } fFolder->SetOwner(true); }

HistMan::HistMan (  const char **  file_list, const char **  hist_list )

Create a HistMan and add a list of histograms from a list of files that have a "HistMan" directory. If the file does not exist, it will print out a warning and ignore this file. If the histogram does not exist in the file, it will do the same. Both the list of files and histograms should end with a 0, e.g. const char* file_list[] = {"file1","file2",0}; Definition at line 130 of file HistMan/HistMan.cxx. References Adopt(), BaseFolder(), fFolder, fOwn, Get(), gSystem(), and mkdir_p(). { fFolder = &this->BaseFolder(); fFolder = &mkdir_p(*fFolder,""); fOwn = false; fFolder->SetOwner(true); // for (int ifile=0; file_list[ifile]; ++ifile){ // check first if there the file exists, if not, print out a // warning message and continue with the other files if (gSystem->AccessPathName(file_list[ifile])) { cout << "HistMan: Warning: file " << file_list[ifile] << " does not exist!" << endl; continue; } TFile file(file_list[ifile]); if (!file.IsOpen()) { cout << "HistMan: Warning: problems opening file " << file_list[ifile] << endl; continue; } HistMan hm(file,false); for (int ihist=0; hist_list[ihist]; ++ihist){ // Get a pointer to the histogram in the old file TH1* hold = hm.Get<TH1>(hist_list[ihist]); if (!hold) { cout << "HistMan: Warning: histogram named " << hist_list[ihist] << " does not exist in file " << file_list[ifile] << endl; continue; } // try to get a pointer to the hitogram in the new // HistMan. If it exists, add the old histogram to it. I // it doesn't, adopt the old histo TH1* hnew = this->Get<TH1>(hist_list[ihist]); if (hnew) hnew->Add(hold); else{ string hname_fullp(hist_list[ihist]); string::size_type pos = hname_fullp.rfind("/"); string hname_path; if (pos < hname_fullp.length()) hname_path = hname_fullp.substr(0,pos); else hname_path = ""; this->Adopt(hname_path.c_str(),dynamic_cast<TH1*>(hold->Clone())); } } file.Close(); } }

HistMan::~HistMan (   )

Destructor deletes folder if owned. Definition at line 184 of file HistMan/HistMan.cxx. References fFolder. { if (fOwn) { //cerr<< "HistMan::~HistMan: Deleting file\n"; delete fFolder; } fFolder = 0; }

---

Member Function Documentation

TObject * HistMan::Adopt (  const char *  path, TObject *  hist )

Adopt an already created histogram (or really any TObject), return NULL (and delete hist) if a histogram with same name as "hist" at path already exists, otherwise return the object. An empty or NULL string can be passed for the path to place the object in HistMan instance's top level folder. Definition at line 261 of file HistMan/HistMan.cxx. References fFolder, and mkdir_p(). Referenced by NueSensitivity::Analysis(), TempModule::BeginJob(), TargetModule::BeginJob(), NpotModule::BeginJob(), LossModule::BeginJob(), HornModule::BeginJob(), HadMuMonModule::BeginJob(), Npot::Book(), TrackRecoPerf::Finish(), ShowerRecoPerf::Finish(), ShowerEnergyPerf::Finish(), HistMan(), TrackRecoPerf::MakeHistos(), ShowerRecoPerf::MakeHistos(), ShowerEnergyPerf::MakeHistos(), ShowerDirectionPerf::MakeHistos(), and THMtest::Test1(). { TH1* hist = dynamic_cast<TH1*>(obj); if (hist) hist->SetDirectory(0); TFolder* folder = &mkdir_p(*fFolder,dirpath); if (folder->FindObject(obj->GetName())) { // FindObject(Object*) not implemented! cerr << "Object: " << dirpath << "/" << obj->GetName() << " already exists\n"; delete obj; return 0; } folder->Add(obj); return obj; }

TFolder & HistMan::BaseFolder (   )

Get the base HistMan. It will will create if not yet existing. Definition at line 193 of file HistMan/HistMan.cxx. Referenced by HistMan(), RegisterWithRoot(), CDFMonitoringModuleImp::Update(), and PlotMan::UpdateCanvases(). { TFolder* folder = dynamic_cast<TFolder*>(gROOT->FindObjectAny("HistMan")); if (folder) return *folder; folder = new TFolder("HistMan","Base Histogram Manager Folder"); gROOT->Add(folder); return *folder; }

template<class THType> THType* HistMan::Book (  const char *  name, const char *  title, int  nbinsx, Axis_t  xmin, Axis_t  xmax, int  nbinsy, Axis_t  ymin, Axis_t  ymax, const char *  path = ".", Bool_t  sumw2 = kFALSE )  [inline]

Book 2D histograms of type THType. Return pointer to created histogram (HistMan retains ownership) or 0 if "path/name" conflicts with previously existing histogram. Definition at line 132 of file HistMan/HistMan.h. { THType* h = new THType(name,title,nbinsx,xmin,xmax, nbinsy,ymin,ymax); if ( sumw2 ) { h->Sumw2(); } TObject* o = Adopt(path, h); return dynamic_cast<THType*>(o); }

template<class THType> THType* HistMan::Book (  const char *  name, const char *  title, int  nbinsx, Axis_t  xmin, Axis_t  xmax, const char *  path = ".", Bool_t  sumw2 = kFALSE )  [inline]

A simplified histogram API is exported with the methods below. Book 1D histograms of type THType. Return pointer to created histogram (HistMan retains ownership) or 0 if "path/name" conflicts with previously existing histogram. Definition at line 117 of file HistMan/HistMan.h. Referenced by NueReadwPID::Ana(), NueReadTJPID::Ana(), BDCheckDB::BDCheckDB(), BDLivePlot::BDLivePlot(), BDataQualityModule::BeginFile(), UserAnalysis::BeginJob(), NueSensitivity::BeginJob(), CompareMST::BeginJob(), CompareMD::BeginJob(), BDAnaModule::BeginJob(), ProtonDist::Book(), PedStudy::Book(), MaxDaeDt::Book(), DeltaT::Book(), Cuts::Book(), book_and_fill(), book_once(), BDataQualityModule::EndFile(), ProtonDist::Fill(), ShowerEnergyPerf::Finish(), Pedestals::GeneratePeds(), FitGC::GetSiglin(), TrackRecoPerf::MakeHistos(), ShowerVertexPerf::MakeHistos(), ShowerRecoPerf::MakeHistos(), ShowerEnergyPerf::MakeHistos(), ShowerDirectionPerf::MakeHistos(), PedStudy::OneFile(), FitGC::OpenFile(), pedmaker(), FitGC::PlotPL(), StndBmsSpin::Scan(), STND_BMS::Scan(), BMS_STND::Scan(), THMtest::Test1(), and THMtest::Test2(). { THType* h = new THType(name,title,nbinsx,xmin,xmax); if ( sumw2 ) { h->Sumw2(); } TObject* o = Adopt(path, h); return dynamic_cast<THType*>(o); }

bool HistMan::Fill1d (  const char *  pathname, Axis_t  x, Stat_t  w = 1.0 )

Lookup a 1D histogram by pathname="path/name" and Fill() it. If lookup or any casting fails, false is returned and an error message is printed at Msg level Warning. Definition at line 276 of file HistMan/HistMan.cxx. References fFolder. Referenced by NueReadwPID::Ana(), NueReadTJPID::Ana(), CompareMST::Ana(), BDataQualityModule::Ana(), BDAnaModule::Ana(), BDCheckDB::CheckSpill(), FitGC::DoFit(), ProtonDist::Fill(), fill(), MaxDaeDt::Fill(), DeltaT::Fill(), BDataQualityModule::FillFile(), CompareMD::FillFromList(), FitGC::GetSiglin(), horn_off(), THMtest::Test1(), THMtest::Test2(), and tortgt_ok(). { TObject* o = fFolder->FindObject(pathname); if (!o) o = fFolder->FindObjectAny(pathname); TH1* h = dynamic_cast<TH1*>(o); if (!h) { cerr << "Fill1d(\""<<pathname<<"\") failed lookup\n"; return false; } h->Fill(x,w); return true; }

bool HistMan::Fill2d (  const char *  pathname, Axis_t  x, Axis_t  y, Stat_t  w = 1.0 )

Lookup a 2D histogram by pathname="path/name" and Fill() it. If lookup or any casting fails, false is returned and an error message is printed at Msg level Warning. Definition at line 288 of file HistMan/HistMan.cxx. References fFolder. Referenced by NueSensitivity::Ana(), FitGC::DoFit(), ProtonDist::Fill(), and DeltaT::Fill(). { TObject* o = fFolder->FindObject(pathname); if (!o) o = fFolder->FindObjectAny(pathname); TH2* h = dynamic_cast<TH2*>(o); if (!h) { cerr << "Fill2d(\""<<pathname<<"\") failed lookup\n"; return false; } h->Fill(x,y,w); return true; }

bool HistMan::FillProfile (  const char *  pathname, Axis_t  x, Axis_t  y, Stat_t  w = 1.0 )

Lookup a profile histogram by pathname="path/name" and Fill() it. If lookup or any casting fails, false is returned and an error message is printed at Msg level Warning. Definition at line 301 of file HistMan/HistMan.cxx. References fFolder. { TObject* o = fFolder->FindObject(pathname); if (!o) o = fFolder->FindObjectAny(pathname); TProfile* h = dynamic_cast<TProfile*>(o); if (!h) { cerr << "FillProfile(\""<<pathname<<"\") failed lookup\n"; return false; } h->Fill(x,y,w); return true; }

template<class THType> THType* HistMan::Get (  const char *  pathname  )  [inline]

Try to find histogram of with pathname="path/name" in this instances branch of the hierarchy. Path is relative to this objects TFolder. Returns NULL if histogram does not exist or if there is a type mismatch. Definition at line 103 of file HistMan/HistMan.h. Referenced by BDAnaModule::Ana(), NueSensitivity::Analysis(), BDataQualityModule::BeginFile(), FitGC::DoFit(), BDataQualityModule::EndFile(), Npot::Fill(), BDataQualityModule::FillFile(), ValVtxModule::FillPlots(), folder_to_directory(), Pedestals::GeneratePeds(), FitGC::GetSiglin(), HistMan(), DevCount::Init(), TorCheck::Init(), DbCheck::Init(), PerTime::Init(), Earliest::Init(), make_prints(), FitGC::OpenFile(), pedmaker(), FitGC::PlotPL(), THMtest::Test1(), THMtest::Test1_1(), THMtest::Test2(), THMtest::Test3(), and FitGC::WriteDB(). { return dynamic_cast<THType*>(this->GetObject(pathname)); }

TObject * HistMan::GetObject (  const char *  pathname  )

Get the object at the given path. Definition at line 315 of file HistMan/HistMan.cxx. References parse_path(). Referenced by TargetModule::Fill(), and LossModule::Fill(). { //cerr << "Getting object at " << pathname << endl; if (!fFolder) return 0; vector<string> path = parse_path(pathname); TFolder* folder = fFolder; for (size_t ind=0; ind < path.size(); ++ind) { //cerr << "Checking " << path[ind] << endl; TObject* o = folder->FindObject(path[ind].c_str()); TFolder* f = dynamic_cast<TFolder*>(o); if (!f) return o; folder = f; } return 0; }

void HistMan::RegisterWithRoot (   )

Register the base folder with gROOT, gives up ownership and folder becomes visible in //root/ROOT Memory/HistMan in a TBrowser. This is only needed if the instance is created with HistMan(TFolder*,bool). Definition at line 202 of file HistMan/HistMan.cxx. References base, BaseFolder(), fFolder, and fOwn. { if (!fOwn) return; fOwn = false; TFolder& base = this->BaseFolder(); base.Add(fFolder); }

void HistMan::WriteOut (  const char *  filename  )

Write out hierachy to recreated file of given name. Definition at line 253 of file HistMan/HistMan.cxx. References WriteOut(). { TFile f(filename,"recreate"); this->WriteOut(f); f.Close(); }

void HistMan::WriteOut (  TFile &  opened_file  )

Write hierachy of histograms to given TFile. Definition at line 248 of file HistMan/HistMan.cxx. References fFolder, and folder_to_directory(). Referenced by BDLivePlot::BDLivePlot(), HistManModule::EndFile(), ValVtxModule::EndJob(), NueSensitivity::EndJob(), HistManModule::EndJob(), CompareAll::EndJob(), BDAnaModule::EndJob(), pedmaker(), StndBmsSpin::Scan(), STND_BMS::Scan(), BMS_STND::Scan(), THMtest::Test2(), write_plots(), FitGC::writehm(), PlotterManager::WriteOut(), PlotMan::WriteOut(), PedStudy::WriteOut(), WriteOut(), and BDCheckDB::~BDCheckDB(). { if (!fFolder) return; folder_to_directory(fFolder,file); }

---

Member Data Documentation

TFolder* HistMan::fFolder [private]

Definition at line 39 of file HistMan/HistMan.h. Referenced by Adopt(), Fill1d(), Fill2d(), FillProfile(), HistMan(), RegisterWithRoot(), WriteOut(), and ~HistMan().

bool HistMan::fOwn [private]

Definition at line 40 of file HistMan/HistMan.h. Referenced by HistMan(), and RegisterWithRoot().

---

The documentation for this class was generated from the following files:

• HistMan/HistMan.h
• HistMan/HistMan.cxx

---