Skip to content

Tutorials

End-to-end walkthroughs that take you from a fresh install to a real science task. Read these in order if you're new to acid.

  • Your first crossmatch — a notebook. Download Gaia DR3 and 2MASS subsets, crossmatch them in a few lines of SQL, look at the result, and plot a magnitude diagram.
  • An interactive EDA session — a notebook. Use acid.open(...) / acid.sql.query(...) to keep one worker pool warm across many queries, and Catalog.save(...) to cache an intermediate join as a re-openable HATS catalog.
  • Building a pipeline — a prose walkthrough. Drop the Python, drive acid from the command line, and produce a nightly crossmatch table.

If you want focused recipes instead of a story, jump to the Cookbook.