ska-low-cbf-configurescan

LOWCBF configurescan 0.5

Example JSON (2025-09-10: added RFI flagging thresholds)

{
    "interface": "https://schema.skao.int/ska-low-cbf-configurescan/0.5",
    "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": {
            "firmware": "https://example.com/ska-low-cbf-fw-corr.tar.gz",
            "sps_rfi_threshold_db": -60.0,
            "stn_beams": [{
                "stn_beam_id": 1,
                "host": [
                    [0, "192.168.1.0"]
                ],
                "port": [
                    [0, 9000, 1]
                ],
                "mac": [
                    [0, "02-03-04-0a-0b-0c"]
                ],
                "integration_ms": 849
            }]
        },
        "timing_beams": {
            "firmware": "https://example.com/ska-low-cbf-fw-pst.tar.gz",
            "sps_rfi_threshold_db": -60.0,
            "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",
                "destinations": [{
                    "data_host": "10.0.3.2",
                    "data_port": 9000,
                    "start_channel": 0,
                    "num_channels": 24
                }]
            }]
        },
        "search_beams": {
            "firmware": "https://example.com/ska-low-cbf-fw-pss.tar.gz",
            "sps_rfi_threshold_db": -60.0,
            "beams": [{
                "pss_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",
                "destinations": [{
                    "data_host": "10.0.3.2",
                    "data_port": 9000,
                    "start_channel": 0,
                    "num_channels": 24
                }]
            }]
        },
        "coarse_zooms": {
            "firmware": "https://example.com/ska-low-cbf-fw-corr.tar.gz",
            "sps_rfi_threshold_db": -60.0,
            "stn_beams": [{
                "zoom_window_id": 1,
                "zoom_resolution_hz": 227,
                "centre_frequency_hz": 312500000,
                "zoom_bandwidth_hz": 3000,
                "stn_beam_id": 1,
                "host": [
                    [0, "192.168.1.01"]
                ],
                "port": [
                    [0, 10000, 1]
                ],
                "mac": [
                    [0, "02-03-04-0a-0b-0c"]
                ],
                "integration_ms": 849
            }]
        }
    }
}

https://schema.skao.int/ska-low-cbf-configurescan/0.5

type

object

properties

  • interface

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

type

string

  • lowcbf

LOWCBF configuration for scan

LOWCBF_subarray_configurescan_0.5

additionalProperties

True

LOWCBF_subarray_configurescan_0.5

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

  • stations

Subarray Stations and station beam input descriptions

Subarray_stations_and_station_beams_0.5

  • timing_beams

PST beam outputs descriptions

outer_0.5

  • search_beams

outer 0.5

PSS beam outputs descriptions

type

object

properties

  • beams

inner

type

array

items

PSS_beams_description_0.5

  • firmware

PSS firmware name

type

string

  • sps_rfi_threshold_db

SPS RFI flagging aliasing power threshold.

This parameter specifies how much aliasing power is tolerated before Low CBF will flag samples as RFI (i.e. not usable because of Radio Frequency Interference).

The value is specified in decibels relative to an SPS channel with no RFI-flagged samples, and therefore must be a negative or zero value.

A setting of zero means the output will never be flagged as RFI, no matter how badly it may be distorted. -100 is the most sensitive possible value.

The “aliasing power” here is a result of samples that have been flagged as RFI by SPS. These are treated as zero by Low CBF, distorting CBF filterbank’s response.

See also requirements SKAO-CSP_Low_CBF_REQ-280 and SKAO_IF-LOW_CBF_SPS-18.

type

number

additionalProperties

True

  • vis

Visibilities description 0.5

Visibility output descriptions

type

object

properties

  • firmware

Firmware to use

type

string

  • fsp

FSP 0.5

FSPs used for correlation

type

object

properties

  • firmware

Firmware name

type

string

  • fsp_ids

List of IDs (integer)

type

array

items

type

integer

additionalProperties

True

  • sps_rfi_threshold_db

SPS RFI flagging aliasing power threshold.

This parameter specifies how much aliasing power is tolerated before Low CBF will flag samples as RFI (i.e. not usable because of Radio Frequency Interference).

The value is specified in decibels relative to an SPS channel with no RFI-flagged samples, and therefore must be a negative or zero value.

A setting of zero means the output will never be flagged as RFI, no matter how badly it may be distorted. -100 is the most sensitive possible value.

The “aliasing power” here is a result of samples that have been flagged as RFI by SPS. These are treated as zero by Low CBF, distorting CBF filterbank’s response.

