H2ROOT(1) 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(1,n) name is automati-
cally generated for you. If hbookfile is of the form file.hbook, then
the ROOT file(1,n) 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 col-
umn-wise ntuples may not be fully converted in(1,8) case one of the columns
is an array with fix dimensions (eg. `var[6]') or is a multi-dimen-
sional array.
HBOOK integer identifiers are converted into ROOT named(5,8) objects by pre-
fixing the integer identifier with the letter `h' if(3,n) the identifier is
a positive integer and by `h_' if(3,n) 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(1,n), you can look(1,8,3 Search::Dict) 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(2,n,1 builtins) a Tree explains two ways to read(2,n,1 builtins) 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(3,n) >8092)
SEE ALSO
root(1), g2root(1)
and
The ROOT Users Guide
avaliable 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
ROOT Software Terms and Conditions
The authors hereby grant permission to use, copy, and distribute this
software and its documentation for any purpose, provided that existing
copyright notices are retained in(1,8) all copies and that this notice is
included verbatim in(1,8) any distributions. Additionally, the authors grant
permission to modify this software and its documentation for any pur-
pose, provided that such modifications are not distributed without the
explicit consent of the authors and that existing copyright notices are
retained in(1,8) all copies. Users of the software are asked to feed back
problems, benefits, and/or suggestions about the software to the ROOT
Development Team (rootdev@root.cern.ch). Support for this software -
fixing of bugs, incorporation of new features - is done on a best
effort basis. All bug fixes and enhancements will be made available
under the same terms and conditions as the original software,
IN NO EVENT SHALL THE AUTHORS OR DISTRIBUTORS BE LIABLE TO ANY PARTY
FOR DIRECT, INDIRECT, SPECIAL, INCIDENTAL, OR CONSEQUENTIAL DAMAGES
ARISING OUT OF THE USE OF THIS SOFTWARE, ITS DOCUMENTATION, OR ANY DE-
RIVATIVES THEREOF, EVEN IF THE AUTHORS HAVE BEEN ADVISED OF THE POSSI-
BILITY OF SUCH DAMAGE.
THE AUTHORS AND DISTRIBUTORS SPECIFICALLY DISCLAIM ANY WARRANTIES,
INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABIL-
ITY, FITNESS FOR A PARTICULAR PURPOSE, AND NON-INFRINGEMENT. THIS SOFT-
WARE IS PROVIDED ON AN "AS IS" BASIS, AND THE AUTHORS AND DISTRIBUTORS
HAVE NO OBLIGATION TO PROVIDE MAINTENANCE, SUPPORT, UPDATES, ENHANCE-
MENTS, OR MODIFICATIONS.
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)