← Back to branch summary

~ubuntu-branches/ubuntu/natty/pytables/natty-updates

« back to all changes in this revision

Viewing changes to doc/html/x5654.html

  • Committer: Bazaar Package Importer
  • Author(s): Alexandre Fayolle
  • Date: 2006-06-28 10:45:03 UTC
  • mfrom: (1.2.1 upstream)
  • mto: This revision was merged to the branch mainline in revision 5.
  • Revision ID: james.westby@ubuntu.com-20060628104503-cc251q5o5j3e2k10
  * Fixed call to pyversions in debian/rules which failed on recent versions 
    of pyversions
  * Fixed clean rule in debian/rules which left the stamp files behind
  * Acknowledge NMU
  * Added Alexandre Fayolle to uploaders

Show diffs side-by-side

added added

removed removed

Lines of Context:
doc/html/x5654.html
 
1
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN""http://www.w3.org/TR/html4/loose.dtd">
 
2
<HTML
 
3
><HEAD
 
4
><TITLE
 
5
>Selecting an User Entry Point (UEP) in your
 
6
            tree</TITLE
 
7
><META
 
8
NAME="GENERATOR"
 
9
CONTENT="Modular DocBook HTML Stylesheet Version 1.79"><LINK
 
10
REL="HOME"
 
11
TITLE="PyTables User's Guide"
 
12
HREF="index.html"><LINK
 
13
REL="UP"
 
14
TITLE="Optimization tips"
 
15
HREF="c5270.html"><LINK
 
16
REL="PREVIOUS"
 
17
TITLE="Getting the most from the node LRU cache"
 
18
HREF="x5576.html"><LINK
 
19
REL="NEXT"
 
20
TITLE="Compacting your PyTables
 
21
            files
 
22
          "
 
23
HREF="x5689.html"></HEAD
 
24
><BODY
 
25
CLASS="sect1"
 
26
BGCOLOR="#FFFFFF"
 
27
TEXT="#000000"
 
28
LINK="#0000FF"
 
29
VLINK="#840084"
 
30
ALINK="#0000FF"
 
31
><DIV
 
32
CLASS="NAVHEADER"
 
33
><TABLE
 
34
SUMMARY="Header navigation table"
 
35
WIDTH="100%"
 
36
BORDER="0"
 
37
CELLPADDING="0"
 
38
CELLSPACING="0"
 
39
><TR
 
40
><TH
 
41
COLSPAN="3"
 
42
ALIGN="center"
 
43
><SPAN
 
44
CLASS="markup"
 
45
>PyTables</SPAN
 
46
> User's Guide: Hierarchical datasets in Python - Release 1.3.2</TH
 
47
></TR
 
48
><TR
 
49
><TD
 
50
WIDTH="10%"
 
51
ALIGN="left"
 
52
VALIGN="bottom"
 
53
><A
 
54
HREF="x5576.html"
 
55
ACCESSKEY="P"
 
56
>Prev</A
 
57
></TD
 
58
><TD
 
59
WIDTH="80%"
 
60
ALIGN="center"
 
61
VALIGN="bottom"
 
62
>Chapter 5. Optimization tips</TD
 
63
><TD
 
64
WIDTH="10%"
 
65
ALIGN="right"
 
66
VALIGN="bottom"
 
67
><A
 
68
HREF="x5689.html"
 
69
ACCESSKEY="N"
 
70
>Next</A
 
71
></TD
 
72
></TR
 
73
></TABLE
 
74
><HR
 
75
ALIGN="LEFT"
 
76
WIDTH="100%"></DIV
 
77
><DIV
 
78
CLASS="sect1"
 
79
><H1
 
80
CLASS="sect1"
 
81
><A
 
82
NAME="section5.7"
 
83
>5.7. Selecting an User Entry Point (UEP) in your
 
84
            tree</A
 
85
></H1
 
86
><P
 
87
><SPAN
 
88
CLASS="emphasis"
 
89
><I
 
90
CLASS="emphasis"
 
91
>Note:</I
 
92
></SPAN
 
93
> After the introduction
 
94
            of the new object tree cache in PyTables 1.2, this feature
 
95
            is not very useful anymore and might become
 
96
            <SPAN
 
97
CLASS="emphasis"
 
98
><I
 
99
CLASS="emphasis"
 
100
>deprecated</I
 
101
></SPAN
 
102
> in future versions.
 
103
          </P
 
104
><P
 
105
>If you have a <SPAN
 
106
CLASS="emphasis"
 
107
><I
 
108
CLASS="emphasis"
 
109
>huge</I
 
110
></SPAN
 
111
> tree in
 
112
            your data file with many nodes on it, creating the object
 
113
            tree would take long time. Many times, however, you are
 
114
            interested only in access to a part of the complete tree, so
 
115
            you won't strictly need PyTables to build the entire object
 
116
            tree in-memory, but only the <SPAN
 
117
CLASS="emphasis"
 
118
><I
 
119
CLASS="emphasis"
 
120
>interesting</I
 
121
></SPAN
 
122
> part.
 
123
          </P
 
124
><P
 
125
>This is where the <SAMP
 
126
CLASS="computeroutput"
 
127
>rootUEP</SAMP
 
128
> parameter of
 
129
            <SAMP
 
