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.connect(...) to keep a worker pool warm across many queries, and use materialize() to cache an intermediate join.
  • 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.