Mid TMC configure 5.0

Example JSON.

{
    "interface": "https://schema.skao.int/ska-tmc-configure/5.0",
    "transaction_id": "",
    "pointing": {
        "target": {
            "reference_frame": "ICRS",
            "target_name": "Polaris Australis",
            "ra": "21:08:47.92",
            "dec": "-88:57:22.9",
            "ca_offset_arcsec": 0.0,
            "ie_offset_arcsec": 0.0
        },
        "correction": "UPDATE",
        "groups": [{
            "receptors": ["SKA001", "SKA036", "SKA063"],
            "field": {
                "target_name": "Cen-A",
                "reference_frame": "ICRS",
                "attrs": {
                    "c1": 201.365,
                    "c2": -43.0191667
                }
            },
            "trajectory": {
                "name": "fixed",
                "attrs": {
                    "x": 1.23,
                    "y": 4.56
                }
            },
            "projection": {
                "name": "SSN",
                "alignment": "ICRS"
            }
        }, {
            "receptors": ["SKA100"],
            "field": {
                "target_name": "Cen-A",
                "reference_frame": "ICRS",
                "attrs": {
                    "c1": 201.365,
                    "c2": -43.0191667
                }
            },
            "trajectory": {
                "name": "constant-velocity",
                "attrs": {
                    "x_rate": 1.23,
                    "y_rate": 4.56
                }
            },
            "projection": {
                "name": "SSN",
                "alignment": "ICRS"
            }
        }],
        "ie_offset_arcsec": 5.0,
        "ca_offset_arcsec": -5.0,
        "wrap_sector": 0
    },
    "dish": {
        "receiver_band": "5b",
        "interface": "https://schema.skao.int/ska-dish-configure/1.0",
        "band5_downconversion_subband": "1",
        "spfrx_processing_parameters": [{
            "dishes": ["SKA001"],
            "sync_pps": false,
            "attenuation_pol_x": 20.0,
            "attenuation_pol_y": 20.0,
            "saturation_threshold": 0.7,
            "noise_diode": {
                "pseudo_random": {
                    "binary_polynomial": 2,
                    "seed": 2,
                    "dwell": 2
                }
            }
        }]
    },
    "csp": {
        "interface": "https://schema.skao.int/ska-csp-configurescan/8.1",
        "common": {
            "config_id": "sbi-mvp01-20200325-00001-science_A",
            "frequency_band": "1"
        },
        "midcbf": {
            "frequency_band_offset_stream1": 80,
            "correlation": {
                "processing_regions": [{
                    "fsp_ids": [1, 2, 3, 4],
                    "receptors": ["SKA063", "SKA001", "SKA100"],
                    "start_freq": 350000000,
                    "channel_width": 13440,
                    "channel_count": 52080,
                    "sdp_start_channel_id": 0,
                    "integration_factor": 1
                }, {
                    "fsp_ids": [1],
                    "start_freq": 548437600,
                    "channel_width": 13440,
                    "channel_count": 14880,
                    "sdp_start_channel_id": 1,
                    "integration_factor": 10
                }]
            },
            "vlbi": {}
        }
    },
    "sdp": {
        "interface": "https://schema.skao.int/ska-sdp-configure/0.4",
        "scan_type": "target:a"
    },
    "tmc": {
        "scan_duration": 10.0,
        "partial_configuration": false
    }
}

https://schema.skao.int/ska-tmc-configure/5.0

type

object

properties

  • interface

URI of JSON schema applicable to this JSON payload.

type

string

  • transaction_id

A transaction id specific to the command

type

string

  • pointing

Pointing Mid TMC configure 5.0

Pointing configuration specification.

type

object

properties

  • wrap_sector

Cable wrap sector, with allowed values 0 and -1.

  • wrap_sector= 0 means move to the sector that allows the most clockwise rotation, the sector that allows azimuth 0 to +270 degrees.

  • wrap_sector= -1 means move to the other sector, the sector that allows azimuth 0 to -270 degrees.

If pointing.wrap_sector is not in the JSON, TMC will make no sector change.

allOf

type

integer

  • ca_offset_arcsec

Cross-elevation offset in arcseconds from the central pointing pointing defined by target’s ra+dec.

This is an optional field; if omitted, an offset of 0 arcseconds can be assumed.

type

number

  • ie_offset_arcsec

Elevation offset in arcseconds from the central pointing position defined by the ra+dec pair.

This is an optional field; if omitted, an offset of 0 arcseconds can be assumed.

type

number

  • groups

Receptor groups definitions.

Receptors assigned to a receptor group can be steered as a whole around the sky. Objects and attributes within the receptor group define the pointing coordinate and tracking/mapping strategy to use for the group.

type

array

items

  • 5.0*

type

object

properties

  • receptors

List of receptor IDs to assign to the receptor group for the upcoming scan. List values must be valid SKA receptor IDs, e.g., [“SKA001”, “SKA063”].

type

array

default

null

items

type

string

  • field

A union of the various standard sky direction representations supported by SKA, as defined in ADR-63.

default

null

Sky direction

  • trajectory

A union of the various standard trajectories supported by SKA, as defined in ADR-106.

default

null

Trajectory

  • projection

  • 5.0*

type

object

default

SIN

properties

  • name

Projection type. Must be one of ‘SIN’, ‘TAN’, ‘ARC’, ‘STG’, ‘CAR’, or ‘SSN’, though values are not case sensitive. Defaults to ‘SIN’.

The following projections are implemented:

  • Orthographic (SIN): This is the standard projection in aperture synthesis radio astronomy, as it ties in closely with the 2-D Fourier imaging equation and the resultant (l, m) coordinate system. It is the simple orthographic projection of AIPS.

  • Gnomonic (TAN): This is commonly used in optical astronomy. Great circles are projected as straight lines, so that the shortest distance between two points on the sphere is represented as a straight line interval (non-uniformly divided though).

  • Zenithal equidistant (ARC): This is commonly used for single-dish maps, and is obtained if relative (cross-el, el) coordinates are directly plotted (cross-elevation is azimuth scaled by the cosine of elevation).It preserves angular distances from the reference point.

  • Stereographic (STG): This is useful to represent polar regions and large fields. It preserves angles and circles.

  • Plate carree (CAR): This is a very simple cylindrical projection that directly maps azimuth and elevation to a rectangular (x, y) grid, and returns offsets from the reference point on this plane. The x offset is therefore equal to the azimuth offset, while the y offset is equal to the elevation offset. It does not preserve angles, distances or circles.

  • Swapped orthographic (SSN): This is the standard SIN projection with the roles of reference and target points reversed. It is useful for holography and other beam pattern measurements where a dish moves relative to a fixed beacon but the beam pattern is referenced to the boresight of the moving dish.

