lccserver 0.0.1.post0.dev21

A light curve collection server framework.

LCC-Server: A light curve collection server framework

This is a Python framework to serve collections of light curves. The code here forms the basis for the HAT data server.

At the moment, it includes the following functionality:

• collection of light curves from various projects into a single output format

• HTTP API for searching over multiple light curve collections by:

  • filtering on database columns of object properties, e.g. objectid, mag, variability type, variability indices, etc.
  • cone-search near specified coordinates
  • cross-matching to uploaded object list with objectid, ra, decl
  • full-text search on object names, descriptions, etc.

• HTTP API for generating datasets from search results asychronously, caching results from searches, and generating output zip bundles containing search results and all matching light curves

• HTTP API for detailed information per object, including light curve plots, external catalog info, and period-finding results plus phased LCs if available

Installation

NOTE: Python >= 3.6 is required. Use of a virtualenv is recommended; something like this will work well:

$ python3 -m venv lcc
$ source lcc/bin/activate

This package is available on PyPI. Install it with the virtualenv activated:

$ pip install numpy  # to set up Fortran bindings for dependencies
$ pip install lccserver  # add --pre to install unstable versions

To install the latest version from Github:

$ git clone https://github.com/waqasbhatti/lcc-server
$ cd lcc-server
$ pip install -e .

If you're on Linux or MacOS, you can install the uvloop package to optionally speed up some of the eventloop bits:

$ pip install uvloop

Some post-installation setup is required to begin serving light curves. In particular, you will need to set up a base directory where LCC-Server can work from and various sub-directories. Notes on this TBD...

License

LCC-Server is provided under the MIT License. See the LICENSE file for the full text.