trusty (1) h2root.1.gz

Provided by: root-plugin-hist-hbook_5.34.14-1build1_amd64 bug

NAME
       h2root - convert PAW HBOOK files to ROOT files


SYNOPSIS
       h2root file.hbook file.root [compress] [tolower] [lrecl]


DESCRIPTION
       h2root  you  can  use  to convert your HBOOK/PAW histograms or ntuples files into ROOT files. To use this
       program, you type the shell script command:

              h2root hbookfile rootfile

       If you do not specify the second parameter, a file name is automatically generated for you. If  hbookfile
       is of the form file.hbook, then the ROOT file will be called file.root.

       This program converts HBOOK histograms into ROOT objects of the class TH1F.  HBOOK profile histograms are
       converted into ROOT profile histograms (see class TProfile).  HBOOK row-wise and column-wise ntuples  are
       automatically  converted  to  ROOT  Trees(see  TTree).   Some  HBOOK column-wise ntuples may not be fully
       converted in case one of the columns is an array with fix  dimensions  (eg.  `var[6]')  or  is  a  multi-
       dimensional array.

       HBOOK  integer identifiers are converted into ROOT named objects by prefixing the integer identifier with
       the letter `h' if the identifier is a  positive  integer  and  by  `h_'  if  it  is  a  negative  integer
       identifier.

       In  case  of  row-wise or column-wise ntuples, each column is converted to a branch of a Tree.  Note that
       h2root is able to convert HBOOK files containing  several  levels  of  sub-directories.   Once  you  have
       converted your file, you can look at it and draw histograms or process ntuples using the ROOT interactive
       module. You can also use the ROOT browser (see TBrowser) to inspect this file.

       The chapter How to  read  a  Tree  explains  two  ways  to  read  a  Tree.  ROOT  includes  the  function
       TTree::MakeCode to automatically generate the code for a skeleton analysis function. With


OPTIONS
       compress
              = 1 by default (use 0 for no compression)

       tolower
              = 1 by default (use 0 to keep case of column names)

       lrecl  = 0 by default (must be specified if >8092)


SEE ALSO
              root(1), g2root(1)
       and
              The ROOT Users Guide
       available from the main ROOT website:
              http://root.cern.ch

       h2root is documented fully on
              http://root.cern.ch/root/HowtoConvert.html


ORIGINAL AUTHORS
       The ROOT team (see web page above):
              Rene Brun and Fons Rademakers


       This library is free software; you can redistribute it and/or modify it under the terms of the GNU Lesser
       General Public License as published by the Free Software Foundation; either version 2.1 of  the  License,
       or (at your option) any later version.

       This  library  is  distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even
       the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU Lesser  General
       Public License for more details.

       You should have received a copy of the GNU Lesser General Public License along with this library; if not,
       write to the Free Software Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA  02110-1301  USA


AUTHOR
       This manual page was written by Christian Holm  Christensen  <cholm@nbi.dk>,  for  the  Debian  GNU/Linux
       system (but may be used by others).