allOf

type

string

  • alignment

Projection alignment

type

string

additionalProperties

True

additionalProperties

True

  • target

Target TMC configure 5.0

DEPRECATED

Target coordinates

This field has been superseded by pointing.groups and is deprecated from schema version 4.1.

If pointing.groups is present, any value provided in pointing.target will be ignored.

type

object

properties

  • reference_frame

Target coordinates reference frame.

Validation of reference_frame is case sensitive. Allowed values are:

  • ICRS: target coordinates are specified using the International Celestial Reference System (ICRS).

  • special: target coordinates are to be determined at runtime via a KatPoint lookup. Setting reference_frame=’special’ requires that the target name be a valid object in the KatPoint catalogue. Any target RA and dec provided will be ignored when reference_frame=’special’.

allOf

type

string

  • target_name

celestial source

type

string

  • ra

Pointing Right Ascension coordinates.

type

string

  • dec

Pointing Declination coordinates.

type

string

  • ca_offset_arcsec

DEPRECATED: use pointing.ca_offset_arcsec.

If both pointing.ca_offset_arcsec and pointing.target.ca_offset_arcsec are set, then pointing.ca_offset_arcsec takes priority. Cross-elevation offset in arcseconds from the central pointing pointing defined by target’s ra+dec.

This is an optional field; if omitted, an offset of 0 arcseconds can be assumed.

type

number

  • ie_offset_arcsec

DEPRECATED: use pointing.ie_offset_arcsec.

If both pointing.ie_offset_arcsec and pointing.target.ie_offset_arcsec are set, then pointing.ie_offset_arcsec takes priority. Elevation offset in arcseconds from the central pointing position defined by the ra+dec pair.

This is an optional field; if omitted, an offset of 0 arcseconds can be assumed.

type

number

additionalProperties

True

  • correction

Optional operation to apply to the pointing correction model. Allowed values are MAINTAIN, UPDATE, and RESET, which have the following meaning:

  • MAINTAIN: continue applying the current pointing correction model

  • UPDATE: wait for (if necessary) and apply new pointing calibration solution

  • RESET: reset the applied pointing correction to the pointing model defaults

Validation of correction values is case sensitive.

If pointing.correction is not specified, the default operation is to make no change to the pointing correction model, equivalent to setting correction=MAINTAIN.

allOf

type

string

additionalProperties

True

  • csp

CSP config 8.1

CSP configuration specification.

type

object

properties

  • interface

type

string

  • transaction_id

A transaction ID specific to the command

type

string

  • subarray

subarray 8.1

subarray section, containing the parameters relevant only for the current sub-array device. This section is not forwarded to any subelement.

type

object

properties

  • subarray_name

Name and scope of current subarray the sub-array.

type

string

additionalProperties

False

  • pss

PSS configuration schema 1.2

Top-level control configuration for PSS

type

object

properties

  • transaction_id

A transaction id specific to the control command

type

string

  • beam

type

array

items

PSS_beam_config_1.2

  • config_id

Configuration ID

type

integer

  • cheetah

Cheetah application configs for each machine

type

array

items

PSS configuration schema 1.2

type

object

properties

  • beams

List of up to 3 beams

type

array

items

PSS_beams_config_1.2

  • cheetah_id

Pipeline ID for the cheetah instance.

type

integer

additionalProperties

False

  • ddtr

PSS_ddtr_config_1.2

  • sps

PSS_sps_config_1.2

  • interface

type

string

additionalProperties

False

  • common

Common section, containing the parameters and the sections belonging to all CSP subsystems. This section is forwarded to all sub-elements.

Common_configuration_schema_8.1

  • midcbf

Correlator and Beamformer specific parameters. This section contains the parameters relevant only for Mid.CBF sub-element. This section is forwarded only to Mid.CBF subelement.

Mid.CBF_config_8.1

  • pst

Main configuration for the CSP Pulsar timing sub-system

PST_configure_3.0

additionalProperties

False

  • sdp

SDP configure 1.0

SDP configuration specification.

type

object

properties

  • interface

type

string

  • transaction_id

type

string

  • scan_type

type

string

  • new_scan_types

type

array

items

A scan configuration for SDP. Once AssignResources has been performed successfully, subsequent Configure commands can select from these scan types in order to coordinate SDP with other sub-systems participating in the observation - for instance to switch between targets, or perform special calibration scans.

Scan_type_1.0

additionalProperties

True

  • tmc

TMC configure 5.0

TMC Mid TMC configuration specification.

type

object

properties

  • scan_duration

Scan duration in seconds.

Value must be >= 0.0

allOf

type

number

  • partial_configuration

Partial Configuration Flag.

Partial configurations assume that previously set state is maintained, and undergo less strict JSON validation.

type

boolean

additionalProperties

True

  • dish

DishLMC configure Scan parameters 1.0

Dish band configuration

type

object

properties

  • interface

URI of JSON schema for this command’s JSON payload.

type

string

  • receiver_band

The requested band of configuration.

type

string

  • band5_downconversion_subband

The requested band5_downconversion_subband. Allowed values are “1”, “2”, and “3”.

Only allowed if receiver_band specified is “5b”.

type

string

default

null

  • spfrx_processing_parameters

List of requested SPFRx processing parameters per dish.

type

array

default

null

items

spfrx_processing_parameters_1.0

additionalProperties

True

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.

ICRS_sky_direction_5.0

A sky direction defined in the AltAz reference frame

AltAz_sky_direction_5.0

A sky direction defined in the Galactic reference frame.

Galactic_sky_direction_5.0

A sky direction whose coordinates are defined in Katpoint.

