CSP configure 5.0
JSON schema and example for CSP Low configure
LOWCSP configure 5.0
Example (TMC input for CBF 0.2 science_a visibility scan)
{
"interface": "https://schema.skao.int/ska-low-csp-configure/5.0",
"transaction_id": "txn-....-00001",
"subarray": {
"subarray_name": "science period 23"
},
"common": {
"config_id": "sbi-mvp01-20200325-00001-science_A",
"subarray_id": 1,
"eb_id": "eb-x449-20231105-34696"
},
"lowcbf": {
"stations": {
"stns": [
[1, 1],
[2, 1],
[3, 1],
[4, 1],
[5, 1],
[6, 1]
],
"stn_beams": [{
"beam_id": 1,
"freq_ids": [400],
"delay_poly": "tango://delays.skao.int/low/stn-beam/1"
}]
},
"vis": {
"fsp": {
"firmware": "vis",
"fsp_ids": [1]
},
"stn_beams": [{
"stn_beam_id": 1,
"host": [
[0, "192.168.1.00"]
],
"port": [
[0, 9000, 1]
],
"mac": [
[0, "02-03-04-0a-0b-0c"]
],
"integration_ms": 849
}]
}
}
}
Example (CSP configuration for CBF 0.2, PST 3.0 using pulsar timing scan)
{
"interface": "https://schema.skao.int/ska-low-csp-configure/5.0",
"transaction_id": "txn-....-00001",
"subarray": {
"subarray_name": "science period 23"
},
"common": {
"config_id": "sbi-mvp01-20200325-00001-science_A",
"subarray_id": 1,
"eb_id": "eb-x449-20231105-34696"
},
"lowcbf": {
"stations": {
"stns": [
[1, 1],
[2, 1],
[3, 1],
[4, 1],
[5, 1],
[6, 1]
],
"stn_beams": [{
"beam_id": 1,
"freq_ids": [400],
"delay_poly": "tango://delays.skao.int/low/stn-beam/1"
}]
},
"vis": {
"fsp": {
"firmware": "vis",
"fsp_ids": [1]
},
"stn_beams": [{
"stn_beam_id": 1,
"host": [
[0, "192.168.1.00"]
],
"port": [
[0, 9000, 1]
],
"mac": [
[0, "02-03-04-0a-0b-0c"]
],
"integration_ms": 849
}]
},
"timing_beams": {
"fsp": {
"firmware": "pst",
"fsp_ids": [2]
},
"beams": [{
"pst_beam_id": 1,
"stn_beam_id": 1,
"stn_weights": [0.9, 1.0, 1.0, 1.0, 0.9, 1.0],
"delay_poly": "tango://delays.skao.int/low/stn-beam/1",
"jones": "tango://jones.skao.int/low/stn-beam/1"
}]
}
},
"pst": {
"beams": [{
"beam_id": 1,
"scan": {
"centre_frequency": 100000000.0,
"total_bandwidth": 1562500.0,
"observer_id": "jdoe",
"project_id": "project1",
"receiver_id": "receiver3",
"max_scan_length": 20000.0,
"subint_duration": 30.0,
"receptors": ["SKA001", "SKA036"],
"receptor_weights": [0.4, 0.6],
"pst_processing_mode": "PULSAR_TIMING",
"delay_centre": [5109360.133, 2006852.586, -3238948.127],
"target": {
"target_name": "J1921+2153",
"reference_frame": "icrs",
"attrs": {
"c1": 290.43672917,
"c2": 21.884,
"epoch": 2000.0
}
},
"pt": {
"dispersion_measure": 100.0,
"rotation_measure": 0.0,
"ephemeris": "",
"pulsar_phase_predictor": "",
"output_frequency_channels": 1,
"output_phase_bins": 64,
"num_sk_config": 1,
"sk_config": [{
"sk_range": [0.8, 0.9],
"sk_integration_limit": 100,
"sk_excision_limit": 25.0
}],
"target_snr": 0.0
}
}
}]
}
}
Example (CSP configuration for CBF 0.2, PST 3.0 using flow through scan)
{
"interface": "https://schema.skao.int/ska-low-csp-configure/5.0",
"transaction_id": "txn-....-00001",
"subarray": {
"subarray_name": "science period 23"
},
"common": {
"config_id": "sbi-mvp01-20200325-00001-science_A",
"subarray_id": 1,
"eb_id": "eb-x449-20231105-34696"
},
"lowcbf": {
"stations": {
"stns": [
[1, 1],
[2, 1],
[3, 1],
[4, 1],
[5, 1],
[6, 1]
],
"stn_beams": [{
"beam_id": 1,
"freq_ids": [400],
"delay_poly": "tango://delays.skao.int/low/stn-beam/1"
}]
},
"vis": {
"fsp": {
"firmware": "vis",
"fsp_ids": [1]
},
"stn_beams": [{
"stn_beam_id": 1,
"host": [
[0, "192.168.1.00"]
],
"port": [
[0, 9000, 1]
],
"mac": [
[0, "02-03-04-0a-0b-0c"]
],
"integration_ms": 849
}]
},
"timing_beams": {
"fsp": {
"firmware": "pst",
"fsp_ids": [2]
},
"beams": [{
"pst_beam_id": 1,
"stn_beam_id": 1,
"stn_weights": [0.9, 1.0, 1.0, 1.0, 0.9, 1.0],
"delay_poly": "tango://delays.skao.int/low/stn-beam/1",
"jones": "tango://jones.skao.int/low/stn-beam/1"
}]
}
},
"pst": {
"beams": [{
"beam_id": 1,
"scan": {
"centre_frequency": 100000000.0,
"total_bandwidth": 1562500.0,
"observer_id": "jdoe",
"project_id": "project1",
"receiver_id": "receiver3",
"max_scan_length": 20000.0,
"subint_duration": 30.0,
"receptors": ["SKA001", "SKA036"],
"receptor_weights": [0.4, 0.6],
"pst_processing_mode": "FLOW_THROUGH",
"delay_centre": [5109360.133, 2006852.586, -3238948.127],
"target": {
"target_name": "J1921+2153",
"reference_frame": "icrs",
"attrs": {
"c1": 290.43672917,
"c2": 21.884,
"epoch": 2000.0
}
},
"ft": {
"channel_polarisation_selection": {
"channels": [0, 100],
"polarisations": "Both"
},
"rescale": {
"algorithm": "MedianMAD",
"periodic_update": true,
"timescale": 1.0
},
"requantisation": {
"num_bits_out": 4,
"scale": 1.0
}
}
}
}]
}
}
Example (CSP configuration for CBF 0.2, PST 3.0 using voltage recording scan)
{
"interface": "https://schema.skao.int/ska-low-csp-configure/5.0",
"transaction_id": "txn-....-00001",
"subarray": {
"subarray_name": "science period 23"
},
"common": {
"config_id": "sbi-mvp01-20200325-00001-science_A",
"subarray_id": 1,
"eb_id": "eb-x449-20231105-34696"
},
"lowcbf": {
"stations": {
"stns": [
[1, 1],
[2, 1],
[3, 1],
[4, 1],
[5, 1],
[6, 1]
],
"stn_beams": [{
"beam_id": 1,
"freq_ids": [400],
"delay_poly": "tango://delays.skao.int/low/stn-beam/1"
}]
},
"vis": {
"fsp": {
"firmware": "vis",
"fsp_ids": [1]
},
"stn_beams": [{
"stn_beam_id": 1,
"host": [
[0, "192.168.1.00"]
],
"port": [
[0, 9000, 1]
],
"mac": [
[0, "02-03-04-0a-0b-0c"]
],
"integration_ms": 849
}]
},
"timing_beams": {
"fsp": {
"firmware": "pst",
"fsp_ids": [2]
},
"beams": [{
"pst_beam_id": 1,
"stn_beam_id": 1,
"stn_weights": [0.9, 1.0, 1.0, 1.0, 0.9, 1.0],
"delay_poly": "tango://delays.skao.int/low/stn-beam/1",
"jones": "tango://jones.skao.int/low/stn-beam/1"
}]
}
},
"pst": {
"beams": [{
"beam_id": 1,
"scan": {
"centre_frequency": 100000000.0,
"total_bandwidth": 1562500.0,
"observer_id": "jdoe",
"project_id": "project1",
"receiver_id": "receiver3",
"max_scan_length": 20000.0,
"subint_duration": 30.0,
"receptors": ["SKA001", "SKA036"],
"receptor_weights": [0.4, 0.6],
"pst_processing_mode": "VOLTAGE_RECORDER",
"delay_centre": [5109360.133, 2006852.586, -3238948.127],
"target": {
"target_name": "J1921+2153",
"reference_frame": "icrs",
"attrs": {
"c1": 290.43672917,
"c2": 21.884,
"epoch": 2000.0
}
}
}
}]
}
}
Example (CSP configuration for CBF 0.2, PST 3.0 using detect filterbank scan)
{
"interface": "https://schema.skao.int/ska-low-csp-configure/5.0",
"transaction_id": "txn-....-00001",
"subarray": {
"subarray_name": "science period 23"
},
"common": {
"config_id": "sbi-mvp01-20200325-00001-science_A",
"subarray_id": 1,
"eb_id": "eb-x449-20231105-34696"
},
"lowcbf": {
"stations": {
"stns": [
[1, 1],
[2, 1],
[3, 1],
[4, 1],
[5, 1],
[6, 1]
],
"stn_beams": [{
"beam_id": 1,
"freq_ids": [400],
"delay_poly": "tango://delays.skao.int/low/stn-beam/1"
}]
},
"vis": {
"fsp": {
"firmware": "vis",
"fsp_ids": [1]
},
"stn_beams": [{
"stn_beam_id": 1,
"host": [
[0, "192.168.1.00"]
],
"port": [
[0, 9000, 1]
],
"mac": [
[0, "02-03-04-0a-0b-0c"]
],
"integration_ms": 849
}]
},
"timing_beams": {
"fsp": {
"firmware": "pst",
"fsp_ids": [2]
},
"beams": [{
"pst_beam_id": 1,
"stn_beam_id": 1,
"stn_weights": [0.9, 1.0, 1.0, 1.0, 0.9, 1.0],
"delay_poly": "tango://delays.skao.int/low/stn-beam/1",
"jones": "tango://jones.skao.int/low/stn-beam/1"
}]
}
},
"pst": {
"beams": [{
"beam_id": 1,
"scan": {
"centre_frequency": 100000000.0,
"total_bandwidth": 1562500.0,
"observer_id": "jdoe",
"project_id": "project1",
"receiver_id": "receiver3",
"max_scan_length": 20000.0,
"subint_duration": 30.0,
"receptors": ["SKA001", "SKA036"],
"receptor_weights": [0.4, 0.6],
"pst_processing_mode": "DETECTED_FILTERBANK",
"delay_centre": [5109360.133, 2006852.586, -3238948.127],
"target": {
"target_name": "J1921+2153",
"reference_frame": "icrs",
"attrs": {
"c1": 290.43672917,
"c2": 21.884,
"epoch": 2000.0
}
},
"df": {
"dispersion_measure": 100.0,
"output_frequency_channels": 1,
"stokes_parameters": "Q",
"num_bits_out": 16,
"time_decimation_factor": 10,
"frequency_decimation_factor": 4,
"requantisation_scale": 1.0,
"requantisation_length": 1.0
}
}
}]
}
}
Low CSP specific parameters. This section contains the parameters relevant to configure the Low CSP sub-system.
type |
object |
||
properties |
|||
|
URI of JSON schema for this command’sJSON payload.. |
||
type |
string |
||
|
A transaction id specific to the command |
||
type |
string |
||
|
subarray 5.0 |
||
Subarray elements |
|||
type |
object |
||
properties |
|||
|
Name and scope of current subarray the sub-array. |
||
type |
string |
||
additionalProperties |
True |
||
|
Common section, containing the parameters and the sections belonging to all CSP subsystems. This section is forwarded to all sub-elements. |
||
|
Correlator and Beamformer specific parameters. This section contains the parameters relevant only for CBF sub-system. This section is forwarded only to CBF subelement. |
||
|
PSS configuration schema 0.0 |
||
Section with parameters to configure the PSS sub-system |
|||
type |
object |
||
properties |
|||
|
type |
string |
|
additionalProperties |
True |
||
|
Section with parameters to configure the PST sub-system. |
||
additionalProperties |
True |
||
Common_configuration_schema_5.0
Common section, containing the parameters and the sections belonging to all CSP subsystems. This section is forwarded to all sub-elements.
type |
object |
|
properties |
||
|
type |
string |
|
The Subarray ID that the list of receptors will be assigned to. For Mid, there are a maximum of 16 subarrays. Range: Integer from 1-16 inclusive |
|
type |
integer |
|
|
Execution block ID to associate scan configs to an observation. This ID is used for associating generated data, especially data products, for a given observation. Multiple scans can be linked to one observation and this ID is used as metadata to associate the data products from all scans of the same observation. This ID does not have to be unique for a scan configuration but should be unique for different observations. For example, all the data and weights files will have an EB_ID header value populated with the value supplied in this field. |
|
type |
string |
|
additionalProperties |
True |
|
LOWCBF_subarray_configurescan_0.2
Correlator and Beamformer specific parameters. This section contains the parameters relevant only for CBF sub-system. This section is forwarded only to CBF subelement.
type |
object |
||||
properties |
|||||
|
Subarray Stations and station beam input descriptions |
||||
|
PST beam outputs descriptions |
||||
|
PSS beam outputs descriptions |
||||
type |
string |
||||
|
Visibilities description 0.2 |
||||
Visibility output descriptions |
|||||
type |
object |
||||
properties |
|||||
|
FSP 0.2 |
||||
FSPs used for correlation |
|||||
type |
object |
||||
properties |
|||||
|
Firmware name |
||||
type |
string |
||||
|
List of IDs (integer) |
||||
type |
array |
||||
items |
type |
integer |
|||
additionalProperties |
True |
||||
|
SDP visibility destinations |
||||
type |
array |
||||
items |
|||||
additionalProperties |
True |
||||
|
placeholder zoom visibility output descriptions |
||||
type |
string |
||||
additionalProperties |
True |
||||
Subarray_stations_and_station_beams_0.2
Station and station beams parameters
type |
object |
||||
properties |
|||||
|
type |
array |
|||
items |
type |
array |
|||
items |
type |
integer |
|||
|
type |
array |
|||
items |
Subarray station beams 0.2 |
||||
type |
object |
||||
properties |
|||||
|
station beam id |
||||
type |
integer |
||||
|
list of station beam frequency ids |
||||
type |
array |
||||
items |
type |
integer |
|||
|
URL |
||||
type |
string |
||||
additionalProperties |
True |
||||
additionalProperties |
True |
||||
outer_0.2
PST Outer
type |
object |
|||
properties |
||||
|
inner |
|||
type |
array |
|||
items |
||||
|
FSP 0.2 |
|||
FSPs used by PST |
||||
type |
object |
|||
properties |
||||
|
Firmware name |
|||
type |
string |
|||
|
List of IDs (integer) |
|||
type |
array |
|||
items |
type |
integer |
||
additionalProperties |
True |
|||
additionalProperties |
True |
|||
PST_beams_description_0.2
type |
object |
||||
properties |
|||||
|
Station beam ID for pst beamforming |
||||
type |
integer |
||||
|
PST beam ID |
||||
type |
integer |
||||
|
Sky direction |
||||
field description |
|||||
default |
null |
||||
anyOf |
ICRS sky direction 0.2 |
||||
A sky direction defined in the ICRS reference frame. |
|||||
type |
object |
||||
properties |
|||||
|
A name for the target. If reference_frame is ‘special’ or ‘tle’ then the name might be of a solar system body or a satellite in Earth orbit. |
||||
type |
string |
||||
|
Validation is case-insensitive. |
||||
type |
string |
||||
|
|
||||
Attributes for an ICRS sky direction |
|||||
type |
object |
||||
properties |
|||||
|
The longitude coordinate, specifying degrees right ascension in the ICRS reference frame. Value must be in the range 0 <= c1 < 360. |
||||
type |
number |
||||
|
The latitude coordinate, specifying degrees declination in the ICRS reference frame. Value must be in the range -90 <= c2 <= 90. |
||||
type |
number |
||||
|
Longitudinal proper motion of target, measured in arcseconds per year. |
||||
type |
number |
||||
default |
0.0 |
||||
|
Latitudinal proper motion of target, measured in arcseconds per year. |
||||
type |
number |
||||
default |
0.0 |
||||
|
Epoch of proper motion, giving the date when the proper motion offset was zero. |
||||
type |
number |
||||
default |
2000.0 |
||||
|
The parallax in seconds of arc. |
||||
type |
number |
||||
default |
0.0 |
||||
|
Radial velocity along the line of sight in m/s. |
||||
type |
number |
||||
default |
0.0 |
||||
additionalProperties |
True |
||||
additionalProperties |
True |
||||
AltAz sky direction 0.2 |
|||||
A sky direction defined in the AltAz reference frame |
|||||
type |
object |
||||
properties |
|||||
|
A name for the target. If reference_frame is ‘special’ or ‘tle’ then the name might be of a solar system body or a satellite in Earth orbit. |
||||
type |
string |
||||
|
Validation is case-insensitive. |
||||
type |
string |
||||
|
|
||||
Allowed attributes for an AltAz sky direction |
|||||
type |
object |
||||
properties |
|||||
|
The azimuth coordinate in degrees. Value must be in the range 0 <= c1 < 360. |
||||
type |
number |
||||
|
The elevation coordinate in degrees. Value must be in the range 0 <= c2 <= 90. |
||||
type |
number |
||||
additionalProperties |
True |
||||
additionalProperties |
True |
||||
Galactic sky direction 0.2 |
|||||
A sky direction defined in the Galactic reference frame. |
|||||
type |
object |
||||
properties |
|||||
|
A name for the target. If reference_frame is ‘special’ or ‘tle’ then the name might be of a solar system body or a satellite in Earth orbit. |
||||
type |
string |
||||
|
Validation is case-insensitive. |
||||
type |
string |
||||
|
|
||||
Attributes for a Galactic sky direction |
|||||
type |
object |
||||
properties |
|||||
|
The longitude coordinate, specifying degrees right ascension in the Galactic reference frame. Value must be in the range 0 <= c1 < 360. |
||||
type |
number |
||||
|
The latitude coordinate, specifying degrees declination in the Galactic reference frame. Value must be in the range -90 <= c2 <= 90. |
||||
type |
number |
||||
|
Longitudinal proper motion of target, measured in arcseconds per year. |
||||
type |
number |
||||
default |
0.0 |
||||
|
Latitudinal proper motion of target, measured in arcseconds per year. |
||||
type |
number |
||||
default |
0.0 |
||||
|
Epoch of proper motion, giving the date when the proper motion offset was zero. |
||||
type |
number |
||||
default |
2000.0 |
||||
|
The parallax in seconds of arc. |
||||
type |
number |
||||
default |
0.0 |
||||
|
Radial velocity along the line of sight in m/s. |
||||
type |
number |
||||
default |
0.0 |
||||
additionalProperties |
True |
||||
additionalProperties |
True |
||||
Special sky direction 0.2 |
|||||
A sky direction whose coordinates are defined in Katpoint. |
|||||
type |
object |
||||
properties |
|||||
|
A name for the target. This should be the name of a resolvable entity in Katpoint, for example, the name of a solar system body. |
||||
type |
string |
||||
|
Must be “special” for a catalogue sky direction. Validation is case-insensitive. |
||||
type |
string |
||||
additionalProperties |
True |
||||
Two-Line Element sky direction 0.2 |
|||||
A sky direction defined by a Two-Line Element (TLE) set. |
|||||
type |
object |
||||
properties |
|||||
|
A name for the target. For a TLE sky direction, this could be the name of a satellite in orbit. |
||||
type |
string |
||||
|
Validation is case-insensitive. |
||||
type |
string |
||||
|
|
||||
Attributes for a TLE sky direction. |
|||||
type |
object |
||||
properties |
|||||
|
First line of a two-line element (TLE) sky direction. |
||||
type |
string |
||||
|
Second line of a two-line element (TLE) sky direction. |
||||
type |
string |
||||
additionalProperties |
True |
||||
additionalProperties |
True |
||||
|
Jones matrix source URI |
||||
type |
string |
||||
|
weights for each station |
||||
type |
array |
||||
items |
type |
number |
|||
|
Master enable for RFI flagging |
||||
type |
array |
||||
default |
null |
||||
items |
type |
boolean |
|||
|
Freqency IDs to be always flagged |
||||
type |
array |
||||
default |
null |
||||
items |
type |
integer |
|||
|
Frequency IDs to be dynamically flagged |
||||
type |
array |
||||
default |
null |
||||
items |
type |
integer |
|||
|
Parameter for dynamic flagging |
||||
type |
number |
||||
default |
null |
||||
|
Delay polynomial source URI |
||||
type |
string |
||||
additionalProperties |
True |
||||
Station_beams_to_correlate_0.2
type |
object |
||||
properties |
|||||
|
Station Beam ID |
||||
type |
integer |
||||
|
milliseconds integration |
||||
type |
integer |
||||
|
SDP channel & IP Address |
||||
type |
array |
||||
items |
type |
array |
|||
items |
anyOf |
type |
integer |
||
type |
string |
||||
|
SDP chan & UDP port, stride |
||||
type |
array |
||||
items |
type |
array |
|||
items |
type |
integer |
|||
|
SDP channel & server MAC |
||||
type |
array |
||||
default |
null |
||||
items |
type |
array |
|||
items |
anyOf |
type |
integer |
||
type |
string |
||||
additionalProperties |
True |
||||
PST_configure_3.0
Main configuration for the CSP Pulsar timing sub-system
type |
object |
|||
properties |
||||
|
List of PST Beams IDs to configure |
|||
type |
array |
|||
items |
CSP configurescan pst beams 3.0 |
|||
Parameters to configure the PST sub-system |
||||
type |
object |
|||
properties |
||||
|
Configuration for a PST beam ID in low csp |
|||
type |
integer |
|||
|
PST specific scan configuration parameters. |
|||
default |
null |
|||
additionalProperties |
True |
|||
additionalProperties |
True |
|||
PST_scan_configuration_3.0
PST specific scan configuration parameters.
type |
object |
||||
properties |
|||||
|
Centre frequency of the total (critical) bandwidth spanned by the frequency channels. Units: Hz Range: 50e6 to 12800e6 Keyword: OBSFREQ |
||||
type |
number |
||||
|
Total (critical) bandwidth spanned by the channels of the observation. Low: 0.00361 to 300 MHz Mid: 0.053.76 to 2500 MHz Units: Hz Range: 3610 to 2.5e9 Keyword: OBSBW |
||||
type |
number |
||||
|
The PST processing mode used for the scan. The value VOLTAGE_RECORDER is added for AA0.5, while the other values will be needed in future array assemblies. The value of DYNAMIC_SPECTRUM has been renamed in favour of the value DETECTED_FILTERBANK. This change was made before PST implemented DETECTED_FILTERBANK mode and no clients should have been using this. Note: in previous versions of the schema this used to be
called Note: The values come from the Python enum PstProcessingMode` as defined in the SKA Control Model project. Keyword: OBSMODE |
||||
type |
string |
||||
|
The observer in charge of the observations. Keyword: OBSERVER |
||||
type |
string |
||||
|
The project that the observations are for. Keyword: PROJID |
||||
type |
string |
||||
|
A union of the various standard sky direction representations supported by SKA, as defined in ADR-63. |
||||
|
The telescope delay centre in International Terrestrial Reference Frame (ITRF) coordinates. Units: metres Keyword: DELAY_CENTRE |
||||
type |
array |
||||
items |
type |
number |
|||
|
The receiver name or ID. Keyword: FRONTEND |
||||
type |
string |
||||
|
The maximum length of the observation. Units: seconds Range: 30 - 43200 Keyword: SCANLEN_MAX |
||||
type |
number |
||||
|
The length of each output sub-integration, in seconds. As of version 3.0 of the schema this field is now optional and will default to 10.0 seconds. For VOLTAGE_RECORDER mode the sub-integration length is always 10 seconds but in other processing modes this value could be changed by the observer depending on their use case. Units: seconds Range: 1 - 60 Keyword: OUTSUBINT |
||||
type |
number |
||||
default |
10.0 |
||||
|
An array of receptor IDs for the receptors included in the sub-array. Keyword: ANTENNA |
||||
type |
array |
||||
items |
type |
string |
|||
|
Weight for each receptor. Range: 0 - 1.0 Keyword: ANT_WEIGHTS |
||||
type |
array |
||||
items |
type |
number |
|||
|
A two-dimensional array of length of num_frequency_mask of known RFI frequency ranges to excise from the data. The array contains mask pairs of [f_min, f_max] pairs for known frequency ranges containing RFI not excised by the CBF. The overall dimension of this array is num_frequency_mask x 2. Units: Hz Keyword: FREQ_MASK |
||||
type |
array |
||||
default |
null |
||||
items |
allOf |
type |
array |
||
items |
type |
number |
|||
|
PST specific parameters for the ‘PULSAR_TIMING’ mode configuration. |
||||
default |
null |
||||
|
PST specific parameters for the ‘DYNAMIC_SPECTRUM’ mode configuration. |
||||
default |
null |
||||
|
PST specific parameters for the ‘FLOW_THROUGH’ mode configuration. |
||||
default |
null |
||||
|
Identifier assigned by LMC/TMC used to identify the beam configuration. PST selects which PST server to use for this scan and timing beam, and provides a mapping from the timing beam identifier by the TMC to PST capability id. Keyword: BEAM |
||||
type |
string |
||||
default |
null |
||||
additionalProperties |
True |
||||
Sky direction
A union of the various standard sky direction representations supported by SKA, as defined in ADR-63.
anyOf |
A sky direction defined in the ICRS reference frame. |
A sky direction defined in the AltAz reference frame |
|
A sky direction defined in the Galactic reference frame. |
|
A sky direction whose coordinates are defined in Katpoint. |
|
A sky direction defined by a Two-Line Element (TLE) set. |
|
ICRS_sky_direction_3.0
A sky direction defined in the ICRS reference frame.
type |
object |
||
properties |
|||
|
A name for the target. If reference_frame is ‘special’ or ‘tle’ then the name might be of a solar system body or a satellite in Earth orbit. |
||
type |
string |
||
|
Validation is case-insensitive. |
||
type |
string |
||
|
|
||
Attributes for an ICRS sky direction |
|||
type |
object |
||
properties |
|||
|
The longitude coordinate, specifying degrees right ascension in the ICRS reference frame. Value must be in the range 0 <= c1 < 360. |
||
type |
number |
||
|
The latitude coordinate, specifying degrees declination in the ICRS reference frame. Value must be in the range -90 <= c2 <= 90. |
||
type |
number |
||
|
Longitudinal proper motion of target, measured in arcseconds per year. |
||
type |
number |
||
default |
0.0 |
||
|
Latitudinal proper motion of target, measured in arcseconds per year. |
||
type |
number |
||
default |
0.0 |
||
|
Epoch of proper motion, giving the date when the proper motion offset was zero. |
||
type |
number |
||
default |
2000.0 |
||
|
The parallax in seconds of arc. |
||
type |
number |
||
default |
0.0 |
||
|
Radial velocity along the line of sight in m/s. |
||
type |
number |
||
default |
0.0 |
||
additionalProperties |
True |
||
additionalProperties |
True |
||
AltAz_sky_direction_3.0
A sky direction defined in the AltAz reference frame
type |
object |
||
properties |
|||
|
A name for the target. If reference_frame is ‘special’ or ‘tle’ then the name might be of a solar system body or a satellite in Earth orbit. |
||
type |
string |
||
|
Validation is case-insensitive. |
||
type |
string |
||
|
|
||
Allowed attributes for an AltAz sky direction |
|||
type |
object |
||
properties |
|||
|
The azimuth coordinate in degrees. Value must be in the range 0 <= c1 < 360. |
||
type |
number |
||
|
The elevation coordinate in degrees. Value must be in the range 0 <= c2 <= 90. |
||
type |
number |
||
additionalProperties |
True |
||
additionalProperties |
True |
||
Galactic_sky_direction_3.0
A sky direction defined in the Galactic reference frame.
type |
object |
||
properties |
|||
|
A name for the target. If reference_frame is ‘special’ or ‘tle’ then the name might be of a solar system body or a satellite in Earth orbit. |
||
type |
string |
||
|
Validation is case-insensitive. |
||
type |
string |
||
|
|
||
Attributes for a Galactic sky direction |
|||
type |
object |
||
properties |
|||
|
The longitude coordinate, specifying degrees right ascension in the Galactic reference frame. Value must be in the range 0 <= c1 < 360. |
||
type |
number |
||
|
The latitude coordinate, specifying degrees declination in the Galactic reference frame. Value must be in the range -90 <= c2 <= 90. |
||
type |
number |
||
|
Longitudinal proper motion of target, measured in arcseconds per year. |
||
type |
number |
||
default |
0.0 |
||
|
Latitudinal proper motion of target, measured in arcseconds per year. |
||
type |
number |
||
default |
0.0 |
||
|
Epoch of proper motion, giving the date when the proper motion offset was zero. |
||
type |
number |
||
default |
2000.0 |
||
|
The parallax in seconds of arc. |
||
type |
number |
||
default |
0.0 |
||
|
Radial velocity along the line of sight in m/s. |
||
type |
number |
||
default |
0.0 |
||
additionalProperties |
True |
||
additionalProperties |
True |
||
Special_sky_direction_3.0
A sky direction whose coordinates are defined in Katpoint.
type |
object |
|
properties |
||
|
A name for the target. This should be the name of a resolvable entity in Katpoint, for example, the name of a solar system body. |
|
type |
string |
|
|
Must be “special” for a catalogue sky direction. Validation is case-insensitive. |
|
type |
string |
|
additionalProperties |
True |
|
Two_Line_Element_sky_direction_3.0
A sky direction defined by a Two-Line Element (TLE) set.
type |
object |
||
properties |
|||
|
A name for the target. For a TLE sky direction, this could be the name of a satellite in orbit. |
||
type |
string |
||
|
Validation is case-insensitive. |
||
type |
string |
||
|
|
||
Attributes for a TLE sky direction. |
|||
type |
object |
||
properties |
|||
|
First line of a two-line element (TLE) sky direction. |
||
type |
string |
||
|
Second line of a two-line element (TLE) sky direction. |
||
type |
string |
||
additionalProperties |
True |
||
additionalProperties |
True |
||
PST_PULSAR_TIMING_mode_configuration_3.0
PST specific parameters for the ‘PULSAR_TIMING’ mode configuration.
type |
object |
|
properties |
||
|
The dispersion measure for coherent/incoherent de-dispersion. Units: pccm^-3 Range: 0 - 100000 Keyword: DM |
|
type |
number |
|
|
The rotation measure for phase-coherent Faraday rotation correction. Units: radians per metre squared Keyword: RM |
|
type |
number |
|
default |
null |
|
|
The ephemeris of the pulsar being observed. Units: PSRCAT compatible ASCII string Keyword: EPHEMERIS |
|
type |
string |
|
|
Pulsar phase predictor generated from ephemeris. Units: TEMPO2 compatible ASCII string Keyword: PREDICTOR |
|
type |
string |
|
|
The number of output frequency channels. This must be between 1 and the number of observation channels. Keyword: OUTNCHAN |
|
type |
integer |
|
|
The number of output phase bins. Range: 64 - 2048 Keyword: OUTNBIN |
|
type |
integer |
|
|
The number of spectral kurtosis (SK) configurations to apply. Keyword: N_SK |
|
type |
integer |
|
|
List of spectral kurtosis configurations. |
|
type |
array |
|
items |
PST specific parameters for the spectral kurtosis (SK) for the ‘PULSAR_TIMING’ mode. |
|
|
The signal-to-noise ratio (SNR) of the on-pulse flux for the scan. May be used to prematurely end a scan when the integrated SNR reaches the target. A value of 0 indicates there is no limit. Keyword: TARGET_SNR |
|
type |
number |
|
additionalProperties |
True |
|
PST_spectral_kurtosis_configuration_3.0
PST specific parameters for the spectral kurtosis (SK) for the ‘PULSAR_TIMING’ mode.
type |
object |
||
properties |
|||
|
Frequency ranges for each spectral kurtosis (SK) configuration. Units: Hz Keyword: SK_RNG |
||
type |
array |
||
items |
type |
number |
|
|
The number of input time samples integrated into each spectral kurtosis (SK) statistic. Range: 64 - 1024 Keyword: SK_INTS |
||
type |
integer |
||
|
Spectral kurtosis excision limits (RFI threshold) in units of standard deviations. Range: 1 - 100 Keyword: SK_EXIS |
||
type |
number |
||
additionalProperties |
True |
||
PST_DYNAMIC_SPECTRUM_mode_configuration_3.0
PST specific parameters for the ‘DYNAMIC_SPECTRUM’ mode configuration.
type |
object |
|
properties |
||
|
The dispersion measure for coherent/incoherent de-dispersion. This is only required for pulsar timing and dynamic spectrum modes. Range: [0, 100000] Keyword: DM |
|
type |
number |
|
|
The rotation measure for phase-coherent Faraday rotation correction. Units: radians per metre squared Keyword: RM |
|
type |
number |
|
default |
null |
|
|
The number of output frequency channels. This must be between 1 and the number of observation channels. Keyword: OUTNCHAN |
|
type |
integer |
|
|
The Stokes parameters to output when in Dynamic spectrum mode. Range: string with a combination of I, Q, U, and V. Keyword: STOKES_FB |
|
type |
string |
|
|
The number of bits per output sample. Range: 1, 2, 4, 8, 16 or 32 Keyword: NBIT_OUT |
|
type |
integer |
|
|
The number of input samples per output time sample when in Dynamic Spectrum mode. Keyword: TDEC_FB |
|
type |
integer |
|
|
The number of input frequency channels incoherently added to each output frequency channel in Dynamic Spectrum. This is required in addition to output_frequency_channels because some frequency channels may be merged coherently to increase temporal resolution. Keyword: FDEC_FB |
|
type |
integer |
|
|
The number of spectral kurtosis (SK) configurations to apply. Keyword: N_SK |
|
type |
integer |
|
default |
null |
|
|
List of spectral kurtosis configurations. |
|
type |
array |
|
default |
null |
|
items |
PST specific parameters for the spectral kurtosis (SK) for the ‘PULSAR_TIMING’ mode. |
|
|
Scale factor to govern the dynamic range for fixed precision output to be applied during re-quantisation. Keyword: DIGITIZER_SCALE |
|
type |
number |
|
|
Length of data to be used when determining the scaling factors used for fixed precision output during re-quantisation. Units: seconds Keyword: DIGITIZER_LENGTH |
|
type |
number |
|
additionalProperties |
True |
|
PST_FLOW_THROUGH_mode_configuration_3.0
PST specific parameters for the ‘FLOW_THROUGH’ mode configuration.
type |
object |
|
properties |
||
|
PST specific parameters used for performing channel and polarisation selection of input data. This is used within the FLOW_THROUGH processing mode. |
|
|
PST specific parameters used for rescaling of data before requantisation. This is used within the FLOW_THROUGH processing mode. |
|
|
type |
null |
additionalProperties |
True |
|
PST_channel_and_polarisation_selection_configuration_3.0
PST specific parameters used for performing channel and polarisation selection of input data. This is used within the FLOW_THROUGH processing mode.
type |
object |
|||
properties |
||||
|
The indices of the first and last (inclusive) frequency channels that define the single contiguous range of frequency channels to be recorded. Keyword: CHAN_FT |
|||
allOf |
type |
array |
||
items |
type |
integer |
||
|
The polarisations to be recorded. Valid values: A, B, or Both Keyword: POLN_FT |
|||
type |
string |
|||
additionalProperties |
True |
|||
PST_Rescale_configuration_3.0
PST specific parameters used for rescaling of data before requantisation. This is used within the FLOW_THROUGH processing mode.
type |
object |
|
properties |
||
|
The algorithm used to determine the scales and offsets when rescaling complex voltage data in Flow Through mode. The value MedianMAD is the default algorithm and PST will determine the scales and offsets based on the calculating the median and the median absolute deviation (MAD) as the proxies for the sample mean and standard deviation. These statistics are considered more robust against outliers and are less affected by radio frequency interference (RFI) when computing the values. The value MeanStdDev will calculate the sample mean and standard deviation of the input data and use that to rescale the data. This algorithm is not robust against RFI which will reduce the dynamic range when performing requantisation of the data. Default: MedianMAD |
|
type |
string |
|
default |
MedianMAD |
|
|
An indicator for whether to recalculate the rescale statistics periodically. The rescaling of data within the FLOW_THROUGH processing mode can either be calculated once and applied across all the data during the scan or can be calculated periodically. If this value is set to false then the former is performed while the latter is performed if the field is set to true. Default: false |
|
type |
boolean |
|
default |
False |
|
|
The timescale needed to calculate rescale stats, in seconds. This value is how long in time to sample data before calculating the rescale statistics. If periodic_update is true, then this is also the period of how often the rescale stats are recalculated. If this value is set to 0.0, then PST will use the smallest chunk of data available to it to perform the statistics calculation. Default: 0.0 |
|
type |
number |
|
default |
0.0 |
|
additionalProperties |
True |
|