OTTER API

Open mulTiwavelength Transient Event Repository

A Python API for the OTTER.

Installation

To install the OTTER API use

python3 -m pip install astro-otter[standard]

Developer Instructions

1. Set the OTTER_ROOT environment variable

   export OTTER_ROOT=/path/to/where/to/clone
   

2. Clone the relevant repos:

   git clone https://github.com/astro-otter/otter.git $OTTER_ROOT/otter
   git clone https://github.com/astro-otter/otterdb.git $OTTER_ROOT/otterdb
   git clone https://github.com/astro-otter/otter-web.git $OTTER_ROOT/otter-web
   

3. Install the NASA ADS Python API by following the instructions at https://ads.readthedocs.io/en/latest/#getting-started
4. Install otter, the API for this database. From the root directory where you installed these repos:

   cd $OTTER_ROOT/otter
   python -m pip install -e .
   

5. Process the data to build the local copy of the database. Follow the instructions in the otterdb repo README.
6. Easily access the data using the Otter code! In python:

import os
from otter import Otter
otter = Otter(os.path.join(os.environ['OTTER_ROOT'], 'otterdb', '.otter'))
res = otter.query(names='AT2018hyz')
print(res)

Installation from Source

To install the OTTER API from the source code use

git clone https://github.com/astro-otter/otter.git
cd otter
python -m pip install .

This will be changed into the more convenient python -m pip install astro-otter at a later date!

For developers, please also enable the pre-commit hooks using

pre-commit install

Repo Organization