Special_sky_direction_5.0

A sky direction defined by a Two-Line Element (TLE) set.

Two_Line_Element_sky_direction_5.0

ICRS_sky_direction_5.0

A sky direction defined in the ICRS reference frame.

type

object

properties

  • target_name

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

  • reference_frame

Must be “icrs” for a sky direction defined in the ICRS reference

frame.

Validation is case-insensitive.

type

string

  • attrs

  • 5.0*

Attributes for an ICRS sky direction

type

object

properties

  • c1

The longitude coordinate, specifying degrees right ascension in the ICRS reference frame.

Value must be in the range 0 <= c1 < 360.

type

number

  • c2

The latitude coordinate, specifying degrees declination in the ICRS reference frame.

Value must be in the range -90 <= c2 <= 90.

type

number

  • pm_c1

Longitudinal proper motion of target, measured in arcseconds per year.

type

number

default

0.0

  • pm_c2

Latitudinal proper motion of target, measured in arcseconds per year.

type

number

default

0.0

  • epoch

Epoch of proper motion, giving the date when the proper motion offset was zero.

type

number

default

2000.0

  • parallax

The parallax in seconds of arc.

type

number

default

0.0

  • radial_velocity

Radial velocity along the line of sight in m/s.

type

number

default

0.0

additionalProperties

True

additionalProperties

True

AltAz_sky_direction_5.0

A sky direction defined in the AltAz reference frame

type

object

properties

  • target_name

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

  • reference_frame

Fixed as “altaz” for a sky direction defined in the AltAz

reference frame.

Validation is case-insensitive.

type

string

  • attrs

  • 5.0*

Allowed attributes for an AltAz sky direction

type

object

properties

  • c1

The azimuth coordinate in degrees.

Value must be in the range 0 <= c1 < 360.

type

number

  • c2

The elevation coordinate in degrees.

Value must be in the range 0 <= c2 <= 90.

type

number

additionalProperties

True

additionalProperties

True

Galactic_sky_direction_5.0

A sky direction defined in the Galactic reference frame.

type

object

properties

  • target_name

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

  • reference_frame

Must be “galactic” for a sky direction defined in the Galactic

reference frame.

Validation is case-insensitive.

type

string

  • attrs

  • 5.0*

Attributes for a Galactic sky direction

type

object

properties

  • c1

The longitude coordinate, specifying degrees right ascension in the Galactic reference frame.

Value must be in the range 0 <= c1 < 360.

type

number

  • c2

The latitude coordinate, specifying degrees declination in the Galactic reference frame.

Value must be in the range -90 <= c2 <= 90.

type

number

  • pm_c1

Longitudinal proper motion of target, measured in arcseconds per year.

type

number

default

0.0

  • pm_c2

Latitudinal proper motion of target, measured in arcseconds per year.

type

number

default

0.0

  • epoch

Epoch of proper motion, giving the date when the proper motion offset was zero.

type

number

default

2000.0

  • parallax

The parallax in seconds of arc.

type

number

default

0.0

  • radial_velocity

Radial velocity along the line of sight in m/s.

type

number

default

0.0

additionalProperties

True

additionalProperties

True

Special_sky_direction_5.0

A sky direction whose coordinates are defined in Katpoint.

type

object

properties

  • target_name

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

  • reference_frame

Must be “special” for a catalogue sky direction.

Validation is case-insensitive.

type

string

additionalProperties

True

Two_Line_Element_sky_direction_5.0

A sky direction defined by a Two-Line Element (TLE) set.

type

object

properties

  • target_name

A name for the target. For a TLE sky direction, this could be the name of a satellite in orbit.

type

string

  • reference_frame

Must be “tle” for a sky direction defined in the TLE reference

frame.

Validation is case-insensitive.

type

string

  • attrs

  • 5.0*

Attributes for a TLE sky direction.

type

object

properties

  • line1

First line of a two-line element (TLE) sky direction.

type

string

  • line2

Second line of a two-line element (TLE) sky direction.

type

string

additionalProperties

True

additionalProperties

True

Trajectory

A union of the various standard trajectories supported by SKA, as defined in ADR-106.

anyOf

DEPRECATED - A mosaic consisting of a set of fixed-offsetpointings.

Mosaic_trajectory___DEPRECATED_5.0

A trajectory defined by a fixed offset from a reference coordinate.

Fixed_offset_trajectory_5.0

A trajectory defined by a constant velocity and fixed offsetfrom a reference coordinate.

Constant_velocity_trajectory_5.0

Mosaic_trajectory___DEPRECATED_5.0

DEPRECATED - A mosaic consisting of a set of fixed-offsetpointings.

type

object

properties

  • name

Must be “mosaic” for a mosaic trajectory.

Validation is case-insensitive.

type

string

  • attrs

  • 5.0*

Attributes for a mosaic trajectory

type

object

properties

  • x_offsets

x offsets in arcseconds from the reference fieldposition.

  • y_offsets

y offset in arcseconds from the reference fieldposition.

additionalProperties

True

additionalProperties

True

Fixed_offset_trajectory_5.0

A trajectory defined by a fixed offset from a reference coordinate.

type

object

properties

  • name

Must be “fixed” for a fixed-offset trajectory.

Validation is case-insensitive.

type

string

  • attrs

  • 5.0*

Attributes for a fixed-offset trajectory

type

object

properties

  • x

Fixed x offset in arcseconds from the reference field position.

type

string

  • y

Fixed y offset in arcseconds from the reference field position.

type

string

additionalProperties

True

additionalProperties

True

Constant_velocity_trajectory_5.0

A trajectory defined by a constant velocity and fixed offsetfrom a reference coordinate.

type

object

properties

  • name

Must be “constant-velocity” for a constant velocity trajectory.

Validation is case-insensitive.

type

string

  • attrs

  • 5.0*

Attributes for a constant velocity trajectory

type

object

properties

  • x

Initial x offset in arcseconds from the reference field position.

type

string

default

0.0

  • y

Initial y offset in arcseconds from the reference field position.

type

string

default

0.0

  • x_rate

x tracking rate in arcseconds per second.

type

string

  • y_rate

y tracking rate in arcseconds per second.

