# uproot.dask

Defined in uproot.behaviors.TBranch on line 696.

uproot.behaviors.TBranch.dask(files, filter_name=<function no_filter>, filter_typename=<function no_filter>, filter_branch=<function no_filter>, recursive=True, full_paths=False, step_size='100 MB', library='np', custom_classes=None, allow_missing=False, open_files=True, **options)
  Parameters:

    - files – See below.

    - filter_name (None, glob string, regex string in `"/pattern/i"` syntax, function of str → bool, or iterable of the above) – A filter to select `TBranches` by name.

    - filter_typename (None, glob string, regex string in `"/pattern/i"` syntax, function of str → bool, or iterable of the above) – A filter to select `TBranches` by type.

    - filter_branch (None or function of uproot.TBranch → bool, uproot.interpretation.Interpretation, or None) – A filter to select `TBranches` using the full uproot.TBranch object. If the function returns False or None, the `TBranch` is excluded; if the function returns True, it is included with its standard interpretation; if an uproot.interpretation.Interpretation, this interpretation overrules the standard one.

    - recursive (bool) – If True, include all subbranches of branches as separate fields; otherwise, only search one level deep.

    - full_paths (bool) – If True, include the full path to each subbranch with slashes (`/`); otherwise, use the descendant’s name as the field name.

    - step_size (int or str) – If an integer, the maximum number of entries to include in each chunk; if a string, the maximum memory_size to include in each chunk. The string must be a number followed by a memory unit, such as “100 MB”.

    - library (str or uproot.interpretation.library.Library) – The library that is used to represent arrays.

    - custom_classes (None or dict) – If a dict, override the classes from the uproot.ReadOnlyFile or `uproot.classes`.

    - allow_missing (bool) – If True, skip over any files that do not contain the specified `TTree`.

    - options – See below.

  Returns dask equivalents of the backends supported by uproot.

  Allowed types for the `files` parameter:

  - str/bytes: relative or absolute filesystem path or URL, without any colons other than Windows drive letter or URL schema. Examples: `"rel/file.root"`, `"C:\abs\file.root"`, `"http://where/what.root"`

  - str/bytes: same with an object-within-ROOT path, separated by a colon. Example: `"rel/file.root:tdirectory/ttree"`

  - pathlib.Path: always interpreted as a filesystem path or URL only (no object-within-ROOT path), regardless of whether there are any colons. Examples: `Path("rel:/file.root")`, `Path("/abs/path:stuff.root")`

  - glob syntax in str/bytes and pathlib.Path. Examples: `Path("rel/*.root")`, `"/abs/*.root:tdirectory/ttree"`

  - dict: keys are filesystem paths, values are objects-within-ROOT paths. Example: `{{"/data_v1/*.root": "ttree_v1", "/data_v2/*.root": "ttree_v2"}}`

  - already-open TTree objects.

  - iterables of the above.

  Options (type; default):

  - file_handler (uproot.source.chunk.Source class; uproot.MemmapSource)

  - xrootd_handler (uproot.source.chunk.Source class; uproot.XRootDSource)

  - http_handler (uproot.source.chunk.Source class; uproot.HTTPSource)

  - object_handler (uproot.source.chunk.Source class; uproot.ObjectSource)

  - timeout (float for HTTP, int for XRootD; 30)

  - max_num_elements (None or int; None)

  - num_workers (int; 1)

  - num_fallback_workers (int; 10)

  - begin_chunk_size (memory_size; 512)

  - minimal_ttree_metadata (bool; True)

  Other file entry points:

  - uproot.open: opens one file to read any of its objects.

  - uproot.iterate: iterates through chunks of contiguous entries in `TTrees`.

  - uproot.concatenate: returns a single concatenated array from `TTrees`.

  - uproot.lazy (this function): returns a lazily read array from `TTrees`.