Data Query APIs

1. Search for FITS products

APIs:
http://pub023.cs.technik.fhnw.ch/query/fits/START_UTC/STOP_UTC
http://pub023.cs.technik.fhnw.ch/query/fits/START_UTC/STOP_UTC/PRODUCT_TYPE
Arguments
  • START_UTC and STOP_UTC

    • Data measurement start time and stop time.
    • Supported time formats:
      yyyy-dd-mmTHH:MM:SS, yyyyddmmHHMM, yyyydd, yyyyddmm, yyyy-dd, yyyy-dd-mm
  • PRODUCT_TYPE options:

    l0			 -  xray_l0_user,
    l1			 -  xray_l1_user,
    l2			 -  xray_l2_user,
    l3			 -  xray_l3_user, 
    spec			 -  spectrogram_user,
    
    asp			 -  aspect, 
    aspect			 -  aspect, 
    
    lc			 -  ql_light_curves,
    bkg			 -  ql_background, 
    var			 -  ql_variance, 
    ffl			 -  flareflag_location,
    cal			 -  calibration_spectrum,
    qlspec			 -  ql_spectrogram,
    
    hkmin			 -  hk_mini,
    hkmax			 - hk_maxi,
    hk			 -  all housekeeping products,
    ql			 -  all quicklook products,
    sci			 -  all science products,
    housekeeping		 -  the same as hk,
    quicklook		 -   the same as quicklook,
    science			 -  the same as sci
    				

Here are some examples:

Responses are JSON strings like:

[
{"url": http://pub023.cs.technik.fhnw.ch/download/fits/filename/solo_L1_stix-ql-spectrogram_20200609T150837__incomplete_00051.fits",
"time_range_utc": ["2020-06-09T13:08:37.133", "2020-06-10T13:47:01.077"], 
"raw_file_id": "294",
"creation_time": {"$date": 1595430303641}
}]
		

An URL to download the fits file is given in the JSON string. The server will return an empty JSON array if no fits file is found.

2. Download bulk science data

API
http://pub023.cs.technik.fhnw.ch/download/fits/bsd/DATA_REQ_UNIQUE_ID

DATA_REQ_UNIQUE_ID : bulk science data request unique ID

Example:
http://pub023.cs.technik.fhnw.ch/download/fits/bsd/1177882384

3. Calibration data query

3.1 Calibration run info query by ID

API

 http://pub023.cs.technik.fhnw.ch/query/fits/calibration/CALIBRATION_RUN_NUMBER

CALIBRATION_RUN_NUMBER is the calibration run number which can be found on the calibration data viewer web page.

Example:

http://pub023.cs.technik.fhnw.ch/query/fits/calibration/900

Response:

[ 
{ "calibration_run_id": 900, 
"raw_file_id":204,
"fits_filename":"solo_L1_stix-calibration-spectrum_20200519T003857__complete_03338.fits",
"fits_file_id":3338, "packet_start_id":635146,
"packet_end_id":635176, "is_complete":true,
"meas_start_utc":"2020-05-19T00:38:57.245",
"meas_end_utc":"2020-05-19T00:53:57.245",
"duration_seconds":900.0,
"fits_creation_time":{ "$date":1595458101975 } 
} ]
3.2 Calibration info query by fits file ID

JSON API

http://pub023.cs.technik.fhnw.ch/query/calibration/fits/FITS_FILE_ID

where FITS_FILE_ID is the last 5-digits of a fits file.

Example:

http://pub023.cs.technik.fhnw.ch/query/calibration/fits/3338

Response:

[{
"fits_file_id": 3338,
"calibration_run_id": 900,
"raw_file_id": 204,
"meas_start_utc": "2020-05-19T00:38:57.155", 
"duration_seconds": 900
}]

The last 5-digit number in the filename indicates its fits file ID.

4. ELUT download API

JSON API

http://pub023.cs.technik.fhnw.ch//request/calibration/elut/CALIBRATION_RUN_ID

Argument:

CALIBRATION_RUN_ID - calibration run number

5. STIX solar flare list

API

http://pub023.cs.technik.fhnw.ch/request/flares/FLARE_ID_BEGIN/FLARE_ID_END
Flare IDs can be found on the flare list web page.

6. Request solar orbiter locations

API

 http://pub023.cs.technik.fhnw.ch/get/solo/orbit/{start_utc}/{end_utc}

7. Python APIs

The source code and examples can be found at here