type

string

additionalProperties

True

additionalProperties

True

PSS_beam_config_1.2

type

object

properties

  • beam_id

Search Beam ID.

type

integer

  • ra

Right Ascension of sub-array beam target, in degrees.

type

number

default

null

  • dec

Declination of sub-array beam target, in degrees.

type

number

default

null

  • reference_frame

reference frame for pointing coordinates

default

null

allOf

type

string

enum

ICRS, HORIZON

  • centre_frequency

Centre frequency of the search beam.

type

number

  • beam_delay_centre

Beam delay center, relative to the array delay center.

anyOf

type

number

type

string

  • dest_host

Per beam destination host address for PSS output.

type

string

default

null

  • dest_port

Per beam destination port for PSS output.

type

integer

default

null

additionalProperties

False

PSS_beams_config_1.2

type

object

properties

  • beam

PSS_pss_beam_config_1.2

additionalProperties

False

PSS_pss_beam_config_1.2

type

object

properties

  • active

enable this beam.

type

boolean

  • beam_id

Beam ID

type

integer

  • sinks

PSS_sinks_config_1.2

  • source

PSS_source_config_1.2

additionalProperties

False

PSS_sinks_config_1.2

type

object

properties

  • channels

PSS_channels_config_1.2

  • sink_configs

PSS_sink_configs_config_1.2

additionalProperties

False

PSS_channels_config_1.2

type

object

properties

  • sps_events

PSS_sps_events_config_1.2

additionalProperties

False

PSS_sps_events_config_1.2

type

object

properties

  • active

activate the channel.

type

boolean

  • sink

List of sink ids for sps_events.

type

array

items

Sink configuration schema 1.2

Sink configuration for PSS

type

object

properties

  • sink_id

Sink ID

type

string

additionalProperties

False

additionalProperties

False

PSS_sink_configs_config_1.2

type

object

properties

  • spccl_files

PSS_spccl_files_config_1.2

  • spccl_sigproc_files

PSS_spccl_sigproc_files_config_1.2

additionalProperties

False

PSS_spccl_files_config_1.2

type

object

properties

  • extension

extension.

type

string

  • dir

directory.

type

string

  • sink_id

Sink ID

type

string

additionalProperties

False

PSS_spccl_sigproc_files_config_1.2

type

object

properties

  • spectra_per_file

spectra per file.

type

integer

  • dir

directory.

type

string

  • extension

extension.

type

string

  • candidate_window

PSS_candidate_window_config_1.2

  • sink_id

Sink ID

type

string

additionalProperties

False

PSS_candidate_window_config_1.2

type

object

properties

  • ms_before

Number of milliseconds before the candidate start.

type

number

  • ms_after

Number of milliseconds after the candidate end time.

type

number

additionalProperties

False

PSS_source_config_1.2

type

object

properties

  • sigproc

PSS_sigproc_config_1.2

  • udp_low

PSS_UDP_config_1.2

additionalProperties

False

PSS_sigproc_config_1.2

type

object

properties

  • file

specify the sigproc file(s) to read as input data.

type

string

  • chunk_samples

the number of time samples in each chunk.

type

integer

  • default-nbits

specify the default number of bits to use.

type

integer

  • active

enable udp low

type

boolean

additionalProperties

False

PSS_UDP_config_1.2

type

object

properties

  • number_of_threads

the number of threads to run LOW ingest services

type

integer

  • spectra_per_chunk

the number of time slices in each chunk.

type

integer

  • number_of_channels

Total number of frequency channels.

type

integer

  • max_buffers

the max number of udp packet buffers to use.

type

integer

  • active

enable udp low

type

boolean

additionalProperties

False

PSS_ddtr_config_1.2

type

object

properties

  • cpu

dedispersion of time frequency data on CPU.

type

object

properties

  • active

type

boolean

additionalProperties

False

  • fpga

Dedispersion of time frequency data on CPU.

type

object

properties

  • active

type

boolean

additionalProperties

True

  • gpu_bruteforce

A GPU brute force algorithm to perform DDTR.

type

object

properties

  • active

type

boolean

  • copy_dmtrials_to_host

type

boolean

additionalProperties

True

  • klotski

A Klotski algorithm to perform DDTR.

type

object

properties

  • active

type

boolean

additionalProperties

True

  • klotski_bruteforce

A Klotski brute force algorithm to perform DDTR.

type

object

properties

  • active

type

boolean

additionalProperties

True

  • dedispersion

type

array

items

PSS_dedispersion_config_1.2

  • dedispersion_samples

max samples to process in each call to the dedisperser

type

integer

additionalProperties

False

PSS_dedispersion_config_1.2

type

object

properties

  • start

start DM in cm^-3 pc.

type

number

  • end

end DM in cm^-3 pc (inclusive).

type

number

  • step

DM step size in cm^-3 pc.

type

number

additionalProperties

False

PSS_sps_config_1.2

type

object

properties

  • cpu

dedispersion of time frequency data on CPU.

type

object

properties

  • active

type

boolean

  • samples_per_iteration

type

integer

  • number_of_widths

type

integer

additionalProperties

True

  • threshold

single pulse detection threshold in sigmas.

type

number

  • klotski

PSS_klotski_config_1.2

  • klotski_bruteforce

PSS_klotski_config_1.2

additionalProperties

False

PSS_klotski_config_1.2

type

object

properties

  • active

Enable klotski sps mode.

type

boolean

  • pulse_widths

Matched filter widths (in bins).

type

string

additionalProperties

False

Common_configuration_schema_8.1

Common section, containing the parameters and the sections belonging to all CSP subsystems. This section is forwarded to all sub-elements.

type

object

properties

  • config_id

type

string

  • eb_id

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]+$

  • band_5_tuning

Center frequency for the Band-of-Interest. Required if Band is 5a or 5b; not specified for other Bands (not configurable for Band 1 and 2).

Input for Band 5a and 5b consists of two 2.5 GHz streams; the center frequency can be independently tuned for each stream.

The following nomenclature is used to refer to Band 5a and 5b streams: 5a1, 5a2, 5b1, 5b2.

type

array

items

type

number

  • frequency_band

