LOW REST API

GET /subarrays

Returns the array configurations available

Status Codes:

  • 200 OK – Successful response with the list of array configurations.

GET /continuum/calculate

Calculate the sensitivity of an SKA LOW observation in continuum for the input parameters.

Query Parameters:

  • num_stations (number) – The number of LOW antenna stations

  • duration (number) – The duration of the observation in hours

  • pointing_centre (string) – Pointing centre in HH:MM:SS[.ss] DD:MM:SS[.ss]

  • freq_centre (number) – Central frequency in MHz

  • bandwidth_mhz (number) – Bandwidth for the continuum observation in MHz

Status Codes:

  • 200 OK – Successful response with the results of the sensitivity calculation.

  • 400 Bad Request – Request parameters failed validation, either against the OpenAPI spec or the domain specific validation,eg the spectral window not lying within the allowed range.

GET /{spectral_mode}/weighting

Compute the weighting correction factor to apply for an SKA LOW continuum observation

Parameters:

  • spectral_mode (string) – Calculator spectral mode

Query Parameters:

  • weighting_mode (string) – Weighting strategy used (Required)

  • robustness (number) – Robust parameter. Only required and considered if the weighting is set to robust.

  • subarray_configuration (string) – SKA LOW subarray configuration (Required)

  • pointing_centre (string) – Pointing centre in HH:MM:SS[.ss] DD:MM:SS[.ss] (Required)

  • freq_centre (number) – Central frequency in MHz (Required)

Status Codes:

  • 200 OK – Result of an image weighting calculation

  • 400 Bad Request – Request parameters failed validation, either against the OpenAPI spec or the domain specific validation,eg the spectral window not lying within the allowed range.

  • 5XX – An error occurred making the calculation

GET /zoom/calculate

Calculate the sensitivity of an SKA LOW observation in zoom mode for the input parameters.

Query Parameters:

  • num_stations (number) – The number of LOW antenna stations

  • duration (number) – The duration of the observation in hours

  • pointing_centre (string) – Pointing centre in HH:MM:SS[.ss] DD:MM:SS[.ss]

  • freq_centre (number) – Central frequency in MHz

  • spectral_resolution_hz (number) – Spectral resolution/channel width of the zoom window. The channel width of the narrowest zoom window is given by (781250 * 32/27)/(4096 * 16) = 14.129 Hz (rounded to 3 d.p.).

  • total_bandwidth_khz (number) – The total bandwidth of the zoom window in kHz. Smallest allowed value is the channel width given above multiplied by 1728 channels (~24.4 kHz). Maximum allowed value is 3125 kHz.

Status Codes:

  • 200 OK – Successful response with the results of the sensitivity calculation.

  • 400 Bad Request – Request parameters failed validation, either against the OpenAPI spec or the domain specific validation,eg the spectral window not lying within the allowed range.