Station Device
This module implements the MCCS station device.
- class MccsStation(*args, **kwargs)
An implementation of a station beam Tango device for MCCS.
- ApplyConfiguration(transaction_id)
Apply the aggregated channel table to this Station’s SpsStation.
- Parameters:
transaction_id (
str
) – transaction id for the configuration- Return type:
- Returns:
A tuple containing a return code and a string message indicating status. The message is for information purpose only.
- Example:
>>> dp = tango.DeviceProxy("low-mccs/station/ci-1") >>> dp.command_inout("ApplyConfiguration")
- ApplyPointingDelays(argin)
Set the pointing delay parameters of this Station’s Tiles.
- Parameters:
argin (
str
) – switch time, in ISO formatted time. Default: now- Return type:
- Returns:
A tuple containing a return code and a string message indicating status. The message is for information purpose only.
- Example:
>>> dp = tango.DeviceProxy("low-mccs/station/ci-1") >>> time_string = switch time as ISO formatted time >>> dp.command_inout("ApplyPointingDelays", time_string)
- ConfigureChannels(argin)
Set the beamformer table entries for a station beam.
Entries are defined as a flattened 2D array, for a maximum of 48 entries Each entry is 7 channels long and corresponds to 8 consecutive frequency channels.
- Parameters:
argin (
list
[int
]) – list of channel block description. Elements are: * channel block index: value in range 0:47 for the channel block to set * start_channel - (int) region starting channel, even in range 0 to 510 * beam_index - (int) beam used for this region with range 0 to 47 * subarray_id - (int) Subarray: 0 is reserved for unallocated entry * subarray_logical_channel - (int) logical channel # in the subarray * subarray_beam_id - (int) ID of the subarray beam * substation_id - (int) Substation * aperture_id: ID of the aperture (station*100+substation?)- Return type:
- Returns:
A tuple containing a return code and a string message indicating status. The message is for information purpose only.
- Example:
>>> dp = tango.DeviceProxy("low-mccs/station/ci-1") >>> dp.command_inout("ConfigureChannels", block_table)
- ConfigureSemiStatic(argin)
Configure semi static information like position of antennas.
- Parameters:
argin (
str
) – Semi static information- Return type:
- Returns:
A tuple containing a return code and a string message indicating status. The message is for information purpose only.
- Example:
>>> dp = tango.DeviceProxy("low-mccs/station/ci-1") >>> config = json.dumps({ "station": { "StationId": 1, "ref_latitude": 1.0, "ref_longitude": 1.0, "ref_height": 1.0, } }) >>> dp.command_inout("ConfigureSemiStatic", config)
- DeallocateSubarray(subarray_id)
Deallocates entries relative to a subarray in aggregate tables.
- EndScan(subarray_id)
Stop the current scan associated with the station_beam.
- GetPointingDelays(argin)
Get Pointing Coefficients.
- class InitCommand(*args, **kwargs)
A class for
MccsStation
’s Init command.The
do()
method below is called uponMccsStation
’s initialisation.- do(*args, **kwargs)
Initialise the
MccsStation
.- Parameters:
- Return type:
- Returns:
A tuple containing a return code and a string message indicating status. The message is for information purpose only.
- Initialise()
Initialise this station’s tiles.
- LoadPointingDelays(argin)
Set the pointing delay parameters of this Station’s Tiles.
- Parameters:
argin (
ndarray
) – an array containing a beam index followed by antenna delays- Return type:
- Returns:
A tuple containing a return code and a string message indicating status. The message is for information purpose only.
- Example:
>>> dp = tango.DeviceProxy("low-mccs/station/ci-1") >>> dp.command_inout("LoadPointingDelays", delay_list)
- Scan(argin)
Start the scan associated with the station_beam.
- StartAcquisition(argin)
Start data acquisition.
- Parameters:
argin (
str
) – json dictionary with optional keywords:
start_time - (ISO UTC time) start time
delay - (int) delay start if StartTime is not specified, default 2s
- class StartAcquisitionCommand(command_tracker, component_manager, callback=None, logger=None)
Class for handling the StartAcquisition() command.
This command takes as input a JSON string that conforms to the following schema:
{ "$schema": "https://json-schema.org/draft/2020-12/schema", "$id": "https://skao.int/Mccs_StartAcquisition.json", "title": "StartAcquisition schema", "description": "Schema for StartAcquisition command", "type": "object", "properties": { "start_time": { "description": "", "type": "string", "format": "time" }, "delay": { "description": "An acquisition start delay", "type": "integer" } } }
- __init__(command_tracker, component_manager, callback=None, logger=None)
Initialise a new instance.
- Parameters:
command_tracker (
CommandTracker
) – the device’s command trackercomponent_manager (
StationComponentManager
) – the device’s component managercallback (
Optional
[Callable
]) – an optional callback to be called when this command starts and finishes.logger (
Optional
[Logger
]) – a logger for this command to log with.
- StopTracking(track_id)
Stop tracking an object.
- StopTrackingAll()
Stop all tracking.
- TrackObject(argin)
Track an object through the sky.
- __init__(*args, **kwargs)
Initialise this device object.
- beamTrls()
Return the TRLs of station beams associated with this station.
- beamformerTable()
Return the ids of the channels configured for this beam.
- calibrationCoefficients()
Return the calibration coefficients for the station.
- Todo:
How big should this array be? 4 complex values (Jones matrix) per channel. This station can have up to 16 tiles of up to 16 antennas, so that is 8 x 16 x 16 = 2048 coefficients per channel. But how many channels? 384 channels, 786432 elements per station (402M for SKA Low)
- Return type:
- Returns:
the calibration coefficients
- create_component_manager()
Create and return a component manager for this device.
- Return type:
- Returns:
a component manager for this device.
- dataDirectory()
Return the data directory.
(the parent directory for all files generated by this station)
- Return type:
- Returns:
the data directory
- delayCentre(value)
Set the delay centre of the station.
- healthModelParams(argin)
Set the params for health transition rules.
- health_changed(health)
Handle change in this device’s health state.
This is a callback hook, called whenever the HealthModel’s evaluated health state changes. It is responsible for updating the tango side of things i.e. making sure the attribute is up to date, and events are pushed.
- Parameters:
health (
HealthState
) – the new health value- Return type:
- init_device()
Initialise the device.
This is overridden here to change the Tango serialisation model.
- Return type:
- isCalibrated()
Return a flag indicating whether this station is currently calibrated or not.
- Return type:
- Returns:
a flag indicating whether this station is currently calibrated or not.
- isConfigured()
Return a flag indicating whether this station is currently configured or not.
- Return type:
- Returns:
a flag indicating whether this station is currently configured or not.
- isInitialised()
Return true if all tiles in the SpsStation are initialised.
- Return type:
- Returns:
true if all tiles in the SpsStation are initialised.
- isSynchronised()
Return true if all tiles in the SpsStation are synchronised.
- Return type:
- Returns:
true if all tiles in the SpsStation are synchronised.
- is_On_allowed()
Check if command Off is allowed in the current device state.
- Return type:
- Returns:
True
if the command is allowed
- numberOfChannels()
Return the total number of channels in the beamformer.
- Return type:
- Returns:
the total number of channels
- outsideTemperature()
Return the OutsideTemperature.
- refHeight()
Return the refHeight attribute.
- Return type:
- Returns:
the ellipsoidal height of the station reference position
- refLatitude()
Return the refLatitude attribute.
- Return type:
- Returns:
the WGS84 Latitude of the station reference position
- refLongitude()
Return the refLongitude attribute.
- Return type:
- Returns:
the WGS84 Longitude of the station reference position