See also requirements SKAO-CSP_Low_CBF_REQ-280 and SKAO_IF-LOW_CBF_SPS-18.

type

number

  • stn_beams

SDP visibility destinations

type

array

items

Station_beams_to_correlate_0.5

additionalProperties

True

  • coarse_zooms

Coarse zoom description 0.5

Zoom visibility output descriptions, res>226Hz

type

object

properties

  • firmware

Firmware for zoom correlation

type

string

  • sps_rfi_threshold_db

SPS RFI flagging aliasing power threshold.

This parameter specifies how much aliasing power is tolerated before Low CBF will flag samples as RFI (i.e. not usable because of Radio Frequency Interference).

The value is specified in decibels relative to an SPS channel with no RFI-flagged samples, and therefore must be a negative or zero value.

A setting of zero means the output will never be flagged as RFI, no matter how badly it may be distorted. -100 is the most sensitive possible value.

The “aliasing power” here is a result of samples that have been flagged as RFI by SPS. These are treated as zero by Low CBF, distorting CBF filterbank’s response.

See also requirements SKAO-CSP_Low_CBF_REQ-280 and SKAO_IF-LOW_CBF_SPS-18.

type

number

  • stn_beams

SDP visibility destinations

type

array

items

Station_beams_for_zoom_correlate_0.5

additionalProperties

True

additionalProperties

True

Subarray_stations_and_station_beams_0.5

Station and station beams parameters

type

object

properties

  • stns

type

array

items

type

array

items

type

integer

  • stn_beams

type

array

items

Subarray station beams 0.5

type

object

properties

  • beam_id

station beam id

type

integer

  • freq_ids

list of station beam frequency ids

type

array

items

type

integer

  • delay_poly

URL

type

string

additionalProperties

True

additionalProperties

True

outer_0.5

PST Outer

type

object

properties

  • beams

inner

type

array

items

PST_beams_description_0.5

  • firmware

PST firmware name

type

string

  • sps_rfi_threshold_db

SPS RFI flagging aliasing power threshold.

This parameter specifies how much aliasing power is tolerated before Low CBF will flag samples as RFI (i.e. not usable because of Radio Frequency Interference).

The value is specified in decibels relative to an SPS channel with no RFI-flagged samples, and therefore must be a negative or zero value.

A setting of zero means the output will never be flagged as RFI, no matter how badly it may be distorted. -100 is the most sensitive possible value.

The “aliasing power” here is a result of samples that have been flagged as RFI by SPS. These are treated as zero by Low CBF, distorting CBF filterbank’s response.

See also requirements SKAO-CSP_Low_CBF_REQ-280 and SKAO_IF-LOW_CBF_SPS-18.

type

number

additionalProperties

True

PST_beams_description_0.5

type

object

properties

  • stn_beam_id

Station beam ID for pst beamforming

type

integer

  • pst_beam_id

PST beam ID

type

integer

  • field

Sky direction

field description

anyOf

ICRS sky direction 0.5

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

  • 0.5*

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 0.5

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

  • 0.5*

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 0.5

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

  • 0.5*

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 0.5

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 0.5

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

  • 0.5*

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

  • jones

Jones matrix source URI

type

string

  • stn_weights

weights for each station

type

array

items

type

number

  • rfi_enable

Master enable for RFI flagging

type

array

items

type

boolean

  • rfi_static_chans

Freqency IDs to be always flagged

type

array

items

type

integer

  • rfi_dynamic_chans

Frequency IDs to be dynamically flagged

type

array

items

type

integer

  • rfi_weighted

Parameter for dynamic flagging

type

number

  • delay_poly

Delay polynomial source URI

type

string

  • destinations

PST server addrs

type

array

items

PST beams description 0.5

type

object

properties

  • data_host

dotted ipv4 address

type

string

  • data_port

UDP port number

type

integer

  • start_channel

first chan to host

type

integer

  • num_channels

no. chans to host

type

integer

additionalProperties

True

additionalProperties

True

PSS_beams_description_0.5

type

object

properties

  • stn_beam_id

Station beam ID for pst beamforming

type

integer

  • pss_beam_id

PSS beam ID

type

integer

  • jones

Jones matrix source URI

type

string

  • stn_weights

weights for each station

type

array

items

type

number

  • rfi_enable

Master enable for RFI flagging

type

array

items

type

boolean

  • rfi_static_chans

Freqency IDs to be always flagged

type

array

items

type

integer

  • rfi_dynamic_chans

Frequency IDs to be dynamically flagged

type

array

items

type

integer

  • rfi_weighted

Parameter for dynamic flagging

type

number

  • delay_poly

