Tutorials & Examples

Learn how to use asimov and its ecosystem with step-by-step tutorials and practical examples.

Getting Started

Installing asimov

Learn how to install asimov and set up your analysis environment.

pip install asimov

For more detailed installation instructions, including development installations and dependencies, see the documentation.

Your First Analysis

A step-by-step guide to running your first gravitational-wave parameter estimation with asimov.

Coming soon! This tutorial will walk you through:

  • Setting up a basic analysis configuration
  • Selecting a pipeline (bilby, PyCBC, etc.)
  • Running the analysis
  • Interpreting the results

Pipeline-Specific Tutorials

Using asimov with bilby

Learn how to configure and run analyses using the bilby inference library.

Topics covered:

  • bilby configuration options
  • Prior selection and customization
  • Sampler settings
  • Result visualization

Using asimov with PyCBC

Interface with PyCBC through asimov-pycbc for parameter estimation.

Learn about:

  • Installing and configuring asimov-pycbc
  • PyCBC-specific settings
  • Working with PyCBC templates
  • Post-processing results

View asimov-pycbc on GitHub →

Using asimov with cogwheel

Leverage cogwheel's efficient likelihood calculations through asimov.

Learn about:

  • Installing and configuring asimov-cogwheel
  • cogwheel's relative binning approach
  • Optimizing performance
  • Interpreting results

View asimov-cogwheel on GitHub →

Advanced Topics

Managing Data with asimov-gwdata

Efficiently handle gravitational-wave data in your analyses.

Topics:

  • Data discovery and download
  • Data quality checks
  • Cache management
  • Working with strain data

View asimov-gwdata on GitHub →

Reproducible Workflows

Best practices for creating reproducible gravitational-wave analyses.

Learn about:

  • Version control for analysis configurations
  • Environment management
  • Documentation standards
  • Sharing results and code

Comparing Pipeline Results

Use asimov to run the same analysis across multiple pipelines and compare results.

Topics:

  • Setting up multi-pipeline analyses
  • Standardizing configurations
  • Result comparison tools
  • Understanding systematic differences

Need Help?

Can't find what you're looking for? Check out the documentation or reach out to the community.