cgse 2024.7.0__py3-none-any.whl → 2025.0.2__py3-none-any.whl

egse/imageviewer/imageviewer.py

@@ -1,198 +0,0 @@
-"""
-Version of the Ginga reference viewer with extra, PLATO-specific plugins. Currently
-the following plugins have been implemented:
-
-    * SubFieldPosition: visualising the position of the sub-field an image represents, on the focal plane;
-    * MatchFocalPlane: rotating the image, to match the orientation of the focal-plane reference frame 
-                       (rather than the CCD reference frame).
-
-To start the image viewer execute the following command:
-
-    $ ./bin/start-image-viewer.bash
-
-This is the same as the Ginga reference viewer, with all the additional PLATO-specific
-plugins.  These plugins will then be available via the `Operation` button in the Plugin Manager bar
-(under `PLATO`).
-"""
-
-import ginga.rv.main as rv
-from PyQt5.QtWidgets import QApplication
-from ginga.misc.Bunch import Bunch
-import sys
-import os
-
-from ginga.misc import Settings, log
-from ginga.util import paths
-
-
-class ImageViewer(rv.ReferenceViewer):
-    # Plugins specifically for PLATO
-
-    plato_plugins = [
-        Bunch(module="SubFieldPosition", tab="Sub-Field Position", workspace="right", start=False,
-              menu="Sub-field Position", category="PLATO", ptype="local"),
-        Bunch(module="ExposureSelection", tab="Window and Exposure Selection", workspace="lleft", start=True,
-              menu="Window and Exposure Selection", category="PLATO", ptype="local"),
-    ]
-
-    def __init__(self, sys_argv, layout=rv.default_layout):
-        """
-        Initialisation of the Ginga reference viewer, with additional PLATO-specific plugins.
-        """
-
-        super().__init__()
-
-        self.plugins = self.plugins + self.plato_plugins
-
-
-        self.add_default_plugins()
-        self.add_separately_distributed_plugins()
-
-        # Parse command line options with argparse module
-        from argparse import ArgumentParser
-
-        argprs = ArgumentParser(description="Run the image viewer.")
-        self.add_default_options(argprs)
-        argprs.add_argument('-V', '--version', action='version', version='%(prog)s {}'.format(rv.version.version))
-        (options, args) = argprs.parse_known_args(sys_argv[1:])
-
-        if options.display:
-            os.environ['DISPLAY'] = options.display
-
-        # Are we debugging this?
-        if options.debug:
-
-            import pdb
-
-            pdb.run('viewer.main(options, args)')
-
-        # Are we profiling this?
-        elif options.profile:
-            import profile
-
-            print(("%s profile:" % sys_argv[0]))
-            profile.runctx('viewer.main(options, args)', dict(options=options, args=args, viewer=viewer), {})
-
-        else:
-
-            # Create a logger
-            logger = log.get_logger(name='ginga', options=options)
-
-            # Get settings (preferences)
-            basedir = paths.ginga_home
-            if not os.path.exists(basedir):
-                try:
-                    os.mkdir(basedir)
-                except OSError as e:
-                    logger.warning("Couldn't create ginga settings area (%s): %s" % (basedir, str(e)))
-                    logger.warning("Preferences will not be able to be saved")
-
-            self.main(options, args)
-
-        # prefs = Settings.Preferences(basefolder=basedir, logger=logger)
-        # settings = prefs.create_category('plato')
-        # settings.set_defaults(channel_prefix="PLATO")
-        # settings.load(onError='silent')
-
-# class ImageViewer(rv.ReferenceViewer):
-#
-#     # Plugins specifically for PLATO
-#
-#     plato_plugins = [
-#         Bunch(module="SubFieldPosition", tab="Sub-Field Position", workspace="right", start=False, menu="Sub-field Position", category="PLATO", ptype="local"),
-#         Bunch(module="ExposureSelection", tab="Window and Exposure Selection", workspace="lleft", start=True, menu="Window and Exposure Selection", category="PLATO", ptype="local"),
-#     ]
-#
-#
-#     def __init__(self, layout=rv.default_layout):
-#
-#         """
-#         Initialisation of the Ginga reference viewer, with additional PLATO-specific plugins.
-#         """
-#
-#         super().__init__()
-#
-#         self.plugins = self.plugins + self.plato_plugins
-#
-#
-# def image_viewer(sys_argv):
-#
-#     """
-#     Create the image viewer from the command line.
-#
-#     Args:
-#         - sys_argv: Command line arguments.
-#     """
-#
-#     viewer = ImageViewer(layout=rv.default_layout)
-#
-#     viewer.add_default_plugins()
-#     viewer.add_separately_distributed_plugins()
-#
-#     # Parse command line options with argparse module
-#     from argparse import ArgumentParser
-#
-#     argprs = ArgumentParser(description="Run the image viewer.")
-#     viewer.add_default_options(argprs)
-#     argprs.add_argument('-V', '--version', action='version',
-#                         version='%(prog)s {}'.format(rv.version.version))
-#     (options, args) = argprs.parse_known_args(sys_argv[1:])
-#
-#
-#     if options.display:
-#         os.environ['DISPLAY'] = options.display
-#
-#     # Are we debugging this?
-#     if options.debug:
-#         import pdb
-#
-#         pdb.run('viewer.main(options, args)')
-#
-#     # Are we profiling this?
-#     elif options.profile:
-#         import profile
-#
-#         print(("%s profile:" % sys_argv[0]))
-#         profile.runctx('viewer.main(options, args)',
-#                        dict(options=options, args=args, viewer=viewer), {})
-#
-#     else:
-#
-#         # Create a logger
-#         logger = log.get_logger(name='ginga', options=options)
-#
-#         # Get settings (preferences)
-#         basedir = paths.ginga_home
-#         if not os.path.exists(basedir):
-#             try:
-#                 os.mkdir(basedir)
-#             except OSError as e:
-#                 logger.warning(
-#                     "Couldn't create ginga settings area (%s): %s" % (
-#                         basedir, str(e)))
-#                 logger.warning("Preferences will not be able to be saved")
-#
-#         viewer.main(options, args)
-#
-#         # prefs = Settings.Preferences(basefolder=basedir, logger=logger)
-#         # settings = prefs.create_category('plato')
-#         # settings.set_defaults(channel_prefix="PLATO")
-#         # settings.load(onError='silent')
-
-
-def main():
-
-    args = list(sys.argv)
-
-    app = QApplication(args)
-
-    # view = image_viewer(sys.argv)
-    view = ImageViewer(sys.argv)
-    view.show()
-
-    return app.exec_()
-
-
-if __name__ == '__main__':
-        sys.exit(main())
-   # image_viewer(sys.argv)

