finding-data-sam

Query the Mu2e SAM data catalog to find datasets, files, and initiate prestaging.

4|Updated Feb 11, 2026
One-click install
npx skills add https://github.com/Mu2e/aitools --skill finding-data-sam
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: finding-data-sam
Source: https://github.com/Mu2e/aitools/tree/main/skills/finding-data-sam
Command: npx skills add https://github.com/Mu2e/aitools --skill finding-data-sam

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill provides guidance and tools to efficiently locate, query, and manage Mu2e data stored within the SAM (Sequential Access to Metadata) system.

Core Features & Use Cases

  • Data Discovery: Browse and search for datasets and files using various criteria.
  • File Location: Determine where files are stored (disk or tape) and retrieve their paths.
  • Data Management: Understand dataset concepts, create custom selections, and manage snapshots.
  • Tape Operations: Initiate prestaging of files from tape to disk for faster access.
  • Workflow Integration: Learn how to use SAM with grid job submission tools like jobsub.
  • Use Case: You need to find all simulation files generated with a specific beam configuration from a particular run range. This Skill helps you construct the correct samweb query to identify and list these files.

Quick Start

Use the finding-data-sam skill to list all files belonging to the dataset 'sim.mu2e.example-beam-g4s1.1812a.art'.

Frequently Asked Questions about finding-data-sam

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

FAQPage Schema
How do I query Mu2e SAM data catalog to find specific simulation files?

You can query the Mu2e SAM data catalog using samweb commands to discover files by constructing dataset queries with specific criteria like beam configuration and run range. This Skill provides command-line examples for building those queries.

What is the best way to locate file paths stored on disk or tape in the SAM system?

The SAM system tracks file locations on disk or tape. You can use samweb commands provided by this Skill to determine storage status and retrieve exact file paths for your datasets.

How do I prestaging files from tape to disk for faster Mu2e data access?

Prestaging files from tape to disk in SAM is done by initiating prestaging operations through specific samweb commands. This Skill outlines the process to move your required dataset files to disk for faster access.

Can I use SAM dataset queries with grid job submission workflows like jobsub?

Yes, SAM dataset queries integrate with grid job submission tools like jobsub. This Skill explains how to incorporate your SAM data selections and file locations into grid job submission workflows.

How do I create custom data selections and manage snapshots in SAM?

Creating custom data selections and managing snapshots in SAM involves using samweb commands to define specific dataset criteria. This Skill guides you through dataset concepts and the commands needed for custom selections.