roo2h : a ROOT to HBOOK converter

Why roo2h ?
All the story begins with our GEANT simulation package, Kane Kane knows nothing about ROOT. Output of Kane is a HBOOK Ntuple. This Ntuple is read by a ROOT program (Rosebud) to give ROOT Trees and then the Trees are analyzed to give histograms. These histograms, in turn, give us valuable information on what should be the input of Kane. But Kane needs HBOOK histograms.

So we wrote a little program to go from ROOT histograms to HBOOK histograms
What roo2h can do
roo2h can convert TH1F, TH2F, TProfile to 1D,2D and Profile HBOOK histograms.
What roo2h cannot do
roo2h cannot convert (yet) ROOT ntuples to HBOOK ones.
Convention
ROOT histograms have names, HBOOK ones have identifiers.

To go from names to id, we chose the following scheme :
  • if ROOT histogram name has a numeric part, take it as id
  • otherwise ASK the user to give an id
In both cases, the same id cannot be used twice, of course (this is checked, in the limit of NHISTOMAX (=1000000 by default) which can only be changed at compilation time).
Usage
roo2h file.root file.hbook
Installing roo2h
  • To compile roo2h source, you'll need to have a working installation of both ROOT and the CERNLIB.
  • If your system has the GNU autotools (autoconf, automake, libtool) installed, then use those three files :
    and type : ./autogen.sh --prefix=where_to_install
    make install
  • If not, well, you are on your own...
Disclaimer
The author make no claims about the suitability of this software for any purpose. It is provided "as is" without express or implied warranty.
Comments ?
Your comments are welcome, but please consider that I'm no longer working in the TAPS collaboration, nor do I use HBOOK at all ! So, there's no warranty of support !
Contact person: L. Aphecetche (WWW)
Last modified: Thu Dec 5 12:12:22 CET 2002
Links
Visit also our TAPS and GPS sites !