DSManager Python API

Tango Device for Dish Structure with monitoring and control to OPCUA server.

class DSManager(*args, **kwargs)[source]

The Dish Structure Manager.

ExecuteOPCUACommand(values)[source]

Execute an OPC-UA command on the DSC.

Parameters:: values (list[str]) – string values for the command name and any required arguments
Return type:: Tuple[List[ResultCode], List[Optional[str]]]
Returns:: A tuple containing a return code and a string message indicating status.

GetCurrentTAIOffset()[source]

Get the current TAIoffset as read from the DSC with a manual calculation fallback.

If the read for the TAIoffset fails on the DSC then the TAI offset will be calculated manually by the DSManager device.

Returns:: TAI offset
Return type:: float

class InitCommand(*args, **kwargs)[source]

Initializes the attributes of the DSManager.

do(*args, **kwargs)[source]

Initialise DSManager.

Parameters:

args (Any) – positional arguments
kwargs (Any) – keyword arguments

Return type:

tuple[ResultCode, str]

Returns:

A tuple containing a return code and a string

InterlockAck()[source]

Clear the interlock status once interlocks or E-Stops have been cleared.

Return type:: Tuple[List[ResultCode], List[Optional[str]]]
Returns:: A tuple containing a return code and a string message indicating status.

ReTakeAuthority()[source]

Retake authority.

Return type:: Tuple[List[ResultCode], List[Optional[str]]]
Returns:: A tuple containing a return code and a string message indicating status.

ReleaseAuth()[source]

Releases command authority immediately bypassing the LRC queue.

Return type:: Tuple[List[ResultCode], List[Optional[str]]]
Returns:: A tuple containing a return code and a string message indicating status.

ResetAxesCommand()[source]

Reset the axes errors.

Return type:: Tuple[List[ResultCode], List[Optional[str]]]
Returns:: A tuple containing a return code and a string message indicating status.

SetIndexPosition(band)[source]

Triggers the Dish to transition the feed indexer to the argin position.

If the dish is in low power mode, it is first set to full power mode.

Parameters:: band (int) – The band which the dish is instructed to move the feed indexer to
Return type:: Tuple[List[ResultCode], List[Optional[str]]]
Returns:: A tuple containing a return code and a string message indicating status.

SetPointMode()[source]

Triggers the Dish to transition to the POINT mode.

Return type:: Tuple[List[ResultCode], List[Optional[str]]]
Returns:: A tuple containing a return code and a string message indicating status.

SetPowerMode(values)[source]

Trigger the Dish to transition to SetPowerMode.

Parameters:: values (list[float]) – float values for LowPowerOn(boolean), Power limit(kW)
Return type:: Tuple[List[ResultCode], List[Optional[str]]]
Returns:: A tuple containing a return code and a string message indicating status.

SetStandbyMode()[source]

Triggers the Dish to transition to the STANDBY mode.

If the dish is stowed, sets it to full power mode and unstows it. Then, deactivates the azimuth and elevation axes if they are not in standby mode before setting the dish to low power mode.

Return type:: Tuple[List[ResultCode], List[Optional[str]]]
Returns:: A tuple containing a return code and a string message indicating status.

Slew(values)[source]

Trigger the Dish to start moving to the commanded (Az,El) position.

If the dish is in low power mode, it is first set to full power mode.

Parameters:: values (list[float]) – float values for the az position, el position
Return type:: Tuple[List[ResultCode], List[Optional[str]]]
Returns:: A tuple containing a return code and a string message indicating status.

Stow()[source]

Transition the dish to STOW immediately bypassing the LRC queue.

Return type:: Tuple[List[ResultCode], List[Optional[str]]]
Returns:: A tuple containing a return code and a string message indicating status.

TakeAuthority()[source]

Take authority.

Return type:: Tuple[List[ResultCode], List[Optional[str]]]
Returns:: A tuple containing a return code and a string message indicating status.

Track()[source]

Triggers the Dish to start tracking.

Dish will start tracking the positions present in the track table using the set interpolation mode.

Return type:: Tuple[List[ResultCode], List[Optional[str]]]
Returns:: A tuple containing a return code and a string message indicating status.

TrackLoadStaticOff(values)[source]

Load the given static pointing model offsets.

Return type:: Tuple[List[ResultCode], List[Optional[str]]]
Returns:: A tuple containing a return code and a string message indicating status.

TrackLoadTable(values)[source]

Load the track table with the given load mode.

Return type:: Tuple[List[ResultCode], List[Optional[str]]]
Returns:: A tuple containing a return code and a string message indicating status.

TrackStop()[source]

Triggers the dish to stop tracking but will not apply brakes.

Return type:: Tuple[List[ResultCode], List[Optional[str]]]
Returns:: A tuple containing a return code and a string message indicating status.

Unstow()[source]

Triggers the dish to unstow.

Return type:: Tuple[List[ResultCode], List[Optional[str]]]
Returns:: A tuple containing a return code and a string message indicating status.

achievedPointing()[source]

Indicate achieved pointing of dish axis.

Return type:: Tuple[list[float], float, AttrQuality]