Delay polynomial source URI

type

string

  • destinations

PST server addrs

type

array

items

PST beams description 0.5

type

object

properties

  • data_host

dotted ipv4 address

type

string

  • data_port

UDP port number

type

integer

  • start_channel

first chan to host

type

integer

  • num_channels

no. chans to host

type

integer

additionalProperties

True

additionalProperties

True

Station_beams_to_correlate_0.5

type

object

properties

  • stn_beam_id

Station Beam ID

type

integer

  • integration_ms

milliseconds integration

type

integer

  • host

SDP channel & IP Address

type

array

items

type

array

items

anyOf

type

integer

type

string

  • port

SDP chan & UDP port, stride

type

array

items

type

array

items

type

integer

  • mac

SDP channel & server MAC

type

array

items

type

array

items

anyOf

type

integer

type

string

additionalProperties

True

Station_beams_for_zoom_correlate_0.5

type

object

properties

  • stn_beam_id

Station Beam ID

type

integer

  • zoom_window_id

Zoom window ID

type

integer

  • zoom_resolution_hz

Resolution bandwidth of zoom (Hz)

type

integer

  • centre_frequency_hz

Centre of zoom band (Hz)

type

integer

  • zoom_bandwidth_hz

Bandwidth of zoom (Hz)

type

integer

  • integration_ms

milliseconds integration

type

integer

  • host

SDP channel & IP Address

type

array

items

type

array

items

anyOf

type

integer

type

string

  • port

SDP chan & UDP port, stride

type

array

items

type

array

items

type

integer

  • mac

SDP channel & server MAC

type

array

items

type

array

items

anyOf

type

integer

type

string

additionalProperties

True

LOWCBF configurescan 0.4

Example JSON (2025-06-12: defined zoom visibilities, removed FSPs)

{
    "interface": "https://schema.skao.int/ska-low-cbf-configurescan/0.4",
    "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": {
            "firmware": "vis",
            "stn_beams": [{
                "stn_beam_id": 1,
                "host": [
                    [0, "192.168.1.0"]
                ],
                "port": [
                    [0, 9000, 1]
                ],
                "mac": [
                    [0, "02-03-04-0a-0b-0c"]
                ],
                "integration_ms": 849
            }]
        },
        "timing_beams": {
            "firmware": "pst",
            "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",
                "destinations": [{
                    "data_host": "10.0.3.2",
                    "data_port": 9000,
                    "start_channel": 0,
                    "num_channels": 24
                }]
            }]
        },
        "search_beams": {
            "firmware": "pss",
            "beams": [{
                "pss_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",
                "destinations": [{
                    "data_host": "10.0.3.2",
                    "data_port": 9000,
                    "start_channel": 0,
                    "num_channels": 24
                }]
            }]
        },
        "coarse_zooms": {
            "firmware": "vis",
            "stn_beams": [{
                "zoom_window_id": 1,
                "zoom_resolution_hz": 227,
                "centre_frequency_hz": 312500000,
                "zoom_bandwidth_hz": 3000,
                "stn_beam_id": 1,
                "host": [
                    [0, "192.168.1.01"]
                ],
                "port": [
                    [0, 10000, 1]
                ],
                "mac": [
                    [0, "02-03-04-0a-0b-0c"]
                ],
                "integration_ms": 849
            }]
        }
    }
}

https://schema.skao.int/ska-low-cbf-configurescan/0.4

type

object

properties

  • interface

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

type

string

  • lowcbf

LOWCBF configuration for scan

LOWCBF_subarray_configurescan_0.4

additionalProperties

True

LOWCBF_subarray_configurescan_0.4

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

  • stations

Subarray Stations and station beam input descriptions

Subarray_stations_and_station_beams_0.4

  • timing_beams

PST beam outputs descriptions

outer_0.4

  • search_beams

outer 0.4

PSS beam outputs descriptions

type

object

properties

  • beams

inner

type

array

items

PSS_beams_description_0.4

  • firmware

PSS firmware name

type

string

additionalProperties

True

  • vis

Visibilities description 0.4

Visibility output descriptions

type

object

properties

  • firmware

Firmware to use

type

string

  • fsp

FSP 0.4

FSPs used for correlation

type

object

properties

  • firmware

Firmware name

type

string

  • fsp_ids

List of IDs (integer)

type

array

items

type

integer

additionalProperties

True

  • stn_beams

SDP visibility destinations

type

array

items

Station_beams_to_correlate_0.4

additionalProperties

True

  • coarse_zooms

Coarse zoom description 0.4

Zoom visibility output descriptions, res>226Hz

