forked from root-project/root
-
Notifications
You must be signed in to change notification settings - Fork 0
/
h2root.1
153 lines (153 loc) · 3.79 KB
/
h2root.1
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
.\"
.\" $Id: h2root.1,v 1.1 2001/08/15 13:30:48 rdm Exp $
.\"
.TH H2ROOT 1 "Version 3" "ROOT"
.\" NAME should be all caps, SECTION should be 1-8, maybe w/ subsection
.\" other parms are allowed: see man(7), man(1)
.SH NAME
h2root \- convert PAW HBOOK files to ROOT files
.SH SYNOPSIS
.B h2root
.I file.hbook file.root [compress] [tolower] [lrecl]
.SH DESCRIPTION
.B h2root
you can use to convert your
.B HBOOK/PAW
histograms or ntuples files into
.B ROOT
files. To use this program, you type the shell script command:
.sp 1
.RS
.B h2root
.I hbookfile
.I rootfile
.RE
.sp 1
If you do not specify the second parameter, a file name is
automatically generated for you. If
.I hbookfile
is of the form
.IR file.hbook ,
then the
.B ROOT
file will be
called
.IR file.root .
.PP
This program converts
.B HBOOK
histograms into
.B ROOT
objects of the class
.IR TH1F .
.B HBOOK
profile histograms are converted into
.B ROOT
profile histograms (see class
.IR TProfile ).
.B HBOOK
row-wise and column-wise ntuples are automatically converted to
.B ROOT
Trees(see
.IR TTree ).
Some
.B 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.
.PP
.B HBOOK
integer identifiers are converted into
.B 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.
.PP
In case of row-wise or column-wise ntuples, each column is converted
to a branch of a Tree.
.B
Note that
.B h2root
is able to convert
.B HBOOK
files containing several levels of sub-directories.
.B
Once you have converted your file, you can look at it and draw
histograms or process ntuples using the
.B ROOT
interactive module. You can also use the
.B ROOT
browser (see
.IR TBrowser )
to inspect this file.
.PP
The chapter
.I How to read a Tree
explains two ways to read a Tree. ROOT includes the function
.I TTree::MakeCode
to automatically generate the code for a skeleton analysis
function. With
.SH OPTIONS
.TP
.B compress
= 1 by default (use 0 for no compression)
.TP
.B tolower
= 1 by default (use 0 to keep case of column names)
.TP
.B lrecl
= 0 by default (must be specified if >8092)
.SH "SEE ALSO"
.RS
.IR root(1) ,
.I g2root(1)
.RE
and
.RS
.I The ROOT Users Guide
.RE
available from the main
.B ROOT
website:
.RS
.I http://root.cern.ch
.RE
.PP
.B h2root
is documented fully on
.RS
.I http://root.cern.ch/root/HowtoConvert.html
.RE
.SH "ORIGINAL AUTHORS"
The ROOT team (see web page above):
.RS
\fBRene Brun\fR and \fBFons Rademakers\fR
.RE
.SH "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.
.P
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.
.P
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
.SH 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).
.\"
.\" $Log: h2root.1,v $
.\" Revision 1.1 2001/08/15 13:30:48 rdm
.\" move man files to new subdir man1. This makes it possible to add
.\" $ROOTSYS/man to MANPATH and have "man root" work.
.\"
.\" Revision 1.1 2000/12/08 17:41:00 rdm
.\" man pages of all ROOT executables provided by Christian Holm.
.\"
.\"