H2ROOT(1)						      General Commands Manual							 H2ROOT(1)

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 his-
       tograms (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  pub-
       lished 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 MER-
       CHANTABILITY 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  Foun-
       dation, 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)