uproot.language.python.PythonLanguage
Defined in uproot.language.python on line 241.
Inheritance order: |
---|
- class uproot.language.python.PythonLanguage(functions=None, getter='get')
- Parameters:
functions (None or dict) – Mapping from function name to function, or None for
default_functions
.getter (str) – Name of the function that extracts branches by name; needed for branches whose names are not valid Python symbols. Default is “get”.
PythonLanguage is the default uproot.language.Language for interpreting expressions passed to arrays (and similar). This interpretation assumes that the expressions have Python syntax and semantics, with math functions loaded into the namespace.
Unlike standard Python, an expression with attributes, such as
some.thing
, can be a single identifier, so that aTBranch
whose name contains dots does not need to be loaded withget("some.thing")
.
functions
- PythonLanguage.functions
Mapping from function name to function (dict).
getter
- PythonLanguage.getter
Name of the function that extracts branches by name; needed for branches whose names are not valid Python symbols.
getter_of
- PythonLanguage.getter_of(name)
Returns a string, an expression in which the
getter
is gettingname
as a quoted string.For example,
"get('something')"
.
free_symbols
- PythonLanguage.free_symbols(expression, keys, aliases, file_path, object_path)
- Parameters:
expression (str) – The expression to analyze.
keys (list of str) – Names of branches or aliases (for aliases that refer to aliases).
aliases (list of str) – Names of aliases.
file_path (str) – File path for error messages.
object_path (str) – Object path for error messages.
Finds the symbols in the expression that are in
keys
oraliases
, in other words,TBranch
names or alias names. These expressions may include dots (attributes). Knownfunctions
and thegetter
are excluded.
compute_expressions
- PythonLanguage.compute_expressions(hasbranches, arrays, expression_context, keys, aliases, file_path, object_path)
- Parameters:
hasbranches (uproot.behaviors.TBranch.HasBranches) – The
TTree
orTBranch
that is requesting a computation.arrays (dict of arrays) – Inputs to the computation.
expression_context (list of (str, dict) tuples) – Expression strings and a dict of metadata about each.
keys (set of str) – Names of branches or aliases (for aliases that refer to aliases).
aliases (dict of str → str) – Names of aliases and their definitions.
file_path (str) – File path for error messages.
object_path (str) – Object path for error messages.
Computes an array for each expression.