egse/imageviewer/matchfocalplane.py

@@ -1,179 +0,0 @@
-"""
-This module provides a (local) plugin for the Ginga reference viewer, rotating the
-sub-field to match the orientation of the focal plane.  The orientation angle of the
-sub-field (and CCD) w.r.t. the focal plane (in degrees) is read from the "CROTA2" 
-keyword in the header of the loaded FITS file.
-
-To start the Ginga reference viewer, with this extra plugin, execute the following set of commands:
-
-    $ mkdir $HOME/.ginga/plugins
-    $ cp matchfocalplane.py $HOME/.ginga/plugins/MatchFocalPlane.py
-    $ ginga --plugins=MatchFocalPlane --loglevel=20 --stderr --log=/tmp/ginga.log
-
-The plugin will then be available via the "Operation" button in the Plugin Manager bar
-(currently under "Custom").
-
-Alternatively, you can start the image viewer with the command:
-
-    $ ./bin/start-image-viewer.bash
-
-This is the same as the Ginga reference viewer, with all the additional PLATO-specific
-plugins.  These plugins will then be available via the "Operation" button in the Plugin Manager bar
-(under "PLATO").
-"""
-
-from ginga import GingaPlugin
-from egse.gui.focalplane import FocalPlaneWidgetWithSubField
-from ginga.gw import Widgets
-
-class MatchFocalPlane(GingaPlugin.LocalPlugin):
-
-    def __init__(self, fv, fitsimage):
-
-        """
-        Initialisation of a new (local) plugin for the Ginga reference viewer, to rotate 
-        the sub-field to match the orientation of the focal plane.  The orientation angle
-        of the sub-field (and CCD) w.r.t. the focal plane (in degrees) is read from the
-        "CROTA2" keyword in the header of the loaded FITS file.
-        Called when the plugin is loaded from the first time.
-
-        :param fv: Reference to the Ginga (reference viewer) shell.
-
-        :param fitsimage: Reference to the specific viewer object associated with
-                          the channel on which the plugin is being invoked.
-        """
-
-        super(MatchFocalPlane, self).__init__(fv, fitsimage)
-
-        self.t_ = self.fitsimage.get_settings()
-
-    def build_gui(self, container):
-
-        """
-        When the plugin is activated, a GUI is built and packed into the given 
-        container.  This consists of four buttons:
-            - "Match FP": to rotate the sub-field to match the orientation of the focal plane;
-            - "Restore": to go back to the original orientation of the sub-field (with the readout
-              register at the bottom of the CCD);
-            - "Save": to open this image next time with the current orientation;
-            - "Close": to close the plugin (without saving the current orientation).
-
-        :param container: Container in which to pack the GUI.
-        """
-
-        vbox = Widgets.VBox()
-        vbox.set_border_width(1)
-        vbox.set_spacing(1)
-
-        # No FITS file loaded
-
-        if self.fitsimage.get_image() is None:
-
-            text = "No image has been loaded into the current channel.  Please, close this plugin by pressing the \"Close\" button."
-            no_image_label = Widgets.Label(text)
-            vbox.add_widget(no_image_label)
-
-        # FITS file loaded
-
-        else:
-
-            header = self.fitsimage.get_image().get_header()
-            keys = list(header.keys())
-
-            if "CROTA2" in keys:
-
-                self.rotation_angle = header.get_card("CROTA2")["value"]
-            
-            else:
-                text = "The loaded FITS file does not contain the CROTA2 keyword in the header.  Please, close this plugin by pressing the \"Close\" button."
-                no_crota2_label = Widgets.Label(text)
-                vbox.add_widget(no_crota2_label)
-
-
-        buttons = Widgets.HBox()
-        buttons.set_border_width(4)
-        buttons.set_spacing(3)
-
-        # Match button
-
-        match_button = Widgets.Button("Match FP")
-        match_button.set_tooltip("Rotate the sub-field to match the orientation of the focal plane")
-        match_button.add_callback('activated', lambda w: self.match())
-        buttons.add_widget(match_button)
-
-        # Save button
-
-        save_button = Widgets.Button("Save settings")
-        save_button.set_tooltip("Open this image next time with the current orientation")
-        save_button.add_callback("activated", lambda w: self.save_settings())
-        buttons.add_widget(save_button)
-
-        # Restore button
-
-        restore_button = Widgets.Button("Restore")
-        restore_button.set_tooltip("Go back to the original orientation of the sub-field (with the readout register at the bottom of the CCD)")
-        restore_button.add_callback('activated', lambda w: self.restore())
-        buttons.add_widget(restore_button)
-
-        # Close button
-
-        close_button = Widgets.Button("Close")
-        close_button.set_tooltip("Close this plugin")
-        close_button.add_callback('activated', lambda w: self.close())
-        buttons.add_widget(close_button)
-
-        vbox.add_widget(buttons)
-
-        container.add_widget(vbox, stretch=1)
-
-    def close(self):
-
-        """
-        Close action (to execute when the "Close" button is pushed).
-        """
-        
-        self.fv.stop_local_plugin(self.chname, str(self))
-
-        return True
-
-    def match(self):
-
-        """
-        Rotate the image (in the Ginga reference viewer) over the angle, specified by the CROTA2
-        keyword in the header of the FITS file.
-        """
-
-        self.t_.set(rot_deg=self.rotation_angle)
-        self.fitsimage.center_image()
-
-        return True
-
-    def restore(self):
-
-        """
-        Go back to the original orientation of the sub-field (with the readout register
-        at the bottom of the CCD)
-        """
-
-        self.t_.set(rot_deg=0.0)
-        self.fitsimage.center_image()
-
-        return True
-
-    def save_settings(self):
-
-        """
-        Save the current settings, to open the image next time with the current orientation.
-        """
-
-        self.t_.save()
-
-
-    def __str__(self):
-
-        """
-        Returns the string representation of this plugin.  This needs to be the small-case
-        version of the class name in order for the Ginga reference viewer to pick it up.
-        """
-
-        return "matchfocalplane"

