Skip to main content

A light curve collection server framework.

Project description

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.

LCC server search interface

  • 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

LCC server results display

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

LCC server object info


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
$ 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

Using the server

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.

To make this process easier, there's an interactive CLI available when you install LCC-Server. This will be in your $PATH as lcc-server.

A Jupyter notebook walkthough using this CLI to stand up an LCC-Server instance, with example light curves, can be found in the astrobase-notebooks repo: lcc-server-setup.ipynb (Jupyter nbviewer link).

These docs are automatically generated from the server-docs directory in the git repository.


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

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Filename, size & hash SHA256 hash help File type Python version Upload date
lccserver-0.1.4-py3-none-any.whl (6.8 MB) Copy SHA256 hash SHA256 Wheel py3
lccserver-0.1.4.tar.gz (6.4 MB) Copy SHA256 hash SHA256 Source None

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN SignalFx SignalFx Supporter DigiCert DigiCert EV certificate StatusPage StatusPage Status page