type

object

properties

  • firmware

Firmware for zoom correlation

type

string

  • stn_beams

SDP visibility destinations

type

array

items

Station_beams_for_zoom_correlate_0.4

additionalProperties

True

additionalProperties

True

Subarray_stations_and_station_beams_0.4

Station and station beams parameters

type

object

properties

  • stns

type

array

items

type

array

items

type

integer

  • stn_beams

type

array

items

Subarray station beams 0.4

type

object

properties

  • beam_id

station beam id

type

integer

  • freq_ids

list of station beam frequency ids

type

array

items

type

integer

  • delay_poly

URL

type

string

additionalProperties

True

additionalProperties

True

outer_0.4

PST Outer

type

object

properties

  • beams

inner

type

array

items

PST_beams_description_0.4

  • firmware

PST firmware name

type

string

additionalProperties

True

PST_beams_description_0.4

type

object

properties

  • stn_beam_id

Station beam ID for pst beamforming

type

integer

  • pst_beam_id

PST beam ID

type

integer

  • field

Sky direction

field description

anyOf

ICRS sky direction 0.4

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

  • 0.4*

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 0.4

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

  • 0.4*

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 0.4

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

  • 0.4*

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 0.4

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 0.4

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

  • 0.4*

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

  • jones

Jones matrix source URI

type

string

  • stn_weights

weights for each station

type

array

items

type

number

  • rfi_enable

Master enable for RFI flagging

type

array

items

type

boolean

  • rfi_static_chans

Freqency IDs to be always flagged

type

array

items

type

integer

  • rfi_dynamic_chans

Frequency IDs to be dynamically flagged

type

array

items

type

integer

  • rfi_weighted

Parameter for dynamic flagging

type

number

  • delay_poly

Delay polynomial source URI

type

string

  • destinations

PST server addrs

type

array

items

PST beams description 0.4

type

object

properties

  • data_host

dotted ipv4 address

type

string

  • data_port

UDP port number

type

integer

  • start_channel

first chan to host

type

integer

  • num_channels

no. chans to host

type

integer

additionalProperties

True

additionalProperties

True

PSS_beams_description_0.4

type

object

properties

  • stn_beam_id

Station beam ID for pst beamforming

type

integer

  • pss_beam_id

PSS beam ID

type

integer

  • jones

Jones matrix source URI

type

string

  • stn_weights

weights for each station

type

array

items

type

number

  • rfi_enable

Master enable for RFI flagging

type

array

items

type

boolean

  • rfi_static_chans

Freqency IDs to be always flagged

type

array

items

type

integer

  • rfi_dynamic_chans

Frequency IDs to be dynamically flagged

type

array

items

type

integer

  • rfi_weighted

Parameter for dynamic flagging

type

number

  • delay_poly

Delay polynomial source URI

type

string

  • destinations

PST server addrs

type

array

items

PST beams description 0.4

type

object

properties

  • data_host

dotted ipv4 address

type

string

  • data_port

UDP port number

type

integer

  • start_channel

first chan to host

type

integer

  • num_channels

no. chans to host

type

integer

additionalProperties

True

additionalProperties

True

Station_beams_to_correlate_0.4

type

object

properties

  • stn_beam_id

Station Beam ID

type

integer

  • integration_ms

milliseconds integration

type

integer

  • host

SDP channel & IP Address

type

array

items

type

array

items

anyOf

type

integer

type

string

  • port

SDP chan & UDP port, stride

type

array

items

type

array

items

type

integer

  • mac

SDP channel & server MAC

type

array

items

type

array

items

anyOf

type

integer

type

string

additionalProperties

True

Station_beams_for_zoom_correlate_0.4

type

object

properties

  • stn_beam_id

Station Beam ID

type

integer

  • zoom_window_id

Zoom window ID

type

integer

  • zoom_resolution_hz

Resolution bandwidth of zoom (Hz)

type

integer

  • centre_frequency_hz

Centre of zoom band (Hz)

type

integer

  • zoom_bandwidth_hz

Bandwidth of zoom (Hz)

type

integer

  • integration_ms

milliseconds integration

type

integer

  • host

SDP channel & IP Address

type

array

items

type

array

items

anyOf

type

integer

type

string

  • port

SDP chan & UDP port, stride

type

array

items

type

array

items

type

integer

  • mac

SDP channel & server MAC

type

array

items

type

array

items

anyOf

type

integer

type

string

additionalProperties

True

LOWCBF configurescan 0.3

Example JSON (2024-07-02: defined PSS search beams)

