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.

Class diagram for the mccs_allocation module

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

  "mccs_allocation": {
    "mccs_allocation_id": "mccs-allocation-74519",
    "selected_subarray_definition": "AA0.5",
    "subarray_beams": [
	{
	    "subarray_beam_id": 1,
	    "apertures": [
		{
		    "station_id": 345,
		    "substation_id": 1,
		    "weighting_key": "uniform"
		},
		{
		    "station_id": 350,
		    "substation_id": 1,
		    "weighting_key": "uniform"
		},
		{
		    "station_id": 352,
		    "substation_id": 1,
		    "weighting_key": "uniform"
		},
		{
		    "station_id": 431,
		    "substation_id": 1,
		    "weighting_key": "uniform"
		}
	    ]
	}
    ]
},

The ska_oso_pdm.sb_definition.mccs.mccs_allocation module defines a simple Python representation of the MCCS allocation

class Aperture(*, station_id: int, substation_id: int, weighting_key: str = 'uniform')

Aperture specifies how the aperture of a subarray beam should be configured.

Parameters:

• station_id – ID of station

• substation_id – ID of sub station

• weighting_key – weighting key value

class MCCSAllocation(*, mccs_allocation_id: str, selected_subarray_definition: ~ska_oso_pdm._shared.atoms.SubArrayLOW, subarray_beams: list[~ska_oso_pdm.sb_definition.mccs.mccs_allocation.SubarrayBeamConfiguration] = <factory>)

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

Parameters:

• mccs_allocation_id – stations ID’s to allocate

• selected_subarray_definition – name of pre-defined/standard configuration

• subarray_beams – subarray beam list

class SubarrayBeamConfiguration(*, apertures: list[~ska_oso_pdm.sb_definition.mccs.mccs_allocation.Aperture] = <factory>, subarray_beam_id: int, scan_sequence: list[~ska_oso_pdm.sb_definition.scan_definition.ScanDefinition] = <factory>)

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

Parameters:

• apertures – list of aperture in this subarray

• subarray_beam_id – ID of subarray beam this config maps to

• scan_sequence – a list of ScanDefinitions that this SubarrayBeam will perform. Note the number of ScanDefinitions and the duration of each them should be the same for each SubarrayBeam in the SBDefinition