achievedTargetLock()[source]

Indicate Actual “On Sky” rms tracking error of device.

Return type:: Tuple[bool, float, AttrQuality]

actStaticOffsetValueEl()[source]

Indicate actual elevation static offset in arcsec.

Return type:: Tuple[float, float, AttrQuality]

actStaticOffsetValueXel()[source]

Indicate actual cross-elevation static offset in arcsec.

Return type:: Tuple[float, float, AttrQuality]

ambTOnInput(value)[source]

Set the value to be used for AmbTOn when the next pointing model is applied.

Setting this to True will enable ambient temperature corrections.

applicationState()[source]

Reflect the Application State node’s state.

Return type:: Tuple[ApplicationStateType, float, AttrQuality]

azimuthSpeed(value)[source]: Set the azimuth speed.

band0PointingModelParams(value)[source]: Update band 0 static pointing model parameters.

band1PointingModelParams(value)[source]: Update band 1 static pointing model parameters.

band2PointingModelParams(value)[source]: Update band 2 static pointing model parameters.

band3PointingModelParams(value)[source]: Update band 3 static pointing model parameters.

band4PointingModelParams(value)[source]: Update band 4 static pointing model parameters.

band5aPointingModelParams(value)[source]: Update band 5a static pointing model parameters.

band5bPointingModelParams(value)[source]: Update band 5b static pointing model parameters.

band6PointingModelParams(value)[source]: Update band 6 static pointing model parameters.

buildState()[source]

Get DS manager and DSC version structure.

Return type:: Tuple[str, float, AttrQuality]

configureTargetLock(value)[source]

Set the configureTargetLock.

Return type:: None

connectionState()[source]

Indicate connection state of device.

Return type:: CommunicationStatus

create_component_manager()[source]

Create a component manager.

Return type:: OPCUAComponentManager
Returns:: the component manager

currentMode()[source]

Reflect the Current Mode node’s state.

Return type:: Tuple[CurrentModeType, float, AttrQuality]

currentPointing()[source]

Display pointing feedback.

Return type:: Tuple[list[float], float, AttrQuality]

delete_device()[source]

Override delete_device to stop communication with DSC before deletion.

Return type:: None

desiredPointingAz()[source]

Indicate desired pointing of device azimuth axis.

Return type:: Tuple[list[float], float, AttrQuality]

desiredPointingEl()[source]

Indicate desired pointing of device elevation axis.

Return type:: Tuple[list[float], float, AttrQuality]

displayedDiagnosis()[source]

Indicate dsc DisplayedDiagnosis.

Return type:: Tuple[str, float, AttrQuality]

dscCmdAuth()[source]

Indicate DSC command authority.

Return type:: Tuple[DscCmdAuthType, float, AttrQuality]

dscCtrlState()[source]

Indicate dsc control state.

Return type:: Tuple[DscCtrlState, float, AttrQuality]

dscPowerLimitKw(value)[source]: Set the DSC Power Limit (kW).

dscState()[source]

Indicate dish structure controller state.

Return type:: Tuple[DSCState, float, AttrQuality]

elevationSpeed(value)[source]: Set the elevation speed.

healthState()[source]

Indicate the Health State.

Return type:: Tuple[HealthState, float, AttrQuality]

hhpConnected()[source]

Indicate whether the hand held pendant is connected.

Return type:: Tuple[bool, float, AttrQuality]

indexerPosition()[source]

Indicate operating mode of device.

Return type:: Tuple[IndexerPosition, float, AttrQuality]

init_command_objects()[source]

Initialise the command handlers.

Return type:: None

lastCommandInvoked()[source]

Return the last command invoked and its timestamp.

Return type:: Tuple[tuple[str, str], float, AttrQuality]

lastCommandUpdate()[source]

Reflect the last command update.

Return type:: Tuple[list[str], float, AttrQuality]

operatingMode()[source]

Indicate operating mode of device.

Return type:: Tuple[DSOperatingMode, float, AttrQuality]

pointingState()[source]

Indicate operating mode of device.

Return type:: Tuple[PointingState, float, AttrQuality]

powerState()[source]

Indicate power state of device.

Return type:: Tuple[DSPowerState, float, AttrQuality]

staticOnInput(value)[source]

Set the value to be used for StaticOn when the next pointing model is applied.

Setting this to True will enable static pointing model corrections.

tiltOnInput(value)[source]

Set the value to be used for TiltOn when the next pointing model is applied.

Options: OFF (0), TILTMETER_ONE (1), TILTMETER_TWO (2).

trackInterpolationMode(value)[source]: Set the trackInterpolationMode.

trackProgramMode(value)[source]: Set the trackProgramMode.

trackTableCurrentIndex()[source]

Index of current point being tracked in the track table.

Return type:: Tuple[int, float, AttrQuality]

trackTableEndIndex()[source]

Index of last point in the track table.

Return type:: Tuple[int, float, AttrQuality]

try_update_memorized_attributes_from_db()[source]

Read memorized attributes values from TangoDB and update device attributes.

Return type:: None

main(args=None, **kwargs)[source]

Launch a DSManager device.

Return type:: None