{
    "interface": "https://schema.skao.int/ska-low-cbf-configurescan/0.3",
    "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",
                "destinations": [{
                    "data_host": "10.0.3.2",
                    "data_port": 9000,
                    "start_channel": 0,
                    "num_channels": 24
                }]
            }]
        },
        "search_beams": {
            "fsp": {
                "firmware": "pss",
                "fsp_ids": [3]
            },
            "beams": [{
                "pss_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",
                "destinations": [{
                    "data_host": "10.0.3.2",
                    "data_port": 9000,
                    "start_channel": 0,
                    "num_channels": 24
                }]
            }]
        }
    }
}

https://schema.skao.int/ska-low-cbf-configurescan/0.3

type

object

properties

  • interface

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

type

string

  • lowcbf

LOWCBF configuration for scan

LOWCBF_subarray_configurescan_0.3

additionalProperties

True

LOWCBF_subarray_configurescan_0.3

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

  • stations

Subarray Stations and station beam input descriptions

Subarray_stations_and_station_beams_0.3

  • timing_beams

PST beam outputs descriptions

outer_0.3

  • search_beams

outer 0.3

PSS beam outputs descriptions

type

object

properties

  • beams

inner

type

array

items

PSS_beams_description_0.3

  • fsp

FSP 0.3

FSPs used by PST

type

object

properties

  • firmware

Firmware name

type

string

  • fsp_ids

List of IDs (integer)

type

array

items

type

integer

additionalProperties

True

additionalProperties

True

  • vis

Visibilities description 0.3

Visibility output descriptions

type

object

properties

  • fsp

FSP 0.3

FSPs used for correlation

type

object

properties

  • firmware

Firmware name

type

string

  • fsp_ids

List of IDs (integer)

type

array

items

type

integer

additionalProperties

True

  • stn_beams

SDP visibility destinations

type

array

items

Station_beams_to_correlate_0.3

additionalProperties

True

  • zooms

placeholder zoom visibility output descriptions

type

string

additionalProperties

True

Subarray_stations_and_station_beams_0.3

Station and station beams parameters

type

object

properties

  • stns

type

array

items

type

array

items

type

integer

  • stn_beams

type

array

items

Subarray station beams 0.3

type

object

properties

  • beam_id

station beam id

type

integer

  • freq_ids

list of station beam frequency ids

type

array

items

type

integer

  • delay_poly

URL

type

string

additionalProperties

True

additionalProperties

True

outer_0.3

PST Outer

type

object

properties

  • beams

inner

type

array

items

PST_beams_description_0.3

  • fsp

FSP 0.3

FSPs used by PST

type

object

properties

  • firmware

Firmware name

type

string

  • fsp_ids

List of IDs (integer)

type

array

items

type

integer

additionalProperties

True

additionalProperties

True

PST_beams_description_0.3

type

object

properties

  • stn_beam_id

Station beam ID for pst beamforming

type

integer

  • pst_beam_id

PST beam ID

type

integer

  • field

Sky direction

field description

anyOf

ICRS sky direction 0.3

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

  • 0.3*

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 0.3

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

  • 0.3*

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 0.3

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

  • 0.3*

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 0.3

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 0.3

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

  • 0.3*

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

  • jones

Jones matrix source URI

type

string

  • stn_weights

weights for each station

type

array

items

type

number

  • rfi_enable

Master enable for RFI flagging

type

array

items

type

boolean

  • rfi_static_chans

Freqency IDs to be always flagged

type

array

items

type

integer

  • rfi_dynamic_chans

Frequency IDs to be dynamically flagged

type

array

items

type

integer

  • rfi_weighted

Parameter for dynamic flagging

type

number

  • delay_poly

Delay polynomial source URI

type

string

  • destinations

PST server addrs

type

array

items

PST beams description 0.3

type

object

properties

  • data_host

dotted ipv4 address

type

string

  • data_port

UDP port number

type

integer

  • start_channel

first chan to host

type

integer

  • num_channels

no. chans to host

type

integer

additionalProperties

True

additionalProperties

True

PSS_beams_description_0.3

type

object

properties

  • stn_beam_id

Station beam ID for pst beamforming

type

integer

  • pss_beam_id

PSS beam ID

type

integer

  • jones

Jones matrix source URI

type

string

  • stn_weights

weights for each station

type

array

items

type

number

  • rfi_enable

Master enable for RFI flagging

type

array

items

type

boolean

  • rfi_static_chans

Freqency IDs to be always flagged

type

array

items

type

integer

  • rfi_dynamic_chans

Frequency IDs to be dynamically flagged

type

array

items

type

