the engine behind the marshall webapp.

Documentation for marshallEngine is hosted by Read the Docs ( development version and master version). The code lives on github. Please report any issues you find here.

API Reference



common tools used throughout package


Import codes for the various transients surveys that ‘feed’ the marshall inbox


import code for the panstarrs survey


import code for the panstarrs survey


import code for the panstarrs survey


import code for the panstarrs survey


import code for the panstarrs survey


import code for the panstarrs survey


Housekeeping and bookkeeping actions for the marshall database


Lightcurve plotting for the Marshall

small services and tools for the marhall


Generate the force-photometry lightcurves for ATLAS sources found in the marshall database


Unit testing tools


Import the atels transient data into the marshall database


cacher for the atels image stamps

Import the ATLAS transient data into the marshall database


cacher for the ATLAS image stamps

This baseclass for the feeder survey data imports


The base class for the feeder image cachers

Import the PanSTARRS transient data into the marshall database


cacher for the panstarrs image stamps

Import the tns transient data into the marshall database


cacher for the tns image stamps

Import the useradded transient data into the marshall database


cacher for the useradded image stamps

Import the ZTF transient data into the marshall database


cacher for the ZTF image stamps


Update the transient summaries table in the marshall database


The worker class for the marshall_lightcurves module

The worker class for the panstarrs_location_stamps module



Get the root path for this python package


generate all atlas FP lightcurves (clipped and stacked)




plot single result


clean up rouge data from the files by performing some basic clipping


stack the photometry for the given temporal range

Marshall Engine Release Notes

adding tns-marker into the TNS search requests

v1.0.9 - May 7, 2021

  • REFACTOR: resurrection code optimised to resurface a few more objects

  • REFACTOR: some MySQL queries rewritten and table indexes added to optimise common queries

  • REFACTOR: ATLAS forced photometry plotting code refactored to bring plots in-line with those produced by ATLAS forced photometry server. Biggest improvement is the more robust clipping of outlying data points.

v1.0.8 - March 17, 2021

  • REFACTOR: Occasional check to make sure all akas are set (i.e. more than just for transients discovered in the last 3 weeks).

  • FIXED: Links to the ASASSN Sky Patrol now added to all TNS reported ASASSN transient names (credentials discoverable in hover-over tool-tip)

  • FIXED: ATel comments where getting added correctly to associated object but ticket “ATel” drop-up menu was missing some ATel links occasionally.

v1.0.7 - February 20, 2021

  • ENHANCEMENT: Added cleanup function at end of ingests so objects appear in inbox quicker and akas are updated more frequently

  • REFACTORING: Reduced the crossmatch radius from 7 to 4 arcsec (it is easier to merge than split transients later on)

v1.0.6 - January 29, 2021

  • FEATURE: match transients to astronotes (not yet visualised in the webapp)

  • ENHANCEMENT: HTM indexing added the transientBucketSummaries table so we can spatially crossmatch

v1.0.5 - January 13, 2021

  • REFACTORING: atel parsing and matching within the marshall database now upgraded

v1.0.4 - January 11, 2021

  • REFACTORING: some database schema changes for latest version of Sherlock to run.

  • FIXED: added a function to recalculate sherlock original radii for merged sources. Fixes webapp visualisation.

  • FIXED: reduced number of ATLAS LC to be generated in a single batch.

v1.0.3 - December 10, 2020

  • REFACTORING: reading settings from marshall config folder instead of marshallEngine

  • FIXED: the save location of lightcurve files was resulting in files not being found in webapp

v1.0.2 - November 14, 2020

  • feature PS2 survey added as a new import (discoveries, lightcurves and stamps)

v1.0.1 - October 20, 2020

  • REFACTORING: added time filtering on ATLAS summary CSV file (thanks Ken)

  • FIXED: small fix to panstamp location map downloader

v1.0.0 - May 28, 2020

  • Now compatible with Python 3.* *