libgs.groundstation.GroundStationBase

class libgs.groundstation.GroundStationBase[source]

Base class for ground stations.

If implementing a new GroundStation class, derive from this class and overload as a minimum the interface methods:

Note

do_action, set_rangerate and transmit are implemented in GroundStation as simple wrappers with some logging of the respective methods protocols.protocolbase.ProtocolBase.send_bytes(), protocols.protocolbase.ProtocolBase.do_action(), hardware.RadioBase.set_range_rate().

Warning

In the future these interface methods are likely to be merged into this base class instead, and will no longer require overloading in new implementations.

The following methods can be overloaded if the functionality is required:

Methods

do_action(desc, *args, **kwargs) Perform an Action.
get_azel() Loop through the installed rotators and return a list of az/el positions by querying each individual rotator’s get_azel() method.
init_rx() Wrapper for protocols.protocolbase.ProtocolBase.init_rx()
init_rxtx() Wrapper for protocols.protocolbase.ProtocolBase.init_rxtx()
power_down() This method is called when class destroys and can be overloaded to perform tasks such as powering down amplifiers etc.
power_up() This method is called when class initialises and can be overloaded to perform tasks such as powering on amplifiers etc.
set_azel(az, el[, block]) Set the az/el pointing for each installed rotators
set_rangerate(range_rate) Set the range_rate for all installed radios.
start_track(nid_or_pdata, **kwargs) Non-blocking tracking.
stop_track([block]) Stop tracking satellite.
stow([block]) Stow all installed rotators.
terminate() Wrapper for protocols.protocolbase.ProtocolBase.terminate()
track(nid_or_pdata, **kwargs) Track satellite
transmit(msg[, wait]) Send bytes to satellite Should normally be a wrapper for protocols.protocolbase.ProtocolBase.send_bytes()

Attributes

MONITOR_SAVE_DT_NOTRACK The time interval at which to run the monitor callback when not tracking
MONITOR_SAVE_DT_TRACK The time interval at which to run the monitor callback while tracking
monitor Set / Get a Monitor.
propagator Set / Get a propagator.
protocol Property to set/get the current protocol.
protocols A list of protocols (see ProtocolBase ) that are installed on the groundstation
radios A list of radios (see RadioBase ) that are installed on the groundstation
rotators A list of rotators (see RotatorBase ) that are installed on the groundstation
rpcserver Assign an RPCServer to the Ground Station if you want to be able to call its methods remotely over XMLRPC.
scheduler The currently associated Scheduler.

Inherited from base class