130
CLASS="computeroutput"
 
131
>openFile</SAMP
 
132
> function (see <A
 
133
HREF="c1381.html#openFileDescr"
 
134
>4.1.2</A
 
135
>) can be helpful. Imagine that
 
136
            you have a file called <SAMP
 
137
CLASS="computeroutput"
 
138
>"test.h5"</SAMP
 
139
> with the
 
140
            associated tree that you can see in figure <A
 
141
HREF="x5654.html#rootUEPfig1"
 
142
>5.17</A
 
143
>, and you are interested only in
 
144
            the section marked in red.  You can avoid the build of all
 
145
            the object tree by saying to <SAMP
 
146
CLASS="computeroutput"
 
147
>openFile</SAMP
 
148
> that your
 
149
            root will be the <SAMP
 
150
CLASS="computeroutput"
 
151
>/Group2/Group3</SAMP
 
152
> group. That is:
 
153
          </P
 
154
><PRE
 
155
CLASS="screen"
 
156
>&#13;      fileh = openFile("test.h5", rootUEP="/Group2/Group3")
 
157
          </PRE
 
158
><P
 
159
>As a result, the actual object tree built will be like the
 
160
            one that can be seen in <A
 
161
HREF="x5654.html#rootUEPfig2"
 
162
>figure�5.18</A
 
163
>.
 
164
          </P
 
165
><P
 
166
>Of course this has been a simple example and the use
 
167
            of the <SAMP
 
168
CLASS="computeroutput"
 
169
>rootUEP</SAMP
 
170
> parameter was not very
 
171
            necessary. But when you have <SPAN
 
172
CLASS="emphasis"
 
173
><I
 
174
CLASS="emphasis"
 
175
>thousands</I
 
176
></SPAN
 
177
> of nodes on
 
178
            a tree, you will certainly appreciate the
 
179
            <SAMP
 
180
CLASS="computeroutput"
 
181
>rootUEP</SAMP
 
182
> parameter.
 
183
          </P
 
184
><DIV
 
185
CLASS="figure"
 
186
><A
 
187
NAME="rootUEPfig1"
 
188
></A
 
189
><P
 
190
><B
 
191
>Figure 5.17. Complete tree in file <SPAN
 
192
CLASS="markup"
 
193
>test.h5</SPAN
 
194
>, and subtree of interest for
 
195
              the user.
 
196
            </B
 
197
></P
 
198
><DIV
 
199
CLASS="mediaobject"
 
200
><P
 
201
><IMG
 
202
SRC="rootUEP1.png"></P
 
203
></DIV
 
204
></DIV
 
205
><DIV
 
206
CLASS="figure"
 
207
><A
 
208
NAME="rootUEPfig2"
 
209
></A
 
210
><P
 
211
><B
 
212
>Figure 5.18. Resulting object tree derived from the use of the
 
213
              <SPAN
 
214
CLASS="markup"
 
215
>rootUEP</SPAN
 
216
> parameter.
 
217
            </B
 
218
></P
 
219
><DIV
 
220
CLASS="mediaobject"
 
221
><P
 
222
><IMG
 
223
SRC="rootUEP2.png"></P
 
224
></DIV
 
225
></DIV
 
226
></DIV
 
227
><DIV
 
228
CLASS="NAVFOOTER"
 
229
><HR
 
230
ALIGN="LEFT"
 
231
WIDTH="100%"><TABLE
 
232
SUMMARY="Footer navigation table"
 
233
WIDTH="100%"
 
234
BORDER="0"
 
235
CELLPADDING="0"
 
236
CELLSPACING="0"
 
237
><TR
 
238
><TD
 
239
WIDTH="33%"
 
240
ALIGN="left"
 
241
VALIGN="top"
 
242
><A
 
243
HREF="x5576.html"
 
244
ACCESSKEY="P"
 
245
>Prev</A
 
246
></TD
 
247
><TD
 
248
WIDTH="34%"
 
249
ALIGN="center"
 
250
VALIGN="top"
 
251
><A
 
252
HREF="index.html"
 
253
ACCESSKEY="H"
 
254
>Home</A
 
255
></TD
 
256
><TD
 
257
WIDTH="33%"
 
258
ALIGN="right"
 
259
VALIGN="top"
 
260
><A
 
261
HREF="x5689.html"
 
262
ACCESSKEY="N"
 
263
>Next</A
 
264
></TD
 
265
></TR
 
266
><TR
 
267
><TD
 
268
WIDTH="33%"
 
269
ALIGN="left"
 
270
VALIGN="top"
 
271
>Getting the most from the node LRU cache</TD
 
272
><TD
 
273
WIDTH="34%"
 
274
ALIGN="center"
 
275
VALIGN="top"
 
276
><A
 
277
HREF="c5270.html"
 
278
ACCESSKEY="U"
 
279
>Up</A
 
280
></TD
 
281
><TD
 
282
WIDTH="33%"
 
283
ALIGN="right"
 
284
VALIGN="top"
 
285
>Compacting your <SPAN
 
286
CLASS="markup"
 
287
>PyTables</SPAN
 
288
>
 
289
            files</TD
 
290
></TR
 
291
></TABLE
 
292
></DIV
 
293
></BODY
 
294
></HTML
 
295
>
 
 
b'\\ No newline at end of file'