LOW REST API
These docs are generated from the OpenAPI specification for the application. There is an issue with the RTD plugin which means the response types are not rendered. To see the API response bodies for the status codes listed below see the Swagger UI: https://k8s.stfc.skao.int/integration-ska-ost-senscalc-ui/api_doc/
- 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.