NuSpaceSim Logo Black

nuSpaceSim Documentation


This is the public release of the nuspacesim simulator tool!

This package simulates upward-going electromagnetic air showers caused by neutrino interactions with the atmosphere. It calculates the tau neutrino acceptance for the Optical Cherenkov technique. The simulation is parameterized by an input TOML configuration file, with settings for detector characteristics and global parameters. The package also provides a python3 API for programatic access.

Tau propagation is interpolated using included data tables from nuPyProp.

The source code repository is available on GitHub.

Please provide feedback, bug reports, and feature requests through our public Issue Tracker.


New to νSpaceSim? Check out the Quickstart guide for help installing and navigating the package.


The user guide provides in-depth information on the key concepts of nuSpaceSim with useful background information and explanation.

API reference

The reference guide contains a detailed description of the how the methods work and which parameters can be used.

Developer guide

Need to modify or build nuSpaceSim from source? Understand the testing pipeline? Developer guides are here for you!