ServiceX data management using a configuration file
Project description
ServiceX DataBinder
Release v0.1.4
ServiceX DataBinder is a Python package for making multiple ServiceX requests and managing ServiceX delivered data from a configuration file.
Installation
pip install servicex-databinder
Configuration file
The configuration file is a yaml file containing all the information. An example configuration file is shown below:
General:
ServiceXBackendName: uproot
OutputDirectory: /path/to/output
OutputFormat: parquet
Sample:
- Name: ttH
GridDID: user.kchoi:user.kchoi.sampleA,
user.kchoi:user.kchoi.sampleB
Tree: nominal
FuncADL: "Select(lambda event: {'jet_e': event.jet_e, 'jet_pt': event.jet_pt})"
- Name: ttW
GridDID: user.kchoi:user.kchoi.sampleC
Tree: nominal
Filter: n_jet > 5
Columns: jet_e, jet_pt
ServiceX query can be constructed with either TCut syntax or func-adl.
- Options for TCut expression:
Filter
andColumns
- Option for Func-adl expression:
FuncADL
The following settings are available options:
Option for General |
Description | DataType |
---|---|---|
ServiceXBackendName |
ServiceX backend name (only uproot is supported at the moment) |
String |
OutputDirectory |
Path to the directory for ServiceX delivered files | String |
OutputFormat |
Output file format of ServiceX delivered data (only parquet is supported at the moment) |
String |
WriteOutputDict |
Name of a yaml file containing Python nested dictionary of output file paths (located in the OutputDirectory ) |
String |
IgnoreServiceXCache |
Ignore the existing ServiceX cache and force to make ServiceX requests | Boolean |
Option for Sample |
Description | DataType |
---|---|---|
Name |
sample name defined by a user | String |
GridDID |
Rucio Dataset Id (DID) for a given sample; Can be multiple DIDs separated by comma | String |
Tree |
Name of the input ROOT TTree |
String |
Filter |
Selection in the TCut syntax, e.g. jet_pt > 10e3 && jet_eta < 2.0 (TCut ONLY) |
String |
Columns |
List of columns (or branches) to be delivered; multiple columns separately by comma (TCut ONLY) | String |
FuncADL |
func-adl expression for a given sample (func adl ONLY) | String |
Deliver data
from servicex_databinder import DataBinder
sx_db = DataBinder('<CONFIG>.yml')
out = sx_db.deliver()
The function deliver()
returns a Python nested dictionary: out['<SAMPLE>']['<TREE>'] = [ List of output files ]
.
Acknowledgements
Support for this work was provided by the the U.S. Department of Energy, Office of High Energy Physics under Grant No. DE-SC0007890
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for servicex_databinder-0.1.4.tar.gz
Algorithm | Hash digest | |
---|---|---|
SHA256 | 7b13cd1ad9706d9e5dea858bb513ada8ab8b6559cc711ed1e84794a474f71c11 |
|
MD5 | 29311d599725b2f0b6af62553808620f |
|
BLAKE2b-256 | 48f476a54ff5f5f4616350e1bd9f69d79f45d9f00112c5c90c846dc664c02746 |
Hashes for servicex_databinder-0.1.4-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 8c4ce7f1758a07c48a8fb56d5e16b34d7ff11ca01313ec4ef79f990d666b4de1 |
|
MD5 | 82f0984cffbf1c06c4187147f11a2ebb |
|
BLAKE2b-256 | f5e820a3cdeeda82f44c38d30d7eeee68898339340fab61d6cbe43d817d2a170 |