uproot.interpretation.library
This module represents external libraries that define “array-like” types so that users can choose an output format.
The uproot.interpretation.library.NumPy library always works (NumPy is Uproot’s only strict dependency) and outputs NumPy arrays for single arrays and dict/tuple/list as groups. Objects and jagged arrays are not efficiently represented, but it provides a zero-dependency least common denominator.
The uproot.interpretation.library.Awkward library is the default and
depends on Awkward Array (awkward
). It is usually the best option, as it
was designed for Uproot.
The uproot.interpretation.library.Pandas library outputs
pandas.Series
for single arrays and pandas.DataFrame
as groups. Objects
are not efficiently represented, but some jagged arrays are encoded as
pandas.MultiIndex
.
Lazy arrays (uproot.behaviors.TBranch.lazy) can only use the uproot.interpretation.library.Awkward library.