lcls-catalog

Query LCLS experiment metadata in Parquet snapshots using lcat.

Updated Jan 27, 2026
One-click install
npx skills add https://github.com/carbonscott/deploy-opencode --skill lcls-catalog
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: lcls-catalog
Source: https://github.com/carbonscott/deploy-opencode/tree/main/claude/skills/lcls-catalog
Command: npx skills add https://github.com/carbonscott/deploy-opencode --skill lcls-catalog

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Browse and search LCLS experiment data metadata stored as Parquet snapshots using the lcls-catalog CLI, enabling faster discovery and analysis of experiments.

Core Features & Use Cases

  • Browsing and searching metadata with lcat across Parquet snapshots.
  • SQL-based querying for flexible filtering and aggregation.
  • Quick access to catalog statistics, file paths, and experiment structure.

Quick Start

Source the env.sh script and run lcat to retrieve metadata.

Frequently Asked Questions about lcls-catalog

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

FAQPage Schema
How do I query LCLS experiment metadata stored in Parquet files?

You can query LCLS experiment metadata stored in Parquet files by running the lcls-catalog CLI, which supports SQL-based querying for flexible filtering and aggregation across snapshots.

What is the best way to browse experiment data across different hutches?

The best way to browse experiment data across hutches is using the lcat tool's tree and ls commands, which provide quick access to the experiment structure and file paths stored in the catalog.

How do I get catalog statistics for my LCLS experiment data?

You can retrieve catalog statistics for LCLS experiment data by running the lcat stats command after sourcing the env.sh script in your environment.

Do I need to source env.sh before running lcat commands?

Yes, you must source the env.sh script before running lcat to ensure the necessary environment variables are configured for browsing and querying Parquet snapshots.

Can I use SQL to filter and aggregate LCLS metadata snapshots?

Yes, the lcls-catalog tool provides SQL-based querying over metadata, allowing you to flexibly filter and aggregate experiment files stored as Parquet snapshots across hutches and experiments.

What commands are available for navigating LCLS experiment files?

Available commands for navigating LCLS experiment files include stats, find, query, ls, tree, snapshots, consolidate, and snapshot for locating and analyzing metadata.