ska_oso_pdm.sb_definition.mccs

The ska_oso_pdm.sb_definition.mccs package contains classes used to define MCCS resource allocations and configurations.

ska_oso_pdm.sb_definition.mccs.mccs_allocation

The ska_oso_pdm.sb_definition.mccs.mccs_allocation module defines which SKA LOW stations should be allocated to a sub-array beam prior to an observation.

An example serialisation of this model to JSON is shown below.

  "mccs_allocation": {
    "subarray_beam_ids": [
      "beam A"
    ],
    "station_ids": [
      [
        1,
        2
      ]
    ],
    "channel_blocks": [
      1
    ]
  },

The entities module provides simple Python representations of the structured request and response for the TMC CentralNode.AssignResources command.

class MCCSAllocation(*, station_ids: list[list[int]], channel_blocks: list[int], subarray_beam_ids: list[str])[source]

MCCSAllocation is a Python representation of the MCCS allocation segment of a scheduling block.

Parameters:

station_ids – stations id’s to allocate
channel_blocks – number of channel groups to assign
subarray_beam_ids – beam IDs

SubarrayBeamID: alias of str

ska_oso_pdm.sb_definition.mccs.subarray_beam_configuration

The ska_oso_pdm.sb_definition.mccs.subarray_beam_configuration module models SKA LOW SB entities. The contents of the module are presented in the diagram below.

An example serialisation of this model to JSON is shown below.

  "subarray_beam_configurations": [
    {
      "subarray_beam_configuration_id": "beam A config 1",
      "subarray_beam_id": "beam A",
      "update_rate": 0.0,
      "antenna_weights": [
        1.0,
        1.0,
        1.0
      ],
      "phase_centre": [
        0.0,
        0.0
      ],
      "channels": [
        [
          0,
          8,
          1,
          1
        ],
        [
          8,
          8,
          2,
          1
        ]
      ]
    }
  ],

The ska_oso_pdm.sb_definition.mccs.subarray_beam_configuration module defines simple Python representation of how SKA Low subarray beam in sub-array should be configured.

class SubarrayBeamConfiguration(*, subarray_beam_configuration_id: str, subarray_beam_id: str, update_rate: float, antenna_weights: list[float], phase_centre: list[float], channels: list[list[int]])[source]

SubarrayBeamConfiguration specifies how SKA LOW sub-array should be configured.

Parameters:

subarray_beam_configuration_id – ID for this configuration
subarray_beam_id – ID of subarray beam this config maps to
update_rate – rate of updates (in units of ???)
antenna_weights
phase_centre
channels

ska_oso_pdm.sb_definition.mccs.target_beam_configuration

The ska_oso_pdm.sb_definition.mccs.target_beam_configuration module defines which SKA LOW target will be mapped to the subarray beam configurations.

An example serialisation of this model to JSON is shown below.

  "target_beam_configurations": [
    {
      "target_beam_id": "target #1 with beam A config 1",
      "target_ref": "target #1",
      "subarray_beam_configuration_ref": "beam A config 1"
    },
    {
      "target_beam_id": "target #2 with beam A config 1",
      "target_ref": "target #2",
      "subarray_beam_configuration_ref": "beam A config 1"
    }
  ],

The ska_oso_pdm.sb_definition.mccs.target_beam_configuration module defines simple Python representation of how SKA Low subarray beam in sub-array should be configured.

class TargetBeamConfiguration(*, target_beam_id: str, target_ref: str, subarray_beam_configuration_ref: str)[source]

TargetBeamConfiguration specifies how SKA LOW subarray beam in a sub-array should be configured.

Parameters:

target_beam_id – ID of target beam configuration
target_ref – target beam configuration points at this target
subarray_beam_configuration_ref – sub-array beam configuration