Difference between revisions of "Calibration Server"

From Gaia Science Alerts Working Group
Jump to navigationJump to search
Line 2: Line 2:
 
http://gaia020.ast.cam.ac.uk:5000/
 
http://gaia020.ast.cam.ac.uk:5000/
  
== Autorization ==
+
== Authorization ==
  
* In order to access the server you need a so called "hashtag" which is an autorization key. In order to get one you need to ask Lukasz Wyrzykowski and give him also
+
* In order to access the server you need a so called "hashtag" which is an authorization key. In order to get one you need to ask Lukasz Wyrzykowski and give him also
 
the lon,lat of your observatory and list of filters you have.
 
the lon,lat of your observatory and list of filters you have.
 
* If you have the hashtag, you can use the login form of the server to authorize yourself. Or if you are doing some scripting, you will need to specify hashtag option in the GET, POST requests.  
 
* If you have the hashtag, you can use the login form of the server to authorize yourself. Or if you are doing some scripting, you will need to specify hashtag option in the GET, POST requests.  

Revision as of 16:42, 30 August 2012

The main address of the server at the moment is: http://gaia020.ast.cam.ac.uk:5000/

Authorization

  • In order to access the server you need a so called "hashtag" which is an authorization key. In order to get one you need to ask Lukasz Wyrzykowski and give him also

the lon,lat of your observatory and list of filters you have.

  • If you have the hashtag, you can use the login form of the server to authorize yourself. Or if you are doing some scripting, you will need to specify hashtag option in the GET, POST requests.

Calibration of your photometric data

The main url for calibration of your sextractor catalogs is http://gaia020.ast.cam.ac.uk:5000/uploader/

You can also do that from the command line using HTTP POST protocol

curl -F matchDist=2 -F EventID='ivo://110610' -F sexCat="@path_to_your_sex_catalog;filename=test.cat" 
     -F "hashtag=XXXX" -F "MJD=2" -F "matchDist=2"
     -F  EventID='ivo://110610' -F expTime=1 -F noPlot=1
     -F forceFilter=no -F dryRun=1 -F outputFormat=json "http://gaia020.ast.cam.ac.uk:5000/cgi/upload"

Parameters of the http://gaia020.ast.cam.ac.uk:5000/cgi/upload

  • matchDist -- matching radius in arcseconds
  • hashtag -- your authorization key
  • MJD -- mjd of the observations
  • expTime -- exposure time
  • comment -- comments
  • EventID -- the ivorn of the alert
  • dryRun -- the value of 1 allows you to check the results of the calibration without inserting anything into our DB
  • forceFilter -- "no" means that the calibration will be fully automated. But You can also specify APASS/V if you want to calibrate using a particular survey/filter
  • sexCat -- that's the Sextractor catalog you are trying to submit
  • outputFormat -- at the moment the only allowed values are json and html

It is important that you can upload the data for the alerts which are in the database (e.g. which are listed here http://gaia020.ast.cam.ac.uk:5000/list_of_alerts ). If the alert is not in our DB, you can insert it http://gaia020.ast.cam.ac.uk:5000/newevent/

The allowed formats for the sextractor catalogs are plain ascii and FITS. Obviously those catalogs must contain RA, DEC and MAG columns.

Review of the data in the Database

You can view the list of followup_data which are in the DB http://gaia020.ast.cam.ac.uk:5000/list_of_followups

You can view the list of alerts which are in the DB http://gaia020.ast.cam.ac.uk:5000/list_of_alerts , and the subset of them which have followup data http://gaia020.ast.cam.ac.uk:5000/list_of_alerts?observed_only=1. From these pages you can also see the light curves for those alerts which do have followup data. Here is the example of the light curve: http://gaia020.ast.cam.ac.uk:5000/get_alert_lc?alert_id=2999

Source code

The calibration server is written in python using Flask framework. If you'd like to help/implement something, ask Sergey Koposov for the access to the git repository on http://bitbucket.org