Docs for the rest of observatory excluding observatory

pyscope/observatory/_pwi4.py

@@ -27,11 +27,17 @@
 
 
 class _PWI4:
-    """
-    Client to the PWI4 telescope control application.
-    """
-
     def __init__(self, host="localhost", port=8220):
+        """
+        Client to the PWI4 telescope control application.
+
+        Parameters
+        ----------
+        host : `str`, default : "localhost", optional
+            The hostname or IP address of the computer running PWI4.
+        port : `int`, default : 8220, optional
+            The port number on which PWI4 is listening for HTTP requests.
+        """
         self.host = host
         self.port = port
         self.comm = _PWI4HttpCommunicator(host, port)

pyscope/observatory/ascom_camera.py

@@ -398,6 +398,7 @@ def LastExposureStartTime(self):
 
     @property
     def LastInputExposureDuration(self):
+        """The duration of the last exposure in seconds. (`float`)"""
         logger.debug(f"ASCOMCamera.LastInputExposureDuration property called")
         return self._last_exposure_duration
 

pyscope/observatory/ascom_rotator.py

@@ -8,6 +8,23 @@
 
 class ASCOMRotator(ASCOMDevice, Rotator):
     def __init__(self, identifier, alpaca=False, device_number=0, protocol="http"):
+        """
+        ASCOM implementation of the Rotator base class.
+
+        The class provides an interface to control an ASCOM-compatible rotator device, including methods for
+        moving, halting, and properties for determining the current position and movement state of the rotator.
+
+        Parameters
+        ----------
+        identifier : `str`
+            The device identifier.
+        alpaca : `bool`, default : `False`, optional
+            Whether the device is an Alpaca device.
+        device_number : `int`, default : 0, optional
+            The device number.
+        protocol : `str`, default : "http", optional
+            The protocol to use for communication with the device.
+        """
         super().__init__(
             identifier,
             alpaca=alpaca,

pyscope/observatory/ascom_safety_monitor.py

@@ -8,6 +8,25 @@
 
 class ASCOMSafetyMonitor(ASCOMDevice, SafetyMonitor):
     def __init__(self, identifier, alpaca=False, device_number=0, protocol="http"):
+        """
+        ASCOM implementation of the SafetyMonitor base class.
+
+        This class provides an interface to ASCOM-compatible safety monitors,
+        allowing the observatory to check if weather, power, and other
+        observatory-specific conditions allow safe usage of observatory equipment,
+        such as opening the roof or dome.
+
+        Parameters
+        ----------
+        identifier : `str`
+            The device identifier.
+        alpaca : `bool`, default : `False`, optional
+            Whether the device is an Alpaca device.
+        device_number : `int`, default : 0, optional
+            The device number.
+        protocol : `str`, default : "http", optional
+            The device communication protocol.
+        """
         super().__init__(
             identifier,
             alpaca=alpaca,

pyscope/observatory/ascom_switch.py

@@ -8,6 +8,23 @@
 
 class ASCOMSwitch(ASCOMDevice, Switch):
     def __init__(self, identifier, alpaca=False, device_number=0, protocol="http"):
+        """
+        ASCOM implementation of the Switch base class.
+
+        The class provides an interface to ASCOM-compatible switch devices, including methods for
+        getting and setting switch values, and getting switch names and descriptions.
+
+        Parameters
+        ----------
+        identifier : `str`
+            The device identifier.
+        alpaca : `bool`, default : `False`, optional
+            Whether the device is an Alpaca device.
+        device_number : `int`, default : 0, optional
+            The device number.
+        protocol : `str`, default : "http", optional
+            The protocol to use for communication with the device.
+        """
         super().__init__(
             identifier,
             alpaca=alpaca,