ServiceX analysis utils
This repository hosts tools that depend on the ServiceX Client. These tools facilitate ServiceX's general usage and offer specific features that replace parts of an analyser workflow.
To install
pip install servicex-analysis-utils
Requirements
This package depends requires a servicex.yml configuration file granting access to one endpoint with a deployed ServiceX backend.
This package contains:
to_awk():
Load an awkward array from the deliver() output with uproot or uproot.dask.
Parameters:
deliver_dict (dict): Returned dictionary from servicex.deliver()
(keys are sample names, values are file paths or URLs).
dask (bool): Optional. Flag to load as dask-awkward array. Default is False
iterator(bool): Optional. Flag to materialize the data into arrays or to return iterables with uproot.iterate
**kwargs : Optional. Additional keyword arguments passed to uproot.dask, uproot.iterate and from_parquet
Returns:
dict: keys are sample names and values are awkward arrays, uproot generator objects or dask-awkward arrays.
get-structure():
Creates and sends the ServiceX request from user inputed datasets to retrieve file stucture.
Calls print_structure_from_str() to dump the structure in a user-friendly format
Parameters:
datasets (dict,str,[str]): The datasets from which to print the file structures.
A name can be given as the key of each dataset in a dictionary
kwargs : Arguments to be propagated to print_structure_from_str, e.g filter_branch
Function can be called from the command line, e.g:
$ servicex-get-structure "mc23_13TeV:some-dataset-rucio-id" --filter_branch "truth"
Documentation
The different functions are documented at tryservicex.org.
To make updates to the documentation please see the ServiceX DocGuide for more information.
Metadata
Release files for servicex-analysis-utils 1.2.3
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| servicex_analysis_utils-1.2.3.tar.gz | 8.8 kB | With provenance | Details for servicex_analysis_utils-1.2.3.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| servicex_analysis_utils-1.2.3-py3-none-any.whl | Python 3 | none | any | Details for servicex_analysis_utils-1.2.3-py3-none-any.whl |
Total release size: 23.1 kB
Release files / servicex_analysis_utils-1.2.3.tar.gz
| Download URL | servicex_analysis_utils-1.2.3.tar.gz |
|---|---|
| Size | 8.8 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
e41de4a65e3acb65c693bd3c77b1bb408b8e9628508a6d22a0d325f27d3f6ae6
|
|
BLAKE2b-256 checksum How to use checksums |
7e63c5f29646361dafadd2b791530dd68d08b84e981adfb673f5b07c5785ad95
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.0.1 CPython/3.12.8
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Mar 13, 2026.
Transparency logRelease files / servicex_analysis_utils-1.2.3-py3-none-any.whl
| Download URL | servicex_analysis_utils-1.2.3-py3-none-any.whl |
|---|---|
| Size | 14.3 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
d6239162a06abf8657e80b347ed43349bcef3b12236010f37eef0e91915990d0
|
|
BLAKE2b-256 checksum How to use checksums |
c9e53727b57c8559c6fbb8cb87834d533d7d1a5834f0034894043027095e8583
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.0.1 CPython/3.12.8
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Mar 13, 2026.
Transparency logSecurity for servicex-analysis-utils 1.2.3
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
Full provenance
Both files in this release have been uploaded with provenance metadata.
Attestation for servicex_analysis_utils-1.2.3.tar.gz
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Mar 13, 2026.
Transparency logA note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.