egse/imageviewer/subfieldposition.py

@@ -1,133 +0,0 @@
-"""
-This module provides a (local) plugin for the Ginga reference viewer, visualising
-the position of the sub-field an image represents, on the focal plane.  The information
-on the position of the sub-field is read from the header file of the loaded FITS file,
-from the following keywords:
-
-    * CCD_ID: code of the CCD on which the sub-field lies [1, 2, 3, 4];
-    * (-CRPIX2, -CRPIX1): CCD coordinates (row, column) [pixels] of the origin
-      of the sub-field in the CCD coordinate system for the CCD with the specified
-      code (from the CCD_ID keyword);
-    * NAXIS2: number of rows [pixels] in the sub-field;
-    * NAXIS2: number of columns [pixels] in the sub-field.
-
-To start the Ginga reference viewer, execute the following set of commands:
-
-    $ mkdir $HOME/.ginga/plugins
-    $ cp subfieldposition.py $HOME/.ginga/plugins/SubFieldPosition.py
-    $ ginga --plugins=SubFieldPosition --loglevel=20 --stderr --log=/tmp/ginga.log
-
-The plugin will then be available via the "Operation" button in the Plugin Manager bar
-(currently under "Custom").
-
-Alternatively, you can start the image viewer with the command:
-
-    $ ./bin/start-image-viewer.bash
-
-This is the same as the Ginga reference viewer, with all the additional PLATO-specific
-plugins.  These plugins will then be available via the "Operation" button in the Plugin Manager bar
-(under "PLATO").
-"""
-
-from ginga import GingaPlugin
-from egse.gui.focalplane import FocalPlaneWidgetWithSubField
-from ginga.gw import Widgets
-
-class SubFieldPosition(GingaPlugin.LocalPlugin):
-
-    def __init__(self, fv, fitsimage):
-
-        """
-        Initialisation of a new (local) plugin for the Ginga reference viewer, to visualise 
-        the position of the sub-field an image represents, on the focal plane.  The information
-        on the position of the sub-field is read from the header file of the loaded FITS file
-        Called when the plugin is loaded from the first time.
-
-        Args:
-            - fv: Reference to the Ginga (reference viewer) shell.
-            - fitsimage: Reference to the specific viewer object associated with
-                        the channel on which the plugin is being invoked.
-        """
-
-        super(SubFieldPosition, self).__init__(fv, fitsimage)
-
-    def build_gui(self, container):
-
-        """
-        When the plugin is activated, a GUI is built and packed into the given 
-        container.  This consists of a plot window, visualising the focal plane 
-        (with a blue circle indicating the field-of-view) on which the sub-field
-        will be drawn (if the required keywords are available in the FITS header),
-        and a combobox to switch between coordinate systems (focal-plane coordinates,
-        pixel coordinates, and field angles).
-
-        Args:
-            - container: Container in which to pack the GUI.
-        """
-
-        vbox = Widgets.VBox()
-        vbox.set_border_width(1)
-        vbox.set_spacing(1)
-
-        self.focal_plane = FocalPlaneWidgetWithSubField()
-        vbox.add_widget(self.focal_plane)
-
-        captions = [("Close", "button")]
-
-        w, b = Widgets.build_info(captions, orientation="vertical")
-        self.w.update(b)
-
-        self.w.close_button = b.close
-        self.w.close_button.add_callback('activated', lambda w: self.close())
-
-        vbox.add_widget(w)
-        container.add_widget(vbox, stretch=1)
-
-        self.redo()
-
-
-    def redo(self):
-
-        """
-        Update the plugin when a new FITS file is loaded or a new image is shown in the 
-        central widget of the image viewer.
-        """
-        
-        current_image = self.channel.get_current_image()
-
-        # No file loaded -> no action needed
-
-        if current_image is None:
-
-            return True
-
-        # File loaded
-
-        header = current_image.get_header()
-
-        ccd_code = header.get_card("CCD_ID")["value"]               # CCD code
-        zeropoint_row = -header.get_card("CRPIX2")["value"]         # Sub-field zeropoint row
-        zeropoint_column = -header.get_card("CRPIX1")["value"]      # Sub-field zeropoint column
-        num_rows = header.get_card("NAXIS2")["value"]               # Number of rows in the sub-field
-        num_columns = header.get_card("NAXIS1")["value"]            # Number of columns in the sub-field
-        
-        self.focal_plane.focal_plane.set_subfield(ccd_code=ccd_code, zeropoint_row=zeropoint_row, zeropoint_column=zeropoint_column, num_rows=num_rows, num_columns=num_columns)
-
-    def close(self):
-
-        """
-        Close action (to execute when the "Close" button is pushed).
-        """
-        
-        self.fv.stop_local_plugin(self.chname, str(self))
-        
-        return True
-
-    def __str__(self):
-
-        """
-        Returns the string representation of this plugin.  This needs to be the small-case
-        version of the class name in order for the Ginga reference viewer to pick it up.
-        """
-
-        return "subfieldposition"