integer

  • rfi_weighted

Parameter for dynamic flagging

type

number

  • delay_poly

Delay polynomial source URI

type

string

  • destinations

PST server addrs

type

array

items

PST beams description 0.3

type

object

properties

  • data_host

dotted ipv4 address

type

string

  • data_port

UDP port number

type

integer

  • start_channel

first chan to host

type

integer

  • num_channels

no. chans to host

type

integer

additionalProperties

True

additionalProperties

True

Station_beams_to_correlate_0.3

type

object

properties

  • stn_beam_id

Station Beam ID

type

integer

  • integration_ms

milliseconds integration

type

integer

  • host

SDP channel & IP Address

type

array

items

type

array

items

anyOf

type

integer

type

string

  • port

SDP chan & UDP port, stride

type

array

items

type

array

items

type

integer

  • mac

SDP channel & server MAC

type

array

items

type

array

items

anyOf

type

integer

type

string

additionalProperties

True

LOWCBF configurescan 1.0

Example (Low CBF Configuration JSON including Nakshatra work)

{
    "interface": "https://schema.skao.int/ska-low-cbf-configurescan/1.0",
    "lowcbf": {
        "stations": {
            "stns": [
                [1, 1],
                [2, 1],
                [3, 1],
                [4, 1],
                [5, 1],
                [6, 1]
            ],
            "stn_beams": [{
                "stn_beam_id": 1,
                "freq_ids": [400],
                "delay_poly": "tango://delays.skao.int/low/stn-beam/1"
            }]
        },
        "vis": {
            "fsp": {
                "function_mode": "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": {
                "function_mode": "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",
                "destinations": [{
                    "data_host": "10.0.3.2",
                    "data_port": 9000,
                    "start_channel": 0,
                    "num_channels": 24
                }]
            }]
        }
    }
}

https://schema.skao.int/ska-low-cbf-configurescan/1.0

type

object

properties

  • interface

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

type

string

  • lowcbf

LOWCBF configuration for scan

LOWCBF_subarray_configurescan_1.0

additionalProperties

True

LOWCBF_subarray_configurescan_1.0

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

  • stations

Subarray Stations and station beam input descriptions

Subarray_stations_and_station_beams_1.0

  • timing_beams

PST beam outputs descriptions

outer_1.0

  • search_beams

PSS beam outputs descriptions

type

string

  • vis

Visibilities description 1.0

Visibility output descriptions

type

object

properties

  • fsp

FSP 1.0

FSPs used for correlation

type

object

properties

  • function_mode

Firmware name

type

string

  • fsp_ids

List of IDs (integer)

type

array

items

type

integer

additionalProperties

True

  • stn_beams

SDP visibility destinations

type

array

items

Station_beams_to_correlate_1.0

additionalProperties

True

  • zooms

placeholder zoom visibility output descriptions

type

string

additionalProperties

True

Subarray_stations_and_station_beams_1.0

Station and station beams parameters

type

object

properties

  • stns

type

array

items

type

array

items

type

integer

  • stn_beams

type

array

items

Subarray station beams 1.0

type

object

properties

  • stn_beam_id

station beam id

type

integer

  • freq_ids

list of station beam frequency ids

type

array

items

type

integer

  • delay_poly

URL

type

string

additionalProperties

True

additionalProperties

True

outer_1.0

PST Outer

type

object

properties

  • beams

inner

type

array

items

PST_beams_description_1.0

  • fsp

FSP 1.0

FSPs used by PST

type

object

properties

  • function_mode

Firmware name

type

string

  • fsp_ids

List of IDs (integer)

type

array

items

type

integer

additionalProperties

True

additionalProperties

True

PST_beams_description_1.0

type

object

properties

  • stn_beam_id

Station beam ID for pst beamforming

type

integer

  • pst_beam_id

PST beam ID

type

integer

  • field

Sky direction

field description

anyOf

ICRS sky direction 1.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

  • 1.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 1.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

  • 1.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 1.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

  • 1.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 1.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 1.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

  • 1.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

  • jones

Jones matrix source URI

type

string

  • stn_weights

weights for each station

type

array

items

type

number

  • rfi_enable

Master enable for RFI flagging

type

array

items

type

boolean

  • rfi_static_chans

Freqency IDs to be always flagged

type

array

items

type

integer

  • rfi_dynamic_chans

Frequency IDs to be dynamically flagged

type

array

items

type

integer

  • rfi_weighted

Parameter for dynamic flagging

type

number

  • delay_poly

Delay polynomial source URI

type

string

  • destinations

PST server addrs

type

array