Frequency band applies for all the receptors (VCCs) that belong to the sub-array.

Frequency Band

Sky Frequency Range (GHz)

1

0.35 - 1.05

2

0.95 - 1.76

5a

4.60 - 8.50

5b

8.30 - 15.30

Valid bands include: 1, 2, 5a, 5b. Bands 3 and 4 are not included in the current implementation but could be supported in the future.

type

string

pattern

^(1|2|5(a|b))$

  • band5_downconversion_subband

Select the Band5 Down-converter sub-bands

type

string

additionalProperties

False

Mid.CBF_config_8.1

Correlator and Beamformer specific parameters. This section contains the parameters relevant only for Mid.CBF sub-element. This section is forwarded only to Mid.CBF subelement.

type

object

properties

  • frequency_band_offset_stream1

Optionally, an offset can be specified so that the entire observed band is shifted in Hz (to accommodate a Zoom Window that crosses a ‘natural’ Frequency Slice boundary). If specified, applies for all the receptors in the sub-array.

Bands 1 and 2: input from the receptor consists of a single data stream; the Frequency Band Offset (FBO) should be specified for Stream 1 only.

Bands 5a and 5b: input from the receptor consists of two data streams; the FBO can be specified for each stream independently. Note: For Band 5a and 5b the frequency shift is performed by the receptor (DISH).

Range: Integer from -100000000 to 100000000 inclusive (+/- 0.5 * Frequency Slice BW)

type

integer

  • frequency_band_offset_stream2

See frequencyBandOffsetStream1

Range: Integer from -100000000 to 100000000 inclusive (+/- 0.5 * Frequency Slice BW)

type

integer

  • rfi_flagging_mask

Specified as needed in advance of the scan start and/or during the scan. Delivered using publish-subscribe mechanism (see ICD Section 3.8.8.5.7).

type

object

properties

additionalProperties

False

  • correlation

Correlation specific parameters

Correlation_config_8.1

  • pst_bf

PST Beam-Former specific parameters

PST_BF_config_8.1

  • vlbi

Very Long Baseline Interferometry specific parameters. To be borrowed from IICD This section contains the parameters relevant only for VLBI. This section is forwarded only to CSP subelement.

VLBI_config_8.1

  • search_window

type

array

items

Up to two 300 MHz Search Windows can be optionally configured and used as input for Transient Data Capture and/or Pulsar Search beam-forming.

Search_window_config_8.1

additionalProperties

False

Correlation_config_8.1

Correlation specific parameters

type

object

properties

  • processing_regions

type

array

items

Parameters that define a processing region of spectrum

Correlation_Processing_Region_config_8.1

additionalProperties

False

Correlation_Processing_Region_config_8.1

Parameters that define a processing region of spectrum

type

object

properties

  • fsp_ids

List of FSPs to be used for the processing region

For non-zoom, the limit is 13 because that is the number of FSPs needed to process data from one 2.5 GHz sub-band, which is the maximum bandwidth that can be stitched together. Band 5 sub-bands (a and b) cannot be combined in a single processing region.

Ranges:

Array Length: Array of 1 to 26 Integers inclusive

Array Element: Integer from 1 to 27 inclusive

Notes: AA0.5 supports an array of 1 to 4 integers AA1 supports an array of 1 to 8 integers

type

array

items

type

integer

  • receptors

Optionally a subset of receptors to be correlated can be specified. If not specified, all receptors that belong to the subarray are cross-correlated (i.e. visibilities for all the baselines in the subarray are generated and transmitted to SDP).

Valid receptor IDs include:

SKA dishes: “SKAnnn”, where nnn is a zero padded integer in the range of 001 to 133.

MeerKAT dishes: “MKTnnn”, where nnn is a zero padded integer in the range of 000 to 063.

type

array

default

null

items

anyOf

type

string

pattern

^SKA((?!000)0[0-9][0-9]|1[0-2][0-9]|13[0-3])$

type

string

pattern

^MKT0([0-5][0-9]|6[0-3])$

  • start_freq

Center frequency of the first fine channel in the output product in Hz.

Range: Integer from 0 to 15400000000 inclusive

Notes:

AA0.5 Supports start_freq of 0Hz to 1980MHz

AA0.5 Mid.CBF will produce a warning when the bandwidth [(start_freq - channel_width/2) to (start_freq + (channel_count - 1) * channel_width + channel_width/2)] of the region is outside the range of bands 1 & 2 (350MHz - 1760MHz)

type

integer

  • channel_width

The width of each fine channel in Hz.

Allowed channel widths are a fraction/multiple of the default fine channel bandwidth: 13440 Hz.

Zoom mode will use channel width less than 13440 Hz.

Channel averaging will use channel width more than 13440 Hz.

Range: Enum value that is one of:

210
420
840
1680
3360
6720
13440
26880
40320
53760
80640
107520
161280
215040
322560
416640
430080
645120

Note: AA0.5/1 only supports 13440 channel width value

type

integer

  • channel_count

Number of fine channels in the output product.

Range: Integer from 1 to 2147483647 inclusive

Note: AA0.5/1: Integer from 1 to 58982 inclusive and must be a multiple of 20

type

integer

  • sdp_start_channel_id

In the output products (visibility packets) sent to SDP, Mid.CBF will number channels sequentially in increments of 1 starting at the sdp_start_channel_id.

sdp_start_channel_id allows TMC to configure Mid.CBF to provide SDP with unique channel IDs for every channel in a sub-array when multiple processing regions are used. Mid.CBF does not require or validate that each channel in a sub-array will have a unique channel ID. The channel ID provided to SDP will be the zero based channel number within the processing region plus the sdp_start_channel_id specified for the processing region. This means the channel with the center frequency of start_freq will have a channel ID of sdp_start_channel_id.

Range: Integer from 0 to 2147483647 inclusive

type

integer

  • integration_factor

Integration time for the correlation products, defines multiple of 140 milliseconds.

integration_factor value

Interval (s)

1

0.14

2

0.28

3

0.42

4

0.56

5

0.70

6

0.84

7

0.98

8

1.12

9

1.26

10

1.40

Range: Integer from 1-10 inclusive

type

integer

additionalProperties

False

PST_BF_config_8.1

