Marmots (Multiple Antenna Arrays on Mountains Tau Sensitivity) is a suite of tools used to calculate the tau point-source sensitivity of the Beamforming Elevated Array for Cosmic Neutrinos (BEACON).
To install marmots, you will need git, git-lfs, and Python >= 3.6. All three should be available in the package manager of any modern OS. It is tested on macOS 10.14, ubuntu 18.04, ubuntu 16.04, Fedora 29, and Fedora 30.
The below instructions are assuming that python refers to Python 3.*. If python still refers to a decrepit Python 2.*, please replace python with python3 and pip with pip3.
The recommended method of installation is to first clone the package
$ git clone https://github.com/azeolla/marmots.git
To run marmots, you will need to extract the data files:
$ cd marmots
$ tar -xvzf data.tar.gz
You can then install using pip:
$ pip install --user -e .
Once the data files are installed, you can verify that the installation was successful by trying to import marmots
$ python -c 'import marmots'
To calculate the acceptance of BEACON at different energies and configurations, use the skymap script that was installed onto your PATH (or under marmots/scripts/skymap).
$ skymap -h
will print useful documentation. The argument "--stations" should be point to a text file containing 5 columns: latitude (degrees), longitude (degrees), altitude (km), orientation (degrees relative to geographic east), field-of-view (degrees), and number of phased antennas. The "--nside" argument should be a power of 2 and specifies the resolution of the skymap. nside=16 corresponds to a skymap of 3,072 pixels (# of pixels = 12 * nside**2).
As an example, to calculate the instantaneous effective area of 100 BEACON stations to 1 EeV neutrinos using 100,000 Monte Carlo trials per pixel, run:
$ skymap --nside 16 --Enu 1 --model prototype --ntrials 100_000 --stations /../stations_example.txt