items

PST beams description 1.0

type

object

properties

  • data_host

dotted ipv4 address

type

string

  • data_port

UDP port number

type

integer

  • start_channel

first chan to host

type

integer

  • num_channels

no. chans to host

type

integer

additionalProperties

True

additionalProperties

True

Station_beams_to_correlate_1.0

type

object

properties

  • stn_beam_id

Station Beam ID

type

integer

  • integration_ms

milliseconds integration

type

integer

  • host

SDP channel & IP Address

type

array

items

type

array

items

anyOf

type

integer

type

string

  • port

SDP chan & UDP port, stride

type

array

items

type

array

items

type

integer

  • mac

SDP channel & server MAC

type

array

items

type

array

items

anyOf

type

integer

type

string

additionalProperties

True

LOWCBF configurescan 0.2

Example JSON (2025-06-12 Added zoom visibilities)

{
    "interface": "https://schema.skao.int/ska-low-cbf-configurescan/0.2",
    "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",
                "destinations": [{
                    "data_host": "10.0.3.2",
                    "data_port": 9000,
                    "start_channel": 0,
                    "num_channels": 24
                }]
            }]
        }
    }
}

https://schema.skao.int/ska-low-cbf-configurescan/0.2

type

object

properties

  • interface

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

type

string

  • lowcbf

LOWCBF configuration for scan

LOWCBF_subarray_configurescan_0.2

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

  • stations

Subarray Stations and station beam input descriptions

Subarray_stations_and_station_beams_0.2

  • timing_beams

PST beam outputs descriptions

outer_0.2

  • search_beams

PSS beam outputs descriptions

type

string

  • vis

Visibilities description 0.2

Visibility output descriptions

type

object

properties

  • fsp

FSP 0.2

FSPs used for correlation

type

object

properties

  • firmware

Firmware name

type

string

  • fsp_ids

List of IDs (integer)

type

array

items

type

integer

additionalProperties

True

  • stn_beams

SDP visibility destinations

type

array

items

Station_beams_to_correlate_0.2

additionalProperties

True

  • zooms

placeholder zoom visibility output descriptions

type

string

additionalProperties

True

Subarray_stations_and_station_beams_0.2

Station and station beams parameters

type

object

properties

  • stns

type

array

items

type

array

items

type

integer

  • stn_beams

type

array

items

Subarray station beams 0.2

type

object

properties

  • beam_id

station beam id

type

integer

  • freq_ids

list of station beam frequency ids

type

array

items

type

integer

  • delay_poly

URL

type

string

additionalProperties

True

additionalProperties

True

outer_0.2

PST Outer

type

object

properties

  • beams

inner

type

array

items

PST_beams_description_0.2

  • fsp

FSP 0.2

FSPs used by PST

type

object

properties

  • firmware

Firmware name

type

string

  • fsp_ids

List of IDs (integer)

type

array

items

type

integer

additionalProperties

True

additionalProperties

True

PST_beams_description_0.2

type

object

properties

  • stn_beam_id

Station beam ID for pst beamforming

type

integer

  • pst_beam_id

PST beam ID

type

integer

  • field

Sky direction

field description

anyOf

ICRS sky direction 0.2

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

  • 0.2*

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 0.2

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

  • 0.2*

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 0.2

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

  • 0.2*

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 0.2

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 0.2

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

  • 0.2*

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

  • jones

Jones matrix source URI

type

string

  • stn_weights

weights for each station

type

array

items

type

number

  • rfi_enable

Master enable for RFI flagging

type

array

items

type

boolean

  • rfi_static_chans

Freqency IDs to be always flagged

type

array

items

type

integer

  • rfi_dynamic_chans

Frequency IDs to be dynamically flagged

type

array

items

type

integer

  • rfi_weighted

Parameter for dynamic flagging

type

number

  • delay_poly

Delay polynomial source URI

type

string

  • destinations

PST server addrs

type

array

items

PST beams description 0.2

type

object

properties

  • data_host

dotted ipv4 address

type

string

  • data_port

UDP port number

type

integer

  • start_channel

first chan to host

type

integer

  • num_channels

no. chans to host

type

integer

additionalProperties

True

additionalProperties

True

Station_beams_to_correlate_0.2

type

object

properties

  • stn_beam_id

Station Beam ID

type

integer

  • integration_ms

milliseconds integration

type

integer

  • host

SDP channel & IP Address

type

array

items

type

array

items

anyOf

type

integer

type

string

  • port

SDP chan & UDP port, stride

type

array

items

type

array

items

type

integer

  • mac

SDP channel & server MAC

