tango_simlib.examples modules

tango_simlib.examples.mkat_vds module

tango_simlib.examples.mkat_vds.main()

tango_simlib.examples.weather1 module

tango_simlib.examples.weather1.main()

tango_simlib.examples.weather2 module

tango_simlib.examples.weather2.main()

tango_simlib.examples.weather3 module

tango_simlib.examples.weather3.main()

tango_simlib.examples.override_class module

An example of the user-defined override class. @author MeerKAT CAM team <cam@ska.ac.za>

exception tango_simlib.examples.override_class.DishSimError

Bases: exceptions.Exception

Raised when a Dish simulator action could not be executed.

class tango_simlib.examples.override_class.OverrideDish

Bases: object

AZIM_DRIVE_MAX_RATE = 2.0

ELEV_DRIVE_MAX_RATE = 1.0

action_configureband1(model, tango_dev=None, data_input=None)

This command triggers the Dish to transition to the CONFIGURE Dish Element Mode, and returns to the caller. To configure the Dish to operate in frequency band 1. On completion of the band configuration, Dish will automatically revert to the previous Dish mode (OPERATE or STANDBY-FP).

data_input: str

timestamp

action_configureband2(model, tango_dev=None, data_input=None)

This command triggers the Dish to transition to the CONFIGURE Dish Element Mode, and returns to the caller. To configure the Dish to operate in frequency band 2. On completion of the band configuration, Dish will automatically revert to the previous Dish mode (OPERATE or STANDBY-FP).

data_input: str

timestamp

action_configureband3(model, tango_dev=None, data_input=None)

This command triggers the Dish to transition to the CONFIGURE Dish Element Mode, and returns to the caller. To configure the Dish to operate in frequency band 3. On completion of the band configuration, Dish will automatically revert to the previous Dish mode (OPERATE or STANDBY-FP).

data_input: str

timestamp

action_configureband4(model, tango_dev=None, data_input=None)

This command triggers the Dish to transition to the CONFIGURE Dish Element Mode, and returns to the caller. To configure the Dish to operate in frequency band 4. On completion of the band configuration, Dish will automatically revert to the previous Dish mode (OPERATE or STANDBY-FP).

data_input: str

timestamp

action_configureband5(model, tango_dev=None, data_input=None)

This command triggers the Dish to transition to the CONFIGURE Dish Element Mode, and returns to the caller. To configure the Dish to operate in frequency band 5. On completion of the band configuration, Dish will automatically revert to the previous Dish mode (OPERATE or STANDBY-FP).

data_input: str

timestamp

action_lowpower(model, tango_dev=None, data_input=None)

This command triggers the Dish to transition to the LOW power state. All subsystems go into a low power state to power only the essential equipment. Specifically the Helium compressor will be set to a low power consumption, and the drives will be disabled. When issued a STOW command while in LOW power, the DS controller should be able to turn the drives on, stow the dish and turn the drives off again. The purpose of this mode is to enable the observatory to perform power management (load curtailment), and also to conserve energy for non-operating dishes.

data_input: None

action_setmaintenancemode(model, tango_dev=None, data_input=None)

This command triggers the Dish to transition to the MAINTENANCE Dish Element Mode, and returns to the caller. To go into a state that is safe to approach the Dish by a maintainer, and to enable the Engineering interface to allow direct access to low level control and monitoring by engineers and maintainers. This mode will also enable engineers and maintainers to upgrade SW and FW. Dish also enters this mode when an emergency stop button is pressed.

data_input: None

action_setoperatemode(model, tango_dev=None, data_input=None)

This command triggers the Dish to transition to the OPERATE Dish Element Mode, and returns to the caller. This mode fulfils the main purpose of the Dish, which is to point to designated directions while capturing data and transmitting it to CSP.

data_input: None

action_setstandbyfpmode(model, tango_dev=None, data_input=None)

This command triggers the Dish to transition to the STANDBY-FP Dish Element Mode, and returns to the caller. To prepare all subsystems for active observation, once a command is received by TM to go to the FULL_POWER mode.

data_input: None

action_setstandbylpmode(model, tango_dev=None, data_input=None)

This command triggers the Dish to transition to the STANDBY-LP Dish Element Mode, and returns to the caller. Standby_LP is the default mode when the Dish is configured for low power consumption, and is the mode wherein Dish ends after a start up procedure.

data_input: None

action_setstowmode(model, tango_dev=None, data_input=None)

This command triggers the Dish to transition to the STOW Dish Element Mode, and returns to the caller. To point the dish in a direction that minimises the wind loads on the structure, for survival in strong wind conditions. The Dish is able to observe in the stow position, for the purpose of transient detection.

data_input: None

action_slew(model, tango_dev=None, data_input=None)

