servicex

Build and optimize ServiceX func_adl queries for ATLAS xAOD datasets.

Updated Dec 23, 2025
One-click install
npx skills add https://github.com/gordonwatts/skill-test --skill servicex
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: servicex
Source: https://github.com/gordonwatts/skill-test/tree/main/.codex/skills/servicex
Command: npx skills add https://github.com/gordonwatts/skill-test --skill servicex

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes assets (resource) and references (resource) components.

What problem does it solve?

ServiceX query construction for ATLAS xAOD data (PHYSLITE/PHYS) often requires careful dataset selection, object and event filtering, and delivering results in a consistent structure. This Skill provides concise patterns, best practices, and practical references to speed up development and debugging.

Core Features & Use Cases

  • Guidance on building top-level Selects for collections and singletons, applying nested Where filters, and producing a single dictionary of outputs.
  • Step-by-step workflow examples for PHYSLITE and PHYS OpenData datasets, including how to classify datasets, choose appropriate queries, and handle unit conversions.
  • Reusable snippets and references to xAOD data models, hints for common pitfalls, and a ready-to-adapt end-to-end example.

Quick Start

Create a minimal ServiceX query against a PHYSLITE dataset to fetch Jet pT using FuncADLQueryPHYSLITE and deliver the results.

Frequently Asked Questions about servicex

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I build a ServiceX query for ATLAS xAOD datasets?

Build ServiceX queries against ATLAS xAOD data by enforcing two-stage top-level Select patterns for collections and singletons, applying nested Where filters, and producing a single final dictionary output.

What is the best way to fetch jets from PHYSLITE using func_adl?

Fetching jets from PHYSLITE using func_adl involves using FuncADLQueryPHYSLITE, applying unit normalization, and classifying the dataset correctly to ensure deterministic delivery of physics analysis results.

Does ServiceX func_adl support both PHYSLITE and PHYS OpenData datasets?

ServiceX func_adl supports both PHYSLITE and PHYS OpenData datasets, providing step-by-step workflow examples to classify datasets, choose appropriate queries, and handle unit conversions for physics analysis.

Why does my func_adl query return inconsistent output structures?

Inconsistent func_adl query output often results from not enforcing a single final dictionary output or skipping two-stage top-level Select patterns, which are required for deterministic delivery of xAOD analysis results.

How do I apply event and object filtering in xAOD func_adl queries?

Apply object and event filtering in xAOD func_adl queries by using nested Where clauses within the top-level Select statements to refine physics analysis collections before producing the final output dictionary.