4.11.8. tree Package

4.11.8.1. tree Package

4.11.8.2. categories Module

class rootpy.tree.categories.Node(feature, data, variables, leftchild=None, rightchild=None, parent=None)[source]

Bases: object

balance()[source]
clone()[source]
depth()[source]
get_incomplete_children()[source]
get_leaves()[source]
is_complete()[source]
is_leaf()[source]
set_left(child)[source]
set_right(child)[source]
walk(expression=None)[source]
rootpy.tree.categories.parse_tree(string, variables=None)[source]

4.11.8.3. chain Module

class rootpy.tree.chain.TreeChain(name, files, buffer=None, branches=None, events=-1, stream=None, onfilechange=None, cache=False, cache_size=10000000, learn_entries=1, always_read=None, ignore_unsupported=False, filters=None, verbose=False)[source]

Bases: rootpy.tree.chain._BaseTreeChain

A ROOT.TChain replacement

reset()[source]

Reset the chain to the first file Note: not valid when in queue mode

class rootpy.tree.chain.TreeQueue(name, files, buffer=None, branches=None, events=-1, stream=None, onfilechange=None, cache=False, cache_size=10000000, learn_entries=1, always_read=None, ignore_unsupported=False, filters=None, verbose=False)[source]

Bases: rootpy.tree.chain._BaseTreeChain

SENTINEL = None

4.11.8.4. cut Module

rootpy.tree.cut.cutop(func)[source]
rootpy.tree.cut.icutop(func)[source]

4.11.8.5. cutflow Module

class rootpy.tree.cutflow.Cutflow(names=None)[source]

Bases: object

bitstring()[source]
int()[source]
passed(name)[source]
reset()[source]
stages()[source]
class rootpy.tree.cutflow.CutflowTable(lumi=1.0)[source]

Bases: object

add_sample(sample, name, weight=1.0)[source]

4.11.8.6. filtering Module

class rootpy.tree.filtering.EventFilter(hooks=None, passthrough=False, name=None, count_funcs=None)[source]

Bases: rootpy.tree.filtering.Filter

finalize()[source]

You should override this method in your derived class

passes(event)[source]

You should override this method in your derived class

class rootpy.tree.filtering.EventFilterList[source]

Bases: rootpy.tree.filtering.FilterList

append(filter)[source]
finalize()[source]
class rootpy.tree.filtering.Filter(hooks=None, passthrough=False, name=None, count_funcs=None)[source]

Bases: object

The base class from which all filter classes must inherit from. The derived class must override the passes method which returns True if ths event passes and returns False if not. The number of passing and failing events are recorded and may be used later to create a cut-flow.

classmethod add(left, right)[source]
failed(event)[source]
passed(event)[source]
class rootpy.tree.filtering.FilterHook(target, args)[source]

Bases: object

class rootpy.tree.filtering.FilterList[source]

Bases: list

Creates a list of Filters for convenient evaluation of a sequence of Filters.

append(filter)[source]
basic()[source]

Return all filters as simple dicts for pickling. Removes all dependence on this module.

classmethod merge(list1, list2)[source]
passing[source]
total[source]
class rootpy.tree.filtering.ObjectFilter(count_events=False, **kwargs)[source]

Bases: rootpy.tree.filtering.Filter

filtered(event, collection)[source]

You should override this method in your derived class

class rootpy.tree.filtering.ObjectFilterList[source]

Bases: rootpy.tree.filtering.FilterList

append(filter)[source]

4.11.8.7. tree Module

class rootpy.tree.tree.Tree(name=None, title=None, model=None, file=None, ignore_unsupported=False)[source]

Bases: rootpy.core.Object, rootpy.plotting.core.Plottable, rootpy.core.RequireFile, TTree

Inherits from TTree so all regular TTree methods are available but certain methods (i.e. Draw) have been overridden to improve usage in Python

CopyTree(selection, *args, **kwargs)[source]

Convert selection (tree.Cut) to string

DRAW_PATTERN = <_sre.SRE_Pattern object at 0x2498be0>
Draw(expression, selection='', options='', hist=None, min=None, max=None, bins=None, **kwargs)[source]

Draw a TTree with a selection as usual, but return the created histogram.

Fill(reset=False)[source]
GetEntries(cut=None, weighted_cut=None, weighted=False)[source]
GetEntry(entry)[source]
GetMaximum(expression, cut=None)[source]
GetMinimum(expression, cut=None)[source]
Scale(value)[source]
Write(*args, **kwargs)[source]
activate(branches, exclusive=False)[source]
always_read(branches)[source]
classmethod branch_is_supported(branch)[source]

Currently the branch must only have one leaf but the leaf may have one or multiple elements

classmethod branch_type(branch)[source]
branches[source]
branchnames[source]
create_branches(branches)[source]
create_buffer()[source]
csv(sep=', ', branches=None, include_labels=True, limit=None, stream=None)[source]

Print csv representation of tree only including branches of basic types (no objects, vectors, etc..)

deactivate(branches, exclusive=False)[source]
glob(patterns, prune=None)[source]

Return a list of branch names that match pattern. Exclude all matched branch names which also match a pattern in prune. prune may be a string or list of strings.

has_branch(branch)[source]
iterbranches()[source]
iterbranchnames()[source]
ndarray(branches=None, dtype=None, include_weight=False, weight_dtype='f4')[source]

Convert this tree into a NumPy ndarray

recarray(branches=None, include_weight=False, weight_name='weight', weight_dtype='f4')[source]

Convert this tree into a NumPy recarray

reset_branch_values()[source]
set_buffer(buffer, branches=None, ignore_branches=None, create_branches=False, visible=True, ignore_missing=False, transfer_objects=False)[source]
update_buffer(buffer, transfer_objects=False)[source]
use_cache(cache=True, cache_size=10000000, learn_entries=1)[source]
class rootpy.tree.tree.UserData[source]

Bases: object

4.11.8.8. treeobject Module

class rootpy.tree.treeobject.TreeCollection(tree, name, prefix, size, mix=None, cache=True)[source]

Bases: object

getitem(index)[source]

direct access without going through self.selection

len()[source]

length of original collection

make_persistent()[source]

Perform actual selection and sorting on underlying attribute vectors

mask(func)[source]
mask_indices(indices)[source]
pop(index)[source]
remove(thing)[source]
reset()[source]
reset_cache()[source]
reset_selection()[source]
select(func)[source]
select_indices(indices)[source]
slice(start=0, stop=None, step=1)[source]
sort(key, **kwargs)[source]
class rootpy.tree.treeobject.TreeCollectionObject(tree, name, prefix, index)[source]

Bases: rootpy.tree.treeobject.TreeObject

class rootpy.tree.treeobject.TreeObject(tree, name, prefix)[source]

Bases: object

rootpy.tree.treeobject.mix_classes(cls, mixins)[source]
rootpy.tree.treeobject.one_to_many_assoc(name, collection, index_branch)[source]
rootpy.tree.treeobject.one_to_one_assoc(name, collection, index_branch)[source]