type

array

items

type

array

items

anyOf

type

integer

type

string

additionalProperties

True

LOWCBF configurescan 0.1

Example JSON

{
    "interface": "https://schema.skao.int/ska-low-cbf-configurescan/0.0",
    "lowcbf": {
        "stations": {
            "stns": [
                [1, 0],
                [2, 0],
                [3, 0],
                [4, 0]
            ],
            "stn_beams": [{
                "beam_id": 1,
                "freq_ids": [64, 65, 66, 67, 68, 69, 70, 71],
                "boresight_dly_poly": "tango://delays.skao.int/low/stn-beam/1"
            }]
        },
        "timing_beams": {
            "beams": [{
                "pst_beam_id": 13,
                "stn_beam_id": 1,
                "offset_dly_poly": "url",
                "stn_weights": [0.9, 1.0, 1.0, 0.9],
                "jones": "url",
                "dest_ip": ["10.22.0.1:2345", "10.22.0.3:3456"],
                "dest_chans": [128, 256],
                "rfi_enable": [true, true, true],
                "rfi_static_chans": [1, 206, 997],
                "rfi_dynamic_chans": [242, 1342],
                "rfi_weighted": 0.87
            }]
        },
        "search_beams": "tbd",
        "zooms": "tbd"
    }
}

https://schema.skao.int/ska-low-cbf-configurescan/0.1

type

object

properties

  • interface

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

type

string

  • lowcbf

LOWCBF configuration for scan

LOWCBF_subarray_configurescan_0.1

additionalProperties

True

LOWCBF_subarray_configurescan_0.1

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

  • stations

Subarray Stations and station beam input descriptions

Subarray_stations_and_station_beams_0.1

  • timing_beams

PST beam outputs descriptions

outer_0.1

  • search_beams

PSS beam outputs descriptions

type

string

  • visibilities

Visibilities description 0.1

Visibility output descriptions

type

object

properties

  • fsp

FSP 0.1

FSPs used for correlation

type

object

properties

  • firmware

Firmware name

type

string

  • fsp_ids

List of IDs (integer)

type

array

items

type

integer

additionalProperties

True

  • stn_beams

SDP visibility destinations

type

array

items

Station_beams_to_correlate_0.1

additionalProperties

True

  • zooms

placeholder zoom visibility output descriptions

type

string

additionalProperties

True

Subarray_stations_and_station_beams_0.1

Station and station beams parameters

type

object

properties

  • stns

type

array

items

type

array

items

type

integer

  • stn_beams

type

array

items

Subarray station beams 0.1

type

object

properties

  • beam_id

station beam id

type

integer

  • freq_ids

list of station beam frequency ids

type

array

items

type

integer

  • boresight_dly_poly

URL

type

string

additionalProperties

True

additionalProperties

True

outer_0.1

PST Outer

type

object

properties

  • beams

inner

type

array

items

PST_beams_description_0.1

additionalProperties

True

PST_beams_description_0.1

type

object

properties

  • stn_beam_id

Station beam ID for pst beamforming

type

integer

  • pst_beam_id

PST beam ID

type

integer

  • field

Sky direction

field description

anyOf

ICRS sky direction 0.1

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

  • 0.1*

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 0.1

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

  • 0.1*

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 0.1

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

  • 0.1*

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 0.1

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 0.1

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

  • 0.1*

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

  • jones

Jones matrix source URI

type

string

  • stn_weights

weights for each station

type

array

items

type

number

  • rfi_enable

Master enable for RFI flagging

type

array

items

type

boolean

  • rfi_static_chans

Freqency IDs to be always flagged

type

array

items

type

integer

  • rfi_dynamic_chans

Frequency IDs to be dynamically flagged

type

array

items

type

integer

  • rfi_weighted

Parameter for dynamic flagging

type

number

  • firmware

Firmware name

type

string

  • offset_dly_poly

Delay polynomial source URI

type

string

  • dest_ip

Beam destination [ip_addr:port]

type

array

items

type

string

  • dest_chans

Number of fine chans to a destination

type

array

items

type

integer

additionalProperties

True

Station_beams_to_correlate_0.1

type

object

properties

  • stn_beam_id

Station Beam ID

type

integer

  • integration_ms

milliseconds integration

type

integer

  • host

SDP channel & IP Address

type

array

items

type

array

items

anyOf

type

integer

type

string

  • port

SDP chan & UDP port, stride

type

array

items

type

array

items

type

integer

  • mac

SDP channel & server MAC

type

array

items

type

array

items

anyOf

type

integer

type

string

additionalProperties

True