PST Beam-Former specific parameters

type

object

properties

  • processing_regions

allOf

type

array

items

Parameters that define a processing region of spectrum

PST_Processing_Region_config_8.1

allOf

At least one processing region

Processing regions have unique FSP IDs

first output_host mapping start channel matches pst_start_channel_id

first output_port mapping start channel matches pst_start_channel_id

first output_link_map mapping start channel matches pst_start_channel_id

additionalProperties

False

PST_Processing_Region_config_8.1

Parameters that define a processing region of spectrum

type

object

properties

  • fsp_ids

List of FSPs to be used for the processing region

Ranges:

  • Array Length: Array of 1 to 26 Integers inclusive

  • Array Element: Integer from 1 to 27 inclusive

Notes:

For AA0.5/1:

  • Array Length of 1 integer

  • Array values of range 1-8 inclusive

allOf

type

array

items

type

integer

allOf

Array length within the valid of range of 1 to 26 inclusive

Array values within the valid range of 1 to 27 inclusive

Array values are unique

  • start_freq

Center frequency of the first fine channel in the output product in Hz.

Range: Integer from 0 Hz to 15399982080 Hz inclusive

Checks:

  • Must be a multiple of 53760 Hz

Notes:

For AA0.5/1:

start_freq is a Enum value that is one of:

Band 1:

296862720
495075840
693235200
891448320

Band 2:

891448320
1089607680
1287767040
1485980160
1684139520

allOf

type

integer

allOf

Is within the valid range of 0 to 15399982080 inclusive

is a multiple of 53760 Hz

  • channel_count

Number of fine channels in the output product.

Max channel_count calculated as:

198,180,164 Hz per FS * 13 FS / 53760 Hz per channel = 47,923

Range:

  • Integer from 1 to 47923 inclusive

Notes:

For AA0.5/1:

  • The only valid value is 3700

allOf

type

integer

Is within the valid range of 1 to 47923 inclusive

  • pst_start_channel_id

Starting value for the channel numbering in the processing region. Used only to number channels in the output product (timing beam).

Channels in the output product are numbered sequentially starting with the pst_start_channel_id. The channel with the centre frequency of start_freq will have a channel ID of pst_start_channel_id. The next channel will have the channel ID of pst_start_channel_id + 1.

Range:

  • Integer from 0 to 2147483647 inclusive

allOf

type

integer

Is within the valid range of 0 to 2147483647 inclusive

  • timing_beams

allOf

type

array

items

Parameters that define a timing beam

Timing_beam_config_8.1

Is array length within the valid range of 1 to 16 inclusive

Parameters that define a timing beam

Range:

  • Array length between 1 to 16 inclusive.

Notes:

For AA0.5/1:

  • Array length of 1

additionalProperties

False

Timing_beam_config_8.1

Parameters that define a timing beam

type

object

properties

  • timing_beam_id

Identifier for a beam timing

Each timing_beam_id can only be used by one subarray at a time.

Range:

  • 1 to 16 inclusive

allOf

type

integer

Is within the valid range of 1 to 16 inclusive

  • receptors

Optionally a subset of receptors to be included in the timing beam can be specified. If not specified, all receptors that belong to the subarray are included in the timing beam.

Valid receptor IDs include:

  • SKA dishes: “SKAnnn”, where nnn is a zero padded integer in the range of 001 to 133.

  • MeerKAT dishes: “MKTnnn”, where nnn is a zero padded integer in the range of 000 to 063.

Note:

For AA0.5/1:

  • If receptors are specified for one FSP, the same receptors need to be specified for all the FSPs.

type

array

default

null

items

anyOf

type

string

pattern

^SKA((?!000)0[0-9][0-9]|1[0-2][0-9]|13[0-3])$

type

string

pattern

^MKT0([0-5][0-9]|6[0-3])$

  • output_link_map

Output links to emit timing beam on for every channel, given as a list of start channel ID to link ID. Where no value is given for concrete channel, the previous value should be used.

Ranges:

Start Channel ID: Integer from 0 to 14879 inclusive

Link ID: Positive Integer of value

Checks:

  • At least one output_link_map mapping required

  • Start Channel IDs are in ascending order

  • In the first mapping entry, the Start Channel ID must match pst_start_channel_id

Note:

For AA0.5/1:

  • output_link_map only allows a single entry with a link ID of 1.

allOf

type

array

items

type

array

items

type

integer

allOf

At least one mapping is provided

Each mapping is of length 2

Start channel ID is within the valid range of 0 to 2147483647 inclusive

Start channel IDs are in ascending order

Link value greater than 0

  • output_host

Output host to send timing beam to for every channel, given as a list of start channel ID to host IP addresses in dot-decimal notation. Where no value is given for a concrete channel, the previous value should be used.

The first start channel ID will be the pst_start_channel_id

Ranges:

  • Start Channel ID: Integer from 0 to 2147483647 inclusive

  • Host IP: String w/ any valid IPv4 in dot-decimal notation [0.0.0.0-255.255.255.255]

Checks:

  • At least one output_host mapping required

  • Start channel IDs are in ascending order

  • In the first mapping entry, the Start Channel ID must match pst_start_channel_id

Note:

For AA0.5/1 :

  • Only one output_host mapping allowed

  • Difference in Start chanenel IDs are a multiple of 185

  • Start Channel ID Range is between pst_start_channel_id and (pst_start_channel_id + (channel_count - 185)) inclusive

allOf

type

array

items

type

array

items

anyOf

type

integer

type

string

allOf

At least one mapping is provided

Start channel IDs are within the valid range of 0 to 2147483647 inclusive

Start channel IDs are in ascending order

Host must be a valid IPv4 address

  • output_port

Output port to send beam timing to for every channel, given as a list of start channel ID to port number. When no port number is given for a concrete channel, the previous value will be used. The format is a restricted ska_telmodel.channel_map (see restrictions below)

Ranges:

  • Start Channel ID: Integer from 0 to 2147483647 inclusive

  • Port Number: Integer from 0 to 65535 inclusive

Format Restrictions:

  • At least one output_port mapping is required

  • The first start channel ID in the list must be pst_start_channel_id

  • Start channel IDs must be in ascending order

