uplim

ART-XC upper limits django application

Management commands

• load_survey

Allows to populate the database with data for a survey in healpix format. Takes about 100 minutes for an nside=4096 map to load using sqlite. Supports resuming after interruption.

Syntax: python manage.py load_survey --counts='path_to_counts_map' --exposure='path_to_exposure_map' --survey_number=integer survey number --batch_size=number of pixels to insert in one transaction

• set_contaminated

Load catalog.dat catalog into the database or update it. Set the contamination flag based on the catalog of sources (catalog.dat file). Includes a --reset option to reset the flag to False on all pixels.

Syntax: python manage.py set_contaminated --catalog='path to catalog.dat'

Models (models.py)

• Pixel:
  • survey number
  • hpid (healpix pixel id)
  • counts
  • exposure
  • contamination flag

Views (views.py)

• PixelAggregateView: For testing, outputs the aggregated data across specified surveys for a healpix pixel.

  Returns: Sum of counts and exposure over specified surveys for the specified pixel.

     /api/pixel-aggregate/?pixel=123&survey=1
  
     (/api/pixel-aggregate/?pixel=123&survey=1,3,5)
  
     (/api/pixel-aggregate/?pixel=123&survey=1-5)
  

• UpperLimitView: The view providing upper limit calculation.

  Returns: Upper and lower limits in units of counts, count rate, and physical flux for Bayesian and classic approaches, as well as a count rate estimate and aperture photometry data (counts in the aperture, background estimate, etc). Also whether or not the apertures contain any pixels marked as contaminated, as well as a list of nearby sources.

  URL: /api/upper-limit/?ra=10.0&dec=10.0&cl=.95&survey=1 (or list 1,3,5 or hyphenated range 1-5).