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

COPYRIGHT

       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).

ROOT                                                Version 3                                          H2ROOT(1)