JSON schema and example for Configure version 2.4
PST configuration schema 2.4
Example (LOW PST configuration for FLOW THROUGH scan 2.4)
{
"interface": "https://schema.skao.int/ska-pst-configure/2.4",
"common": {
"config_id": "sbi-mvp01-20240325-00001-flow_through",
"subarray_id": 1,
"eb_id": "eb-b521-20240325-0010",
"frequency_band": "low"
},
"pst": {
"scan": {
"activation_time": "2024-03-25T22:01:11Z",
"timing_beam_id": "1",
"bits_per_sample": 32,
"num_of_polarizations": 2,
"udp_nsamp": 32,
"wt_nsamp": 32,
"udp_nchan": 24,
"num_frequency_channels": 432,
"centre_frequency": 100000000.0,
"total_bandwidth": 1562500.0,
"observation_mode": "FLOW_THROUGH",
"observer_id": "jdoe",
"project_id": "project1",
"pointing_id": "pointing1",
"source": "J1921+2153",
"itrf": [5109360.133, 2006852.586, -3238948.127],
"receiver_id": "receiver3",
"feed_polarization": "CIRC",
"feed_handedness": 1,
"feed_angle": 1.234,
"feed_tracking_mode": "FA",
"feed_position_angle": 10.0,
"oversampling_ratio": [4, 3],
"coordinates": {
"equinox": 2000.0,
"ra": "19:21:44.815",
"dec": "21:53:02.400"
},
"max_scan_length": 20000.0,
"subint_duration": 30.0,
"receptors": ["receptorZ", "receptorW"],
"receptor_weights": [0.4, 0.6],
"num_rfi_frequency_masks": 0,
"rfi_frequency_masks": [],
"destination_address": ["192.168.178.26", 9021],
"num_channelization_stages": 2,
"channelization_stages": [{
"num_filter_taps": 1,
"filter_coefficients": [1.0],
"num_frequency_channels": 1024,
"oversampling_ratio": [32, 27]
}, {
"num_filter_taps": 1,
"filter_coefficients": [1.0],
"num_frequency_channels": 256,
"oversampling_ratio": [4, 3]
}],
"ft": {
"num_bits_out": 32,
"num_channels": 1,
"channels": [1],
"requantisation_scale": 1.0,
"requantisation_length": 1.0
}
}
}
}
Example (LOW PST configuration for PULSAR TIMING scan 2.4)
{
"interface": "https://schema.skao.int/ska-pst-configure/2.4",
"common": {
"config_id": "sbi-20240215-00001-pulsar_timing",
"subarray_id": 1,
"eb_id": "eb-x449-20231105-34696",
"frequency_band": "low"
},
"pst": {
"scan": {
"activation_time": "2024-02-15T23:07:45Z",
"timing_beam_id": "1",
"bits_per_sample": 32,
"num_of_polarizations": 2,
"udp_nsamp": 32,
"wt_nsamp": 32,
"udp_nchan": 24,
"num_frequency_channels": 432,
"centre_frequency": 100000000.0,
"total_bandwidth": 1562500.0,
"observation_mode": "PULSAR_TIMING",
"observer_id": "jdoe",
"project_id": "project1",
"pointing_id": "pointing1",
"source": "J1921+2153",
"itrf": [5109360.133, 2006852.586, -3238948.127],
"receiver_id": "receiver3",
"feed_polarization": "CIRC",
"feed_handedness": 1,
"feed_angle": 1.234,
"feed_tracking_mode": "FA",
"feed_position_angle": 10.0,
"oversampling_ratio": [4, 3],
"coordinates": {
"equinox": 2000.0,
"ra": "19:21:44.815",
"dec": "21:53:02.400"
},
"max_scan_length": 10000.5,
"subint_duration": 30.0,
"receptors": ["receptorX", "receptorY"],
"receptor_weights": [0.4, 0.6],
"num_rfi_frequency_masks": 0,
"rfi_frequency_masks": [],
"destination_address": ["192.168.178.26", 9021],
"num_channelization_stages": 2,
"channelization_stages": [{
"num_filter_taps": 1,
"filter_coefficients": [1.0],
"num_frequency_channels": 1024,
"oversampling_ratio": [32, 27]
}, {
"num_filter_taps": 1,
"filter_coefficients": [1.0],
"num_frequency_channels": 256,
"oversampling_ratio": [4, 3]
}],
"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 (LOW PST configuration for DYNAMIC SPECTRUM scan 2.4)
{
"interface": "https://schema.skao.int/ska-pst-configure/2.4",
"common": {
"config_id": "sbi-dynamic_spectrum",
"subarray_id": 1,
"eb_id": "eb-x449-20231105-34696",
"frequency_band": "low"
},
"pst": {
"scan": {
"activation_time": "2022-01-19T23:07:45Z",
"timing_beam_id": "1",
"bits_per_sample": 32,
"num_of_polarizations": 2,
"udp_nsamp": 32,
"wt_nsamp": 32,
"udp_nchan": 24,
"num_frequency_channels": 432,
"centre_frequency": 100000000.0,
"total_bandwidth": 1562500.0,
"observation_mode": "DYNAMIC_SPECTRUM",
"observer_id": "jdoe",
"project_id": "project1",
"pointing_id": "pointing1",
"source": "J1921+2153",
"itrf": [5109360.133, 2006852.586, -3238948.127],
"receiver_id": "receiver3",
"feed_polarization": "CIRC",
"feed_handedness": 1,
"feed_angle": 1.234,
"feed_tracking_mode": "FA",
"feed_position_angle": 10.0,
"oversampling_ratio": [4, 3],
"coordinates": {
"equinox": 2000.0,
"ra": "19:21:44.815",
"dec": "21:53:02.400"
},
"max_scan_length": 13000.2,
"subint_duration": 30.0,
"receptors": ["receptorX, receptorY"],
"receptor_weights": [0.4, 0.6],
"num_rfi_frequency_masks": 0,
"rfi_frequency_masks": [],
"destination_address": ["192.168.178.26", 9021],
"num_channelization_stages": 2,
"channelization_stages": [{
"num_filter_taps": 1,
"filter_coefficients": [1.0],
"num_frequency_channels": 1024,
"oversampling_ratio": [32, 27]
}, {
"num_filter_taps": 1,
"filter_coefficients": [1.0],
"num_frequency_channels": 256,
"oversampling_ratio": [4, 3]
}],
"ds": {
"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
}
}
}
}
Example (LOW PST configuration for VOLTAGE RECORDER scan 2.4)
{
"interface": "https://schema.skao.int/ska-pst-configure/2.4",
"common": {
"config_id": "sbi-mvp01-20240111-voltage_recorder",
"subarray_id": 1,
"eb_id": "eb-x321-20240111-10012",
"frequency_band": "low"
},
"pst": {
"scan": {
"activation_time": "2024-01-11T23:11:17Z",
"bits_per_sample": 32,
"timing_beam_id": "1",
"num_of_polarizations": 2,
"udp_nsamp": 32,
"wt_nsamp": 32,
"udp_nchan": 24,
"num_frequency_channels": 432,
"centre_frequency": 100000000.0,
"total_bandwidth": 1562500.0,
"observation_mode": "VOLTAGE_RECORDER",
"observer_id": "jdoe",
"project_id": "project1",
"pointing_id": "pointing1",
"source": "J1921+2153",
"itrf": [5109360.133, 2006852.586, -3238948.127],
"receiver_id": "receiver3",
"feed_polarization": "LIN",
"feed_handedness": 1,
"feed_angle": 1.234,
"feed_tracking_mode": "FA",
"feed_position_angle": 10.0,
"oversampling_ratio": [4, 3],
"coordinates": {
"equinox": 2000.0,
"ra": "19:21:44.815",
"dec": "21:53:02.400"
},
"max_scan_length": 20000.0,
"subint_duration": 30.0,
"receptors": ["SKA001", "SKA036"],
"receptor_weights": [0.4, 0.6],
"num_channelization_stages": 2,
"channelization_stages": [{
"num_filter_taps": 1,
"filter_coefficients": [1.0],
"num_frequency_channels": 1024,
"oversampling_ratio": [32, 27]
}, {
"num_filter_taps": 1,
"filter_coefficients": [1.0],
"num_frequency_channels": 256,
"oversampling_ratio": [4, 3]
}]
}
}
}
Example (MID PST configuration for FLOW THROUGH scan 2.4)
{
"interface": "https://schema.skao.int/ska-pst-configure/2.4",
"common": {
"config_id": "sbi-mvp01-20240325-00001-flow_through",
"subarray_id": 1,
"eb_id": "eb-b521-20240325-0010",
"frequency_band": "5a"
},
"pst": {
"scan": {
"activation_time": "2024-03-25T22:01:11Z",
"timing_beam_id": "1",
"bits_per_sample": 16,
"num_of_polarizations": 2,
"udp_nsamp": 4,
"wt_nsamp": 4,
"udp_nchan": 185,
"num_frequency_channels": 46503,
"centre_frequency": 6550000000.0,
"total_bandwidth": 2500000000.0,
"observation_mode": "FLOW_THROUGH",
"observer_id": "jdoe",
"project_id": "project1",
"pointing_id": "pointing1",
"source": "J1921+2153",
"itrf": [5109360.133, 2006852.586, -3238948.127],
"receiver_id": "receiver3",
"feed_polarization": "CIRC",
"feed_handedness": 1,
"feed_angle": 1.234,
"feed_tracking_mode": "FA",
"feed_position_angle": 10.0,
"oversampling_ratio": [8, 7],
"coordinates": {
"equinox": 2000.0,
"ra": "19:21:44.815",
"dec": "21:53:02.400"
},
"max_scan_length": 20000.0,
"subint_duration": 30.0,
"receptors": ["receptorZ", "receptorW"],
"receptor_weights": [0.4, 0.6],
"num_rfi_frequency_masks": 0,
"rfi_frequency_masks": [],
"destination_address": ["192.168.178.26", 9021],
"num_channelization_stages": 2,
"channelization_stages": [{
"num_filter_taps": 1,
"filter_coefficients": [1.0],
"num_frequency_channels": 13,
"oversampling_ratio": [10, 9]
}, {
"num_filter_taps": 1,
"filter_coefficients": [1.0],
"num_frequency_channels": 4096,
"oversampling_ratio": [8, 7]
}],
"ft": {
"num_bits_out": 32,
"num_channels": 1,
"channels": [1],
"requantisation_scale": 1.0,
"requantisation_length": 1.0
}
}
}
}
Example (MID PST configuration for PULSAR TIMING scan 2.4)
{
"interface": "https://schema.skao.int/ska-pst-configure/2.4",
"common": {
"config_id": "sbi-20240215-00001-pulsar_timing",
"subarray_id": 1,
"eb_id": "eb-x449-20231105-34696",
"frequency_band": "2"
},
"pst": {
"scan": {
"activation_time": "2024-02-15T23:07:45Z",
"timing_beam_id": "1",
"bits_per_sample": 32,
"num_of_polarizations": 2,
"udp_nsamp": 4,
"wt_nsamp": 4,
"udp_nchan": 185,
"num_frequency_channels": 15067,
"centre_frequency": 1355000000.0,
"total_bandwidth": 810000000.0,
"observation_mode": "PULSAR_TIMING",
"observer_id": "jdoe",
"project_id": "project1",
"pointing_id": "pointing1",
"source": "J1921+2153",
"itrf": [5109360.133, 2006852.586, -3238948.127],
"receiver_id": "receiver3",
"feed_polarization": "CIRC",
"feed_handedness": 1,
"feed_angle": 1.234,
"feed_tracking_mode": "FA",
"feed_position_angle": 10.0,
"oversampling_ratio": [8, 7],
"coordinates": {
"equinox": 2000.0,
"ra": "19:21:44.815",
"dec": "21:53:02.400"
},
"max_scan_length": 10000.5,
"subint_duration": 30.0,
"receptors": ["receptorX", "receptorY"],
"receptor_weights": [0.4, 0.6],
"num_rfi_frequency_masks": 0,
"rfi_frequency_masks": [],
"destination_address": ["192.168.178.26", 9021],
"num_channelization_stages": 2,
"channelization_stages": [{
"num_filter_taps": 1,
"filter_coefficients": [1.0],
"num_frequency_channels": 5,
"oversampling_ratio": [10, 9]
}, {
"num_filter_taps": 1,
"filter_coefficients": [1.0],
"num_frequency_channels": 4096,
"oversampling_ratio": [8, 7]
}],
"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 (MID PST configuration for DYNAMIC SPECTRUM scan 2.4)
{
"interface": "https://schema.skao.int/ska-pst-configure/2.4",
"common": {
"config_id": "sbi-dynamic_spectrum",
"subarray_id": 1,
"eb_id": "eb-x449-20231105-34696",
"frequency_band": "1"
},
"pst": {
"scan": {
"activation_time": "2022-01-19T23:07:45Z",
"timing_beam_id": "1",
"bits_per_sample": 32,
"num_of_polarizations": 2,
"udp_nsamp": 4,
"wt_nsamp": 4,
"udp_nchan": 185,
"num_frequency_channels": 13021,
"centre_frequency": 700000000.0,
"total_bandwidth": 700000000.0,
"observation_mode": "DYNAMIC_SPECTRUM",
"observer_id": "jdoe",
"project_id": "project1",
"pointing_id": "pointing1",
"source": "J1921+2153",
"itrf": [5109360.133, 2006852.586, -3238948.127],
"receiver_id": "receiver3",
"feed_polarization": "CIRC",
"feed_handedness": 1,
"feed_angle": 1.234,
"feed_tracking_mode": "FA",
"feed_position_angle": 10.0,
"oversampling_ratio": [8, 7],
"coordinates": {
"equinox": 2000.0,
"ra": "19:21:44.815",
"dec": "21:53:02.400"
},
"max_scan_length": 13000.2,
"subint_duration": 30.0,
"receptors": ["receptorX, receptorY"],
"receptor_weights": [0.4, 0.6],
"num_rfi_frequency_masks": 0,
"rfi_frequency_masks": [],
"destination_address": ["192.168.178.26", 9021],
"num_channelization_stages": 2,
"channelization_stages": [{
"num_filter_taps": 1,
"filter_coefficients": [1.0],
"num_frequency_channels": 4,
"oversampling_ratio": [10, 9]
}, {
"num_filter_taps": 1,
"filter_coefficients": [1.0],
"num_frequency_channels": 4096,
"oversampling_ratio": [8, 7]
}],
"ds": {
"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
}
}
}
}
Example (MID PST configuration for VOLTAGE RECORDER scan 2.4)
{
"interface": "https://schema.skao.int/ska-pst-configure/2.4",
"common": {
"config_id": "sbi-mvp01-20240111-voltage_recorder",
"subarray_id": 1,
"eb_id": "eb-x321-20240111-10012",
"frequency_band": "5b"
},
"pst": {
"scan": {
"activation_time": "2024-01-11T23:11:17Z",
"bits_per_sample": 16,
"timing_beam_id": "1",
"num_of_polarizations": 2,
"udp_nsamp": 4,
"wt_nsamp": 4,
"udp_nchan": 185,
"num_frequency_channels": 46503,
"centre_frequency": 10550000000.0,
"total_bandwidth": 2500000000.0,
"observation_mode": "VOLTAGE_RECORDER",
"observer_id": "jdoe",
"project_id": "project1",
"pointing_id": "pointing1",
"source": "J1921+2153",
"itrf": [5109360.133, 2006852.586, -3238948.127],
"receiver_id": "receiver3",
"feed_polarization": "LIN",
"feed_handedness": 1,
"feed_angle": 1.234,
"feed_tracking_mode": "FA",
"feed_position_angle": 10.0,
"oversampling_ratio": [8, 7],
"coordinates": {
"equinox": 2000.0,
"ra": "19:21:44.815",
"dec": "21:53:02.400"
},
"max_scan_length": 20000.0,
"subint_duration": 30.0,
"receptors": ["SKA001", "SKA036"],
"receptor_weights": [0.4, 0.6],
"num_channelization_stages": 2,
"channelization_stages": [{
"num_filter_taps": 1,
"filter_coefficients": [1.0],
"num_frequency_channels": 13,
"oversampling_ratio": [10, 9]
}, {
"num_filter_taps": 1,
"filter_coefficients": [1.0],
"num_frequency_channels": 4096,
"oversampling_ratio": [8, 7]
}]
}
}
}
Schema to validate the Pulsar Timing configuration.
type |
object |
||
properties |
|||
|
Pulsar Timing specific parameters. To be borrowed from IICD |
||
type |
object |
||
properties |
|||
|
Pulsar Timing specific scan configuration parameters. |
||
default |
null |
||
|
Pulsar Timing specific beam configuration parameters. As of version 2.3 this schema has no elements and is deprecated |
||
default |
null |
||
additionalProperties |
False |
||
|
URI of JSON schema for this command’s JSON payload.. |
||
type |
string |
||
|
Common section, containing the parameters and the sections belonging to all CSP subsystems. This section is forwarded to all sub-elements. |
||
additionalProperties |
False |
||
PST scan configuration 2.4
Pulsar Timing specific scan configuration parameters.
type |
object |
|||
properties |
||||
|
Date and time when to start the PST reconfiguration. Units: UTC timestamp Keyword: ACTIVATION_TIME |
|||
type |
string |
|||
|
Identifier assigned by LMC/TM used to identify the beam configuraiton. PST selects which PST server to use for this scan and timing beam, and provides a mapping from the timing beam identifier by the TM to PST capability id. Keyword: BEAM |
|||
type |
string |
|||
|
The number of bits per complex-values time sample in the CBF output data. Valid values are 16, 24, or 32. Keyword: NBIT |
|||
type |
integer |
|||
|
The number of polarizations in the CBF output data. Valid values are 1 or 2. Keyword: NPOL |
|||
type |
integer |
|||
|
The number of time samples for each single polarization and the a single frequency in each UDP packet sent by CBF. Note: this must be an integer multiple of WT_NSMAP Range: 4 (Low), 32 (Mid) Keyword: UDP_NSAMP |
|||
type |
integer |
|||
|
The number of time samples described by as single relative weight. There is a unique relative weight for each frequency channel, and each relative weight describes both polarizations. Range: 4 (Low), 32 (Mid) Keyword: WT_NSAMP |
|||
type |
integer |
|||
|
The number of contiguous frequency channels in each UDP packet sent by CBF. Range: 24 (Low), 185 (Mid) Keyword: UDP_NCHAN |
|||
type |
integer |
|||
|
The total number of frequency channels into which the total critical bandwidth has been divided. This must be an integer multiple of udp_nchan Range: 1 to 82944 Keyword: OBSNCHAN |
|||
type |
integer |
|||
|
Centre frequency of to 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 observation mode used for the scan. The value VOLTAGE_RECORDER is added for AA0.5, while the other values will be needed for in the future for data processing. Keyword: OBSMODE |
|||
allOf |
type |
string |
||
enum |
PULSAR_TIMING, DYNAMIC_SPECTRUM, FLOW_THROUGH, VOLTAGE_RECORDER |
|||
|
The observer in charge of the observations. Keyword: OBSERVER |
|||
type |
string |
|||
|
The project that the observations are for. Keyword: PROJID |
|||
type |
string |
|||
|
The ID for the sub-array pointing. Keyword: PNT_ID |
|||
type |
string |
|||
|
The name of the source. Keyword: SRC_NAME |
|||
type |
string |
|||
|
The International Terrestrial Reference Frame (ITRF) coordinates of the telescope delay centre. Units: metres Keyword: ITRF |
|||
type |
array |
|||
items |
type |
number |
||
|
The receiver name or ID (instrument). Keyword: FRONTEND |
|||
type |
string |
|||
|
The native polarization of feed. Range: LIN or CIRC Keyword: FD_POLN |
|||
allOf |
type |
string |
||
enum |
LIN, CIRC |
|||
|
Code for sense of feed. For value of +1 for XYZ forming RH set with Z in the direction of propagation. Looking up into the feed of a prime-focus receiver or at the sky). For FD_HAND = +1, the rotation from A (or X) to B (or Y) is counter clockwise or in the direction of increasing Feed Angle (FA) or Position Angle (PA). For circular feeds, FD_HAND = +1 for IEEE LCP on the A (or X) probe. Range: -1 or +1 Keyword: FD_HAND |
|||
allOf |
type |
integer |
||
enum |
-1, 1 |
|||
|
Feed angle of the E-vector for an equal in-phase response from the A(X) and B(Y) probes, measured in the direction of increasing feed angle or position angle (clockwise when looking down on a prime focuse receiver). Units: degrees Range: -180 to 180. Keyword: FD_SANG |
|||
type |
number |
|||
|
The tracking mode for the feed:
Range: FA, CPA, SPA, or TPA Keyword: FD_MODE |
|||
allOf |
type |
string |
||
enum |
FA, CPA, SPA, TPA |
|||
|
The requested angle of feed reference. For feed_mode = ‘FA’ this is respect to the telescope’s reference frame (feed_angle = 0), and for feed_mode = ‘CPA’ this is with respect to the celestial north (parallic angle = 0) or with respect to the Galactic north for coordinate_mode = ‘GALACTIC’. Range: -180 to +180. Keyword: FA_REQ |
|||
type |
number |
|||
|
The oversampling ratio expressed as a fraction as an array of int, with the first value the numerator and the second is the denominator. (e.g. 8/7 is assigned as [8,7]). Range: 8/7 or 4/3 Keyword: OVERSAMP |
|||
type |
array |
|||
items |
type |
integer |
||
|
The tied-array beam’s tracking co-ordinates. As of version 2.2 of the schema this only handles equitorial tracking which means uses RA/Dec J2000.0 coords but PST may support different tracking modes and coordinates the future. |
|||
|
The maximum length of the observation. Units: seconds Range: 30 - 43200 Keyword: SCANLEN_MAX |
|||
type |
number |
|||
|
The length of each output sub-integration. Units: seconds Range: 1 - 60 Keyword: OUTSUBINT |
|||
type |
number |
|||
|
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 |
||
|
The number of frequency ranges to be masked. Range: 0 - 1024 Keyword: NMASK |
|||
type |
integer |
|||
default |
0 |
|||
|
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 |
type |
array |
||
items |
type |
number |
||
|
The destination address for the PST output data. Includes IPv4 Address, port number. |
|||
type |
array |
|||
default |
null |
|||
items |
anyOf |
type |
string |
|
type |
integer |
|||
|
Identifier for a test vectore that will be present in the tied-array beam data stream beam CBF and PST. Keyword: TEST_VECTOR |
|||
type |
string |
|||
default |
null |
|||
|
Pulsar Timing specific parameters for the ‘PULSAR_TIMING’ mode configuration. |
|||
default |
null |
|||
|
Pulsar Timing specific parameters for the ‘DYNAMIC_SPECTRUM’ mode configuration. |
|||
default |
null |
|||
|
Pulsar Timing specific parameters for the ‘FLOW_THROUGH’ mode configuration. |
|||
default |
null |
|||
|
The number of stages used to channelize the data: e.g. * for Low, there are 2 stages: 1 in LFAA and 1 in CBF * for Mid, there are 2 stages: 1 in FSP and 1 in PST BF. Keyword: NSTAGE |
|||
type |
integer |
|||
|
List of configuration for each channelization stage. |
|||
type |
array |
|||
items |
Pulsar Timing specific parameters for channelization stage configuration. |
|||
additionalProperties |
False |
|||
PST RA_Dec coordinates 2.4
Pulsar Timing specific parameters for RA/Dec tracking coordinates.
type |
object |
|
properties |
||
|
The coordinate epoch. This can be in Julian date or Modified Julian Date. Units: years Range: >= 2000 Keyword: EQUINOX |
|
type |
number |
|
default |
2000.0 |
|
|
The Right Accession (RA) of the coordinates used for tracking. Valid formats is ‘hh:mm:ss.sss’ or ‘ddd.ddd’ Keyword: STT_CTD1 |
|
type |
string |
|
|
The declination (Dec) of the coordinates used for tracking. Valid formats is ‘hh:mm:ss.sss’ or ‘ddd.ddd’ Keyword: STT_CTD2 |
|
type |
string |
|
additionalProperties |
False |
|
PST ‘PULSAR_TIMING’ mode configuration 2.4
Pulsar Timing specific parameters for the ‘PULSAR_TIMING’ mode configuration.
type |
object |
|
properties |
||
|
The dispersion measure for coherent/inchoerent 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 |
Pulsar Timing 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 |
False |
|
PST spectral kurtosis configuration 2.4
Pulsar Timing 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 |
False |
||
PST ‘DYNAMIC_SPECTRUM’ mode configuration 2.4
Pulsar Timing specific parameters for the ‘DYNAMIC_SPECTRUM’ mode configuration.
type |
object |
||
properties |
|||
|
The dispersion measture for coherent/inchoerent 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 |
||
allOf |
type |
integer |
|
enum |
1, 2, 4, 8, 16, 32 |
||
|
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 |
Pulsar Timing 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 |
False |
||
PST ‘FLOW_THROUGH’ mode configuration 2.4
Pulsar Timing specific parameters for the ‘FLOW_THROUGH’ mode configuration.
type |
object |
||
properties |
|||
|
The number of bits per output sample. Range: 1, 2, 4, 8, 16 or 32 Keyword: NBIT_OUT |
||
allOf |
type |
integer |
|
enum |
1, 2, 4, 8, 16, 32 |
||
|
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 |
||
type |
array |
||
items |
type |
integer |
|
|
Scale factor applied during re-quantisation that modifies the dynamic range of the fixed precision output. By default, for 2, 4, and 8 bits per sample, data will be scaled to minimize scattered power by adopting the Optimum Input Threshold Spacing for a Uniform Digitizer defined in Table 3 of Jenet & Anderson (1998; PASP 110:1467). For 16 and 32 bits per sample, by default the data will be scaled such that the maximum fixed precision output value (2^{num_bits_out-1}) corresponds to 6 times the standard deviation. For all num_bits_out, the standard deviation is that of either the real or imaginary part of each complex-valued sample. The default scale factor is computed such that, after multiplication by this scale factor, the data would satisfy the conditions described above. This default scale factor is multiplied by requantisation_scale. Therefore, a requantisation_scale value greater than 1 increases the value of the floating point data before it is cast to a fixed precision value, thereby reducing the overhead available to represent RFI and increasing the probability of clipping. Keyword: DIGITIZER_SCALE |
||
type |
number |
||
|
The number of input channels to be recorded. This value must be less than or equal to the output_frequency_channels. Keyword: NCHAN_FT |
||
type |
integer |
||
|
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 |
False |
||
PST channelization stage configuration 2.4
Pulsar Timing specific parameters for channelization stage configuration.
type |
object |
||
properties |
|||
|
Total number of taps in the prototype filter (i.e. over all arms) used in the stage. Keyword: NSTAP_k |
||
type |
integer |
||
|
An array of filter coefficients that define the (time domain) response function of the prototype filter used in the stage. Length of this is num_filter_taps. Keyword: COEFF_k |
||
type |
array |
||
items |
type |
number |
|
|
The number of frequency channels output by each polyphase filter bank (PFB) for this stage. Keyword: NCHAN_PFB_k |
||
type |
integer |
||
|
The oversampling ratio expressed as a fraction as an array of int, with the first value the numerator and the second is the denominator. (e.g. 8/7 is assigned as [8,7]). Keyword: OVERSAMP_k |
||
type |
array |
||
items |
type |
integer |
|
additionalProperties |
False |
||
PST beam configuration 2.4
Pulsar Timing specific beam configuration parameters.
As of version 2.3 this schema has no elements and is deprecated
type |
object |
properties |
|
additionalProperties |
False |
Common configuration schema 2.4
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 |
default |
null |
|
|
Subarray number |
|
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 |
|
pattern |
^eb\-[a-z0-9]+\-[0-9]{8}\-[a-z0-9]+$ |
|
default |
null |
|
|
Frequency band applies for all the receptors (VCCs) that belong to the sub-array. The value of ‘low’ is used to only within SKA Low. As this field is a mandatory field but bands 1, 2, 3, 4, 5a and 5b only make sense for SKA Mid. |
|
type |
string |
|
pattern |
^(1|2|3|4|5(a|b)|low)$ |
|
additionalProperties |
False |
|