The Dish is tracking the commanded pointing positions within the specified TRACK pointing accuracy.

data_input: list

[Timestamp] [azimuth] [elevation]

pre_update(sim_model, sim_time, dt)

class tango_simlib.examples.override_class.OverrideVds

Bases: object

An example of the override class for the TANGO device class ‘MKATVDS’. It provides all the implementations of the command handler functions for the commands specified in the POGO generated XMI data description file.

action_camerapoweron(model, tango_dev=None, data_input=None)

Switch camera electronics on or off.

data_input[0] : str

‘on’ or ‘off’ value.

action_floodlighton(model, tango_dev=None, data_input=None)

Set floodlight to a on or off.

data_input[0] : str

‘on’ or ‘off’ value.

action_focus(model, tango_dev=None, data_input=None)

Focuses camera to a specified direction or specified position.

data_input[0] : str

focus direction e.g. ‘far’, ‘near’, ‘to’.

data_input[1] : str

Optional argument, focus position; a stringified integer numeral.

action_pan(model, tango_dev=None, data_input=None)

Drive camera to a pan direction(left or right) or pan to specified position.

data_input[0] : str

pan direction e.g. ‘left’, ‘right’, ‘to’.

data_input[1] : str

Optional argument, pan position; a stringified integer numeral.

action_presetclear(model, tango_dev=None, data_input=None)

Clear the specified preset.

data_input[0] : str

receptor name (from m000 to m063).

action_presetgoto(model, tango_dev=None, data_input=None)

Go to preset stored position(pan, tilt, zoom).

data_input[0] : str

receptor name (from m000 to m063).

action_presetset(model, tango_dev=None, data_input=None)

Set the position which the camera is at currently as preset position.

data_input[0] : str

receptor name (from m000 to m063).

action_stop(model, tango_dev=None, data_input=None)

Stop camera.

action_tilt(model, tango_dev=None, data_input=None)

Drive camera to a tilt direction or specified position.

data_input[0] : str

tilt_direction e.g. ‘up’, ‘down’, ‘to’.

data_input[1] : str

Optional argument, tilt_position; a stringified integer numeral.

action_trapupdate(model, tango_dev=None, data_input=None)

Update trap. this request is called by a script.

data_input : str

Trap update from a script (8, ‘on’).

action_zoom(model, tango_dev=None, data_input=None)

Zoom camera to a specified direction or specified position.

data_input[0] : str

zoom_direction e.g. ‘tele’, ‘wide’, ‘to’.

data_input[1] : str

Optional argument, zoom_position; a stringified numeral.

class tango_simlib.examples.override_class.OverrideWeather

Bases: object

An example of the override class for the TANGO device class ‘Weather’. It provides all the implementations of the command handler functions for the commands specified in the POGO generated XMI data description file.

action_add(model, tango_dev=None, data_input=None)

Add two or more numbers together and return their sum.

action_multiplystringby3(model, tango_dev=None, data_input=None)

Takes a string and multiplies it by a constant integer value of 3.

action_off(model, tango_dev=None, data_input=None)

Changes the State of the device to OFF.

action_on(model, tango_dev=None, data_input=None)

Changes the State of the device to ON.

class tango_simlib.examples.override_class.OverrideWeatherSimControl

Bases: object

An example of the override class for the TANGO device class ‘SimControl’. It provides all the implementations of the command handler functions for the commands required to stimulate a running TANGO device in real time.

test_action_setattributemaxvalue(model, tango_dev=None, data_input=None)

This command sets an attribute value to its maximum value to set its quality to Alarm state to warning.

test_action_setoffrainstorm(model, tango_dev=None, data_input=None)

test_action_setoffwindstorm(model, tango_dev=None, data_input=None)

test_action_simulatefaultdevicestate(model, tango_dev=None, data_input=None)

This command sets the current device state to fault/on.

test_action_stimulateattributeconfigurationerror(model, tango_dev=None, data_input=None)

This command sets the attribute maximum allowed value to be the same as that minimum allowed value.

test_action_stopquantitysimulation(model, tango_dev=None, data_input=None)

Totally sets the simulated quantities` values to a constant value of zero.

test_action_stoprainfall(model, tango_dev=None, data_input=None)

Totally sets the simulated quantity rainfall to a constant value of zero.

test_action_stoprainstorm(model, tango_dev=None, data_input=None)

test_action_stopwindstorm(model, tango_dev=None, data_input=None)

exception tango_simlib.examples.override_class.VdsSimError

Bases: exceptions.Exception

Raised when a Video Display System simulator action could not be executed.

exception tango_simlib.examples.override_class.WeatherSimError

Bases: exceptions.Exception

Raised when a Weather simulator action could not be executed.