Skip to content

lukeshingles/atlasserver

Folders and files

NameName
Last commit message
Last commit date

Latest commit

4c0d396 · Jan 31, 2025
Dec 5, 2024
Mar 4, 2024
Jan 30, 2025
Jan 31, 2025
Sep 6, 2022
May 4, 2021
Nov 10, 2023
Dec 3, 2024
Nov 5, 2024
Dec 5, 2024
Mar 14, 2024
Sep 2, 2022
Mar 14, 2024
Mar 3, 2022
Dec 3, 2020
Mar 4, 2024
Jan 30, 2025
May 9, 2024

Repository files navigation

atlasserver

https://fallingstar-data.com/forcedphot/

This is the source code for the ATLAS Forced Photometry Server, a Python Django Rest Framework server with a React frontend.

The ATLAS forced photometry server provides public access to photometric measurements over the full history of the ATLAS survey. After registration, a user can request forced photometry at any position on the sky either for a single position or a list of positions.

Why is the source code available?

The code is available for educational purposes, identification of security issues, and for curious users of the ATLAS Forced Photometry service. Pull requests are also welcome.

For ATLAS server administrators

The package should be installed in develop mode from the Git repository.

git clone https://github.com/lukeshingles/atlasserver.git
python3 -m pip install -e .

Copy dotenv_example.txt to .env and edit the relevant sections.

cp dotenv_example.txt .env

Then download the geoip database files with your MaxMind API key (stored in .env).

./update_geoipdatabase.sh

A MySQL or MariaDB server and tmux are required. These can be installed with homebrew on macOS:

brew install mariadb tmux

To initialise a new database, run:

./manage.py makemigrations
./manage.py migrate

Two processes must be running: the web server and the task runner. These can be started with:

atlaswebserver start
atlastaskrunner start

For atlastaskrunner to process jobs, there much be an SSH host alias named named 'atlas' that points to atlas-base-sc01.ifa.hawaii.edu with your username. The server-side scripts must also be installed in your sc01 home folder:

scp atlasserver/taskrunner/atlas_*.py atlas:~/

To update the code to the latest commit on the main branch, pull from the GitHub remote and then restart the two processes.

git pull
atlaswebserver restart
atlastaskrunner restart

License

Copyright (c) 2020-2024 Luke Shingles
Distributed under the MIT license. See LICENSE for more information.