Note:

For AA0.5/1:

  • Only one output_port entry allowed

  • Start channel IDs must be in increments of 185

  • At most 3700 channels can be sent to the same port per host

allOf

type

array

items

type

array

items

type

integer

allOf

At least one mapping is provided

Each mapping is of length 2

Start channel IDs are within the valid range of 0 to 2147483647 inclusive

Start channel IDs are in ascending order

Port numbers are with the valid range of 0 to 65535 inclusive

additionalProperties

False

VLBI_config_8.1

Very Long Baseline Interferometry specific parameters. To be borrowed from IICD This section contains the parameters relevant only for VLBI. This section is forwarded only to CSP subelement.

type

object

properties

  • dummy_param

type

string

additionalProperties

False

Search_window_config_8.1

Up to two 300 MHz Search Windows can be optionally configured and used as input for Transient Data Capture and/or Pulsar Search beam-forming.

type

object

properties

  • search_window_id

Identifier of the 300MHz Search Window. Unique within a sub-array.

type

integer

  • search_window_tuning

The Search Window tuning is provided in absolute terms as RF center frequency. The Search Window must be placed within the observed band. If partially out of the observed Band a warning is generated. If completely outside of the observed Band an exception is generated.

type

integer

additionalProperties

False

PST_configure_3.0

Main configuration for the CSP Pulsar timing sub-system

type

object

properties

  • beams

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

  • beam_id

Configuration for a PST beam ID in low csp

type

integer

  • scan

PST specific scan configuration parameters.

default

null

PST_scan_configuration_3.0

additionalProperties

False

additionalProperties

False

PST_scan_configuration_3.0

PST specific scan configuration parameters.

type

object

properties

  • centre_frequency

Centre frequency of the total (critical) bandwidth spanned by the frequency channels.

Units: Hz Range: 50e6 to 12800e6 Keyword: OBSFREQ

type

number

  • total_bandwidth

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

  • pst_processing_mode

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 observation_mode but has been renamed to be clear that this is specific about how PST will process that data from the correlator beam former (CBF).

