pyobs-archive

A webservice for an archive for astronomical images. Implements most of the interfaces defined by Las Cumbres Observatory.

Quick start

Create a docker-compose.yaml:

version: '3'

services:
  db:
    image: postgres
    volumes:
      - pgdata:/var/lib/postgresql/data
  web:
    image: thusser/pyobs-archive
    command: gunicorn --bind 0.0.0.0:8000 pyobs_archive.wsgi
    ports:
      - "8000:8000"
    volumes:
      - data:/data/
    depends_on:
      - db
volumes:
  pgdata:

Adapt ports and volumes to your needs. Run the containers:

docker-compose up -d

After it is running, get a shell inside the container:

docker exec -it pyobs-archive_web_1 /bin/bash

Inside, run migrate:

python manage.py migrate

And create a superuser for yourself:

python manage.py createsuperuser

Create another user for ingesting new images (in this case, we call it "pyobs") and create the token that must be used when sending new images:

python manager.py createsuperuser
python manage.py drf_create_token pyobs

Now you can open a browser at http://localhost:8000/ and log in to the homepage.

Development environment

For development, it might be easier to not use Docker. In that case, create a pyobs_archive/local_settings.py and override settings in the settings.py, like this:

import os

# Build paths inside the project like this: os.path.join(BASE_DIR, ...)
BASE_DIR = os.path.dirname(os.path.dirname(os.path.abspath(__file__)))

DATABASES = {
    'default': {
        'ENGINE': 'django.db.backends.sqlite3',
        'NAME': os.path.join(BASE_DIR, 'db.sqlite3'),
    }
}

ARCHIVE_ROOT = '/opt/pyobs/data/'
PATH_FORMATTER = '{SITEID}/{TELID}/{INSTRUME}/'
FILENAME_FORMATTER = None,

Changelog

version 1.0.0 (2020-11-23)

• Initial release

version 1.1.0 (2020-12-04)

• Added footer to page

version 1.1.1 (2020-12-10)

• Minor bugfix

Used packages

The following packages are used in this project.

Python:

• django for the whole project.
• django REST framework for the web API.
• astropy for astronomical calculations.
• gunicorn for running the web server.

JavaScript, CSS & Co.:

• jQuery for DOM access.
• jQuery.fileDownload for downloading files.
• jQuery.typeWatch for handling user input.
• Bootstrap for the UI.
• Bootstrap Table for showing the data as table.
• Font Awesome for icons.
• webpack for bundling all resources.

Thanks

Thanks to all the people at LCO for their support. This project also uses some JavaScript from their archive.