Crossmatch Skill

Cross-match detected astronomical sources against radio source catalogs using Python scripts.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/dsa110/dsa110-contimg --skill crossmatch-skill
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: Crossmatch Skill
Source: https://github.com/dsa110/dsa110-contimg/tree/main/backend/.github/skills/crossmatch
Command: npx skills add https://github.com/dsa110/dsa110-contimg --skill crossmatch-skill

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

This Skill automates the crucial process of matching detected astronomical sources in images with known cataloged sources, enabling source identification, astrometry correction, and flux scale validation.

Core Features & Use Cases

  • Source Matching: Compares detected sources against reference catalogs (NVSS, FIRST, RACS).
  • Astrometry Correction: Corrects image positions based on matched catalog sources.
  • Flux Scale Correction: Adjusts detected source fluxes to match catalog values.
  • Use Case: After imaging a region of the sky, use this Skill to identify which detected radio sources correspond to known cataloged objects, and to correct any positional or flux discrepancies.

Quick Start

Use the crossmatch skill to match detected sources in '/data/image.fits' against the NVSS catalog.

Frequently Asked Questions about Crossmatch Skill

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

FAQPage Schema
How do I crossmatch detected radio sources with established catalogs for astrometry correction?

Astronomical source cross-matching compares detected sources in image data against reference catalogs like NVSS, FIRST, or RACS. It calculates positional offsets between matched pairs, enabling you to correct astrometry in radio continuum imaging pipelines.

Can I match sources from an image file against multiple radio astronomy catalogs at once?

Multi-catalog matching supports comparing detected sources against several reference catalogs simultaneously. The Skill utilizes Python scripts to execute nearest neighbor and all matches algorithms, providing matched pairs, unmatched sources, and positional offsets as outputs.

What is the best way to validate detected source flux scales against known catalog values?

Flux scale correction validates detected source fluxes by comparing them to established catalog values. The Skill calculates flux scale ratios from matched sources, allowing you to adjust and align your detected source fluxes with known reference catalog measurements.

Does this source matching approach work with standard radio continuum imaging pipelines?

Source cross-matching is designed to facilitate astrometric and flux scale corrections for radio continuum imaging pipelines. It processes image data to identify known cataloged objects and outputs matched pairs alongside unmatched sources for pipeline integration.

What outputs do I get when crossmatching astronomical sources with reference catalogs?

Crossmatching outputs include matched source pairs, unmatched detected sources, positional offsets, and flux scale ratios. These results enable source identification, astrometry correction, and flux scale validation for your radio imaging data.

When should I use nearest neighbor matching versus all matches for catalog matching?

Nearest neighbor matching identifies the closest catalog source for each detection, while all matches retrieves every potential counterpart. Choose nearest neighbor for straightforward source identification, or all matches to analyze complex regions with multiple nearby cataloged objects.