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