Servicex

ServiceX

Overview

Provide concise, correct func_adl query patterns for ServiceX on ATLAS xAOD, with best practices for selections, outputs, and deliver usage.

Workflow

1. Identify the dataset type and base query.
   • Use FuncADLQueryPHYSLITE for PHYSLITE or OpenData.
   • Use FuncADLQueryPHYS for PHYS or other derivations.
2. Build a top-level Select that gathers all required collections and singletons.
   • Apply object-level filters with nested .Where inside this Select.
   • Do not pick columns yet.
3. Apply event-level filtering with a top-level .Where after the collections Select.
4. Create a final top-level Select that returns a single dictionary of output columns.
   • Convert units to standard LHC units (GeV, meters, etc.).
   • Never return a nested dictionary.
5. Use deliver once with NFiles=1 by default and appropriate dataset source(s).
6. Make sure that the layout of the data that will be returned is remembered - downstream tasks that want to work with the data will need to understand it.

Core Rules

• Prefer two top-level Select calls: collections first, output columns second.
• Filter objects with nested .Where; filter events with a top-level .Where.
• Use a single final Select that returns a dictionary of outputs.
• Do not use awkward functions inside ServiceX queries.
• Use dataset.Rucio for rucio DIDs and dataset.FileList for URL lists.
• Always set NFiles=1 in deliver by default.
• If a transform fails and logs are required, respond with HELP USER.
• Ensure func_adl_servicex_xaodr25 is listed as a dependency in the active project and installed in the current virtual environment before running or generating code that uses it.

References

• Load references/servicex-hints.md for overall ServiceX query patterns, best practices, and error handling, and template code.
• Load only the relevant xAOD data model topic file(s) to keep context small. Naming convention: references/datamodel-xaod-*.md.
• xAOD topics:
  • references/datamodel-xaod-units.md (standard ATLAS units (energy, etc))
  • references/datamodel-xaod-objects.md (jets, electrons, muons)
  • references/datamodel-xaod-tau.md
  • references/datamodel-xaod-missing-et.md
  • references/datamodel-xaod-tools-btagging.md
  • references/datamodel-xaod-event-weights.md
  • references/datamodel-xaod-tlorentzvector.md