Note: The values come from the Python enum PstProcessingMode` as defined in the SKA Control Model project.

Keyword: OBSMODE

allOf

type

string

enum

PULSAR_TIMING, DETECTED_FILTERBANK, FLOW_THROUGH, VOLTAGE_RECORDER, VLBI

  • observer_id

The observer in charge of the observations.

Keyword: OBSERVER

type

string

  • project_id

The project that the observations are for.

Keyword: PROJID

type

string

  • target

A union of the various standard sky direction representations supported by SKA, as defined in ADR-63.

Sky direction

  • delay_centre

The telescope delay centre in International Terrestrial Reference Frame (ITRF) coordinates.

Units: metres Keyword: DELAY_CENTRE

type

array

items

type

number

  • receiver_id

The receiver name or ID.

Keyword: FRONTEND

type

string

  • max_scan_length

The maximum length of the observation.

Units: seconds Range: 30 - 43200 Keyword: SCANLEN_MAX

type

number

  • subint_duration

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

  • receptors

An array of receptor IDs for the receptors included in the sub-array.

Keyword: ANTENNA

type

array

items

type

string

  • receptor_weights

Weight for each receptor.

Range: 0 - 1.0 Keyword: ANT_WEIGHTS

type

array

items

type

number

  • rfi_frequency_masks

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

  • pt

PST specific parameters for the ‘PULSAR_TIMING’ mode configuration.

default

null

PST_PULSAR_TIMING_mode_configuration_3.0

  • df

PST specific parameters for the ‘DYNAMIC_SPECTRUM’ mode configuration.

default

null

PST_DYNAMIC_SPECTRUM_mode_configuration_3.0

  • ft

PST specific parameters for the ‘FLOW_THROUGH’ mode configuration.

default

null

PST_FLOW_THROUGH_mode_configuration_3.0

  • timing_beam_id

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

False

PST_PULSAR_TIMING_mode_configuration_3.0

PST specific parameters for the ‘PULSAR_TIMING’ mode configuration.

type

object

properties

  • dispersion_measure

The dispersion measure for coherent/incoherent de-dispersion.

Units: pccm^-3 Range: 0 - 100000 Keyword: DM

type

number

  • rotation_measure

The rotation measure for phase-coherent Faraday rotation correction.

Units: radians per metre squared Keyword: RM

type

number

default

null

  • ephemeris

The ephemeris of the pulsar being observed.

Units: PSRCAT compatible ASCII string Keyword: EPHEMERIS

type

string

  • pulsar_phase_predictor

Pulsar phase predictor generated from ephemeris.

Units: TEMPO2 compatible ASCII string Keyword: PREDICTOR

type

string

  • output_frequency_channels

The number of output frequency channels. This must be between 1 and the number of observation channels.

Keyword: OUTNCHAN

type

integer

  • output_phase_bins

The number of output phase bins.

Range: 64 - 2048 Keyword: OUTNBIN

type

integer

  • num_sk_config

The number of spectral kurtosis (SK) configurations to apply.

Keyword: N_SK

type

integer

  • sk_config

List of spectral kurtosis configurations.

type

array

items

PST specific parameters for the spectral kurtosis (SK) for the ‘PULSAR_TIMING’ mode.

PST_spectral_kurtosis_configuration_3.0

  • target_snr

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_3.0

PST specific parameters for the spectral kurtosis (SK) for the ‘PULSAR_TIMING’ mode.

type

object

properties

  • sk_range

Frequency ranges for each spectral kurtosis (SK) configuration.

Units: Hz Keyword: SK_RNG

type

array

items

type

number

  • sk_integration_limit

The number of input time samples integrated into each spectral kurtosis (SK) statistic.

Range: 64 - 1024 Keyword: SK_INTS

type

integer

  • sk_excision_limit

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_3.0

PST specific parameters for the ‘DYNAMIC_SPECTRUM’ mode configuration.

type

object

properties

  • dispersion_measure

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

  • rotation_measure

The rotation measure for phase-coherent Faraday rotation correction.

Units: radians per metre squared Keyword: RM

type

number

default

null

  • output_frequency_channels

The number of output frequency channels. This must be between 1 and the number of observation channels.

Keyword: OUTNCHAN

type

integer

  • stokes_parameters

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

  • num_bits_out

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

  • time_decimation_factor

The number of input samples per output time sample when in Dynamic Spectrum mode.

Keyword: TDEC_FB

type

integer

  • frequency_decimation_factor

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

  • num_sk_config

The number of spectral kurtosis (SK) configurations to apply.

Keyword: N_SK

type

integer

default

null

  • sk_config

List of spectral kurtosis configurations.

type

array

default

null

items

PST specific parameters for the spectral kurtosis (SK) for the ‘PULSAR_TIMING’ mode.

PST_spectral_kurtosis_configuration_3.0

  • requantisation_scale

Scale factor to govern the dynamic range for fixed precision output to be applied during re-quantisation.

Keyword: DIGITIZER_SCALE

type

number

  • requantisation_length

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_3.0

PST specific parameters for the ‘FLOW_THROUGH’ mode configuration.

type

object

properties

  • channel_polarisation_selection

PST specific parameters used for performing channel and polarisation selection of input data. This is used within the FLOW_THROUGH processing mode.

PST_channel_and_polarisation_selection_configuration_3.0

  • rescale

PST specific parameters used for rescaling of data before requantisation. This is used within the FLOW_THROUGH processing mode.

PST_Rescale_configuration_3.0

  • requantisation

type

null

additionalProperties

False

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

  • channels

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

  • polarisations

The polarisations to be recorded.

Valid values: A, B, or Both Keyword: POLN_FT

allOf

type

string

enum

A, B, Both

additionalProperties

False

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

  • algorithm

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

default

MedianMAD

allOf

type

string

enum

MedianMAD, MeanStdDev

  • periodic_update

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

  • timescale

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

False

Scan_type_1.0

A scan configuration for SDP. Once AssignResources has been performed successfully, subsequent Configure commands can select from these scan types in order to coordinate SDP with other sub-systems participating in the observation - for instance to switch between targets, or perform special calibration scans.

type

object

properties

  • scan_type_id

type

string

  • reference_frame

Specification of the reference frame or system for a set of pointing coordinates (see ADR-49)

type

string

default

null

  • ra

Right Ascension in degrees (see ADR-49)

type

string

default

null

  • dec

Declination in degrees (see ADR-49)

type

string

default

null

  • channels

type

array

default

null

items

Informs SDP ingest about the expected channel configuration, especially which frequencies are expected to be mapped to which channel ID. Note that channel IDs are not guaranteed to be continuous, so this might involve gaps and/or strides.

Scan_channels_1.0

additionalProperties

True

Scan_channels_1.0

Informs SDP ingest about the expected channel configuration, especially which frequencies are expected to be mapped to which channel ID. Note that channel IDs are not guaranteed to be continuous, so this might involve gaps and/or strides.

type

object

properties

  • count

Number of channels

type

integer

  • start

First channel ID

type

integer

  • stride

Distance between subsequent channel IDs

type

integer

default

null

  • freq_min

Lower bound of first channel

type

number

  • freq_max

Upper bound of last channel

type

number

  • link_map

Channel map that specifies which network link is going to get used to send channels to SDP. Intended to allow SDP to optimise network and receive node configuration.

type

array

default

null

items

additionalProperties

True

spfrx_processing_parameters_1.0

type

object

properties

  • dishes

List of Dish IDs to apply the processing parameters.

If “all” is specified then the same parameters will be applied to all dishes.

type

array

default

null

items

type

string

  • sync_pps

Synchronize the SPFRx to the WR-1PPS clock. The default value of sync_pps is true if not specified.

type

boolean

default

null

  • attenuation_pol_x

The requested aggregate Pol X attenuation of both attenuators. Must be in range 0 - max value for that particular band.

type

number

default

null

  • attenuation_1_pol_x

The requested Pol X attenuation of attenuator 1. Must be in range 0-31.75, and the sum of attenuator 1 + attenuator 2 must not exceed the maximum for that band.

type

number

default

null

  • attenuation_2_pol_x

The requested Pol Y attenuation of attenuator 2. Must be in range 0-31.75, and the sum of attenuator 1 + attenuator 2 must not exceed the maximum for that band.

type

number

default

null

  • attenuation_pol_y

The requested aggregate Pol Y attenuation of both attenuators. Must be in range 0 - max value for that particular band.

type

number

default

null

  • attenuation_1_pol_y

The requested Pol Y attenuation of attenuator 1. Must be in range 0-31.75, and the sum of attenuator 1 + attenuator 2 must not exceed the maximum for that band.

type

number

default

null

  • attenuation_2_pol_y

The requested Pol Y attenuation of attenuator 2. Must be in range 0-31.75, and the sum of attenuator 1 + attenuator 2 must not exceed the maximum for that band.

type

number

default

null

  • saturation_threshold

Requested saturation threshold defined by SNR. Must be in range 0-1.0.

type

number

default

null

  • noise_diode

(Optional) Noise diode parameters

default

null

noise_diode_1.0

additionalProperties

True

noise_diode_1.0

anyOf

type

object

properties

  • pseudo_random

pseudo_random_schema_1.0

additionalProperties

True

type

object

properties

  • periodic

periodic_schema_1.0

additionalProperties

True

pseudo_random_schema_1.0

type

object

properties

  • binary_polynomial

Defines which bits of the shift register are fed back to generate the next bit sequence. Must be >= 0.

type

integer

default

null

  • seed

Initial state of the shift register in the PRBS generator. Must be >= 0.

type

integer

default

null

  • dwell

Time interval (in nanoseconds) between transitions to the next bit. Must be >= 0.

type

integer

default

null

additionalProperties

True

periodic_schema_1.0

type

object

properties

  • period

Number of nanoseconds for the noise diode period. Must be >= 0.

type

integer

default

null

  • duty_cycle

Number of nanoseconds for which the noise diode should be ON. Must be >= 0.

If duty_cycle > period, then the noise diode will be on 100% of the time.

type

integer

default

null

  • phase_shift

The phase shift of the periodic signal in number of nanoseconds. Must be >= 0.

type

integer

default

null

additionalProperties

True