diff --git a/src/uproot/_dask.py b/src/uproot/_dask.py index 8c4c2e3b2..1a628f563 100644 --- a/src/uproot/_dask.py +++ b/src/uproot/_dask.py @@ -195,8 +195,9 @@ def dask( If None, deduced from input file type. * timeout (float for HTTP, int for XRootD; default defined by source implementation): The time in seconds to wait before giving up on the connection. Ignored for non-internet sources like local file paths. - * max_num_elements (None or int; None): The maximum number of elements to be requested in a single vector - read, when using XRootD. + * max_num_elements (None or int; None): The maximum number of byte ranges requested in a single XRootD + vector read. This does not limit the number of TTree or RNTuple entries read; pass ``entry_stop`` to + ``arrays``, ``uproot.iterate``, or ``uproot.concatenate`` instead. * num_workers (int; 1): Number of tasks to spawn for reading, only used by some source types * use_threads (bool; False on the emscripten platform (i.e. in a web browser), else True): Use multi-threading when spawning workers. diff --git a/src/uproot/behaviors/RNTuple.py b/src/uproot/behaviors/RNTuple.py index 1d02765ed..03cf585e7 100644 --- a/src/uproot/behaviors/RNTuple.py +++ b/src/uproot/behaviors/RNTuple.py @@ -151,8 +151,9 @@ def iterate( If None, deduced from input file type. * timeout (float for HTTP, int for XRootD; default defined by source implementation): The time in seconds to wait before giving up on the connection. Ignored for non-internet sources like local file paths. - * max_num_elements (None or int; None): The maximum number of elements to be requested in a single vector - read, when using XRootD. + * max_num_elements (None or int; None): The maximum number of byte ranges requested in a single XRootD + vector read. This does not limit the number of TTree or RNTuple entries read; pass ``entry_stop`` to + ``arrays``, ``uproot.iterate``, or ``uproot.concatenate`` instead. * num_workers (int; 1): Number of tasks to spawn for reading, only used by some source types * use_threads (bool; False on the emscripten platform (i.e. in a web browser), else True): Use multi-threading when spawning workers. @@ -355,8 +356,9 @@ def concatenate( If None, deduced from input file type. * timeout (float for HTTP, int for XRootD; default defined by source implementation): The time in seconds to wait before giving up on the connection. Ignored for non-internet sources like local file paths. - * max_num_elements (None or int; None): The maximum number of elements to be requested in a single vector - read, when using XRootD. + * max_num_elements (None or int; None): The maximum number of byte ranges requested in a single XRootD + vector read. This does not limit the number of TTree or RNTuple entries read; pass ``entry_stop`` to + ``arrays``, ``uproot.iterate``, or ``uproot.concatenate`` instead. * num_workers (int; 1): Number of tasks to spawn for reading, only used by some source types * use_threads (bool; False on the emscripten platform (i.e. in a web browser), else True): Use multi-threading when spawning workers. diff --git a/src/uproot/behaviors/TBranch.py b/src/uproot/behaviors/TBranch.py index 92c63df0e..2ecfa74ab 100644 --- a/src/uproot/behaviors/TBranch.py +++ b/src/uproot/behaviors/TBranch.py @@ -176,8 +176,9 @@ def iterate( If None, deduced from input file type. * timeout (float for HTTP, int for XRootD; default defined by source implementation): The time in seconds to wait before giving up on the connection. Ignored for non-internet sources like local file paths. - * max_num_elements (None or int; None): The maximum number of elements to be requested in a single vector - read, when using XRootD. + * max_num_elements (None or int; None): The maximum number of byte ranges requested in a single XRootD + vector read. This does not limit the number of TTree or RNTuple entries read; pass ``entry_stop`` to + ``arrays``, ``uproot.iterate``, or ``uproot.concatenate`` instead. * num_workers (int; 1): Number of tasks to spawn for reading, only used by some source types * use_threads (bool; False on the emscripten platform (i.e. in a web browser), else True): Use multi-threading when spawning workers. @@ -391,8 +392,9 @@ def concatenate( If None, deduced from input file type. * timeout (float for HTTP, int for XRootD; default defined by source implementation): The time in seconds to wait before giving up on the connection. Ignored for non-internet sources like local file paths. - * max_num_elements (None or int; None): The maximum number of elements to be requested in a single vector - read, when using XRootD. + * max_num_elements (None or int; None): The maximum number of byte ranges requested in a single XRootD + vector read. This does not limit the number of TTree or RNTuple entries read; pass ``entry_stop`` to + ``arrays``, ``uproot.iterate``, or ``uproot.concatenate`` instead. * num_workers (int; 1): Number of tasks to spawn for reading, only used by some source types * use_threads (bool; False on the emscripten platform (i.e. in a web browser), else True): Use multi-threading when spawning workers. diff --git a/src/uproot/reading.py b/src/uproot/reading.py index efcf623f3..889651ddd 100644 --- a/src/uproot/reading.py +++ b/src/uproot/reading.py @@ -90,8 +90,9 @@ def open( If None, deduced from input file type. * timeout (float for HTTP, int for XRootD; default defined by source implementation): The time in seconds to wait before giving up on the connection. Ignored for non-internet sources like local file paths. - * max_num_elements (None or int; None): The maximum number of elements to be requested in a single vector - read, when using XRootD. + * max_num_elements (None or int; None): The maximum number of byte ranges requested in a single XRootD + vector read. This does not limit the number of TTree or RNTuple entries read; pass ``entry_stop`` to + ``arrays``, ``uproot.iterate``, or ``uproot.concatenate`` instead. * num_workers (int; 1): Number of tasks to spawn for reading, only used by some source types * use_threads (bool; False on the emscripten platform (i.e. in a web browser), else True): Use multi-threading when spawning workers. @@ -102,7 +103,6 @@ def open( * minimal_ttree_metadata (bool; True): Skip rarely used metadata and defer reading of embedded TBaskets * http_max_header_bytes (int; 21784): Maximum size of HTTP packet in bytes when the source is http - Any object derived from a ROOT file is a context manager (works in Python's ``with`` statement) that closes the file when exiting the ``with`` block. Therefore, the :doc:`uproot.reading.open` function can and usually should @@ -546,8 +546,9 @@ class ReadOnlyFile(CommonFileMethods): If None, deduced from input file type. * timeout (float for HTTP, int for XRootD; default defined by source implementation): The time in seconds to wait before giving up on the connection. Ignored for non-internet sources like local file paths. - * max_num_elements (None or int; None): The maximum number of elements to be requested in a single vector - read, when using XRootD. + * max_num_elements (None or int; None): The maximum number of byte ranges requested in a single XRootD + vector read. This does not limit the number of TTree or RNTuple entries read; pass ``entry_stop`` to + ``arrays``, ``uproot.iterate``, or ``uproot.concatenate`` instead. * num_workers (int; 1): Number of tasks to spawn for reading, only used by some source types * use_threads (bool; False on the emscripten platform (i.e. in a web browser), else True): Use multi-threading when spawning workers.