egse/lampcontrol/__init__.py

@@ -1,4 +0,0 @@
-class LampError(Exception):
-    """A Lamp specific error."""
-
-    pass

egse/lampcontrol/beaglebone/beaglebone.py

@@ -1,178 +0,0 @@
-from calendar import day_abbr
-import logging
-
-from egse.decorators import dynamic_interface
-from egse.device import DeviceInterface
-from egse.proxy import Proxy
-from egse.settings import Settings
-from egse.lampcontrol.beaglebone.beaglebone_devif import BeagleboneDeviceInterface
-from egse.zmq_ser import connect_address
-
-logger = logging.getLogger(__name__)
-
-CTRL_SETTINGS = Settings.load("BeagleBone Lamp Control Server")
-DEVICE_SETTINGS = Settings.load(filename='beaglebone.yaml')
-
-
-class BeagleboneError(Exception):
-    pass
-
-
-class BeagleboneInterface(DeviceInterface):
-    """ BeagleBone GSM controller base class."""
-
-    @dynamic_interface
-    def set_lamp(self, state):
-        return NotImplemented
-
-    @dynamic_interface
-    def set_interlock(self, state):
-        return NotImplemented
-
-    @dynamic_interface
-    def get_lamp_on(self):
-        return NotImplemented
-
-    @dynamic_interface
-    def get_laser_on(self):
-        return NotImplemented
-
-    @dynamic_interface
-    def get_lamp_module_fault(self):
-        return NotImplemented
-
-    @dynamic_interface
-    def get_controller_fault(self):
-        return NotImplemented
-
-    @dynamic_interface
-    def fix_controller_fault(self):
-        return NotImplemented
-
-
-class BeagleboneSimulator(BeagleboneInterface):
-
-    def __init__(self):
-       self._is_connected = True
-
-    def is_connected(self):
-       return self._is_connected
-
-    def is_simulator(self):
-       return True
-
-    def connect(self):
-       self._is_connected = True
-
-    def disconnect(self):
-       self._is_connected = False
-
-    def reconnect(self):
-       if self.is_connected():
-           self.disconnect()
-       self.connect()
-
-    def set_lamp(self, state):
-        pass
-
-    def set_interlock(self, state):
-        pass
-
-    def get_lamp_on(self):
-        return 0
-
-    def get_laser_on(self):
-        return 0
-
-    def get_lamp_module_fault(self):
-        return 0
-
-    def get_controller_fault(self):
-        return 0
-
-
-class BeagleboneController(BeagleboneInterface):
-
-    def __init__(self):
-        super().__init__()
-
-        logger.debug('Initalizing BeagleBone GSM Controller')
-
-        try:
-            self.beaglebone = BeagleboneDeviceInterface()
-            self.beaglebone.connect()
-        except BeagleboneError as exc:
-            logger.warning(f"BeagleboneError caught: Couldn't establish connection ({exc})")
-            raise BeagleboneError(
-                "Couldn't establish a connection with BeagleBone controller."
-            ) from exc
-
-    def is_simulator(self):
-        return False
-
-    def is_connected(self):
-        return self.beaglebone.is_connected()
-
-    def connect(self):
-        if not self.beaglebone.is_connected():
-            self.beaglebone.connect()
-
-    def disconnect(self):
-        self.beaglebone.disconnect()
-
-    def reconnect(self):
-        self.beaglebone.reconnect()
-
-    def set_lamp(self, state):
-        self.beaglebone.set_lamp(state)
-
-
-    def set_interlock(self, state):
-        self.beaglebone.set_interlock(state)
-
-
-    def get_lamp_on(self):
-        return self.beaglebone.get_lamp_on()
-
-
-    def get_laser_on(self):
-        return self.beaglebone.get_laser_on()
-
-
-    def get_lamp_module_fault(self):
-        return self.beaglebone.get_lamp_module_fault()
-
-
-    def get_controller_fault(self):
-        return self.beaglebone.get_controller_fault()
-
-    def fix_controller_fault(self):
-        self.beaglebone.fix_controller_fault()
-
-
-class BeagleboneProxy(Proxy, BeagleboneInterface):
-    def __init__(self, protocol=CTRL_SETTINGS.PROTOCOL,
-                 hostname=CTRL_SETTINGS.HOSTNAME,
-                 port=CTRL_SETTINGS.COMMANDING_PORT):
-        super().__init__(connect_address(protocol, hostname, port))
-
-
-if __name__ == "__main__":
-    bbb = BeagleboneProxy()
-    
-    print(f"Lamp state: {bbb.get_lamp_on()}\n"\
-          f"Laster state: {bbb.get_laser_on()}\n"\
-          f"Module fault: {bbb.get_lamp_module_fault()}\n"\
-          f"Controller fault: {bbb.get_controller_fault()}\n")
-    bbb.set_lamp(True)
-    
-    while not bbb.get_lamp_on():
-        pass
-    
-    while not bbb.get_laser_on():
-        pass
-    
-    print(f"Lamp state: {bbb.get_lamp_on()}\n"\
-          f"Laster state: {bbb.get_laser_on()}\n"\
-          f"Module fault: {bbb.get_lamp_module_fault()}\n"\
-          f"Controller fault: {bbb.get_controller_fault()}")