1H2ROOT(1)                   General Commands Manual                  H2ROOT(1)
2
3
4

NAME

6       h2root - convert PAW HBOOK files to ROOT files
7

SYNOPSIS

9       h2root file.hbook file.root [compress] [tolower] [lrecl]
10

DESCRIPTION

12       h2root  you  can  use  to  convert your HBOOK/PAW histograms or ntuples
13       files into ROOT files. To use this program, you type the  shell  script
14       command:
15
16              h2root hbookfile rootfile
17
18       If  you  do  not specify the second parameter, a file name is automati‐
19       cally generated for you. If hbookfile is of the form  file.hbook,  then
20       the ROOT file will be called file.root.
21
22       This  program  converts HBOOK histograms into ROOT objects of the class
23       TH1F.  HBOOK profile histograms are converted into  ROOT  profile  his‐
24       tograms  (see  class TProfile).  HBOOK row-wise and column-wise ntuples
25       are automatically converted to ROOT Trees(see TTree).  Some HBOOK  col‐
26       umn-wise  ntuples may not be fully converted in case one of the columns
27       is an array with fix dimensions (eg. `var[6]')  or  is  a  multi-dimen‐
28       sional array.
29
30       HBOOK integer identifiers are converted into ROOT named objects by pre‐
31       fixing the integer identifier with the letter `h' if the identifier  is
32       a positive integer and by `h_' if it is a negative integer identifier.
33
34       In case of row-wise or column-wise ntuples, each column is converted to
35       a branch of a Tree.  Note that h2root is able to  convert  HBOOK  files
36       containing  several levels of sub-directories.  Once you have converted
37       your file, you can look at it and draw histograms  or  process  ntuples
38       using  the  ROOT  interactive module. You can also use the ROOT browser
39       (see TBrowser) to inspect this file.
40
41       The chapter How to read a Tree explains two ways to read a  Tree.  ROOT
42       includes  the  function  TTree::MakeCode  to automatically generate the
43       code for a skeleton analysis function. With
44

OPTIONS

46       compress
47              = 1 by default (use 0 for no compression)
48
49       tolower
50              = 1 by default (use 0 to keep case of column names)
51
52       lrecl  = 0 by default (must be specified if >8092)
53

SEE ALSO

55              root(1), g2root(1)
56       and
57              The ROOT Users Guide
58       available from the main ROOT website:
59              http://root.cern.ch
60
61       h2root is documented fully on
62              http://root.cern.ch/root/HowtoConvert.html
63

ORIGINAL AUTHORS

65       The ROOT team (see web page above):
66              Rene Brun and Fons Rademakers
67
69       This library is free software; you can redistribute it and/or modify it
70       under  the  terms of the GNU Lesser General Public License as published
71       by the Free Software Foundation; either version 2.1 of the License,  or
72       (at your option) any later version.
73
74       This  library  is  distributed  in the hope that it will be useful, but
75       WITHOUT ANY  WARRANTY;  without  even  the  implied  warranty  of  MER‐
76       CHANTABILITY  or  FITNESS FOR A PARTICULAR PURPOSE.  See the GNU Lesser
77       General Public License for more details.
78
79       You should have received a  copy  of  the  GNU  Lesser  General  Public
80       License  along  with  this  library; if not, write to the Free Software
81       Foundation, Inc., 51 Franklin St, Fifth Floor, Boston,  MA   02110-1301
82       USA
83

AUTHOR

85       This   manual   page   was   written   by  Christian  Holm  Christensen
86       <cholm@nbi.dk>, for the Debian GNU/Linux system (but  may  be  used  by
87       others).
88
89
90
91ROOT                               Version 3                         H2ROOT(1)
Impressum