mxcubecore 1.393.0__py3-none-any.whl → 1.394.0__py3-none-any.whl

mxcubecore/HardwareObjects/SpecMotorWPositions.py

@@ -1,5 +1,3 @@
-import logging
-
 from mxcubecore.HardwareObjects import SpecMotor
 
 
@@ -12,9 +10,7 @@ class SpecMotorWPositions(SpecMotor.SpecMotor):
         try:
             positions = self["positions"]
         except Exception:
-            logging.getLogger("HWR").error(
-                "%s does not define positions.", str(self.name())
-            )
+            self.log.error("%s does not define positions.", str(self.name()))
         else:
             for definedPosition in positions:
                 positionUsername = definedPosition.get_property("username")
@@ -22,7 +18,7 @@ class SpecMotorWPositions(SpecMotor.SpecMotor):
                 try:
                     offset = float(definedPosition.get_property("offset"))
                 except Exception:
-                    logging.getLogger("HWR").warning(
+                    self.log.warning(
                         "%s, ignoring position %s: invalid offset.",
                         str(self.name()),
                         positionUsername,
@@ -59,7 +55,7 @@ class SpecMotorWPositions(SpecMotor.SpecMotor):
         SpecMotor.SpecMotor.motorMoveDone.__func__(self, channelValue)
 
         pos = self.get_value()
-        logging.getLogger("HWR").debug("current pos=%s", pos)
+        self.log.debug("current pos=%s", pos)
 
         for positionName in self.predefinedPositions:
             if (
@@ -78,7 +74,7 @@ class SpecMotorWPositions(SpecMotor.SpecMotor):
         try:
             self.move(self.predefinedPositions[positionName])
         except Exception:
-            logging.getLogger("HWR").exception(
+            self.log.exception(
                 "Cannot move motor %s: invalid position name.", str(self.username)
             )
 
@@ -101,4 +97,4 @@ class SpecMotorWPositions(SpecMotor.SpecMotor):
             self.predefinedPositions[str(positionName)] = float(positionOffset)
             self.sortPredefinedPositionsList()
         except Exception:
-            logging.getLogger("HWR").exception("Cannot set new predefined position")
+            self.log.exception("Cannot set new predefined position")

mxcubecore/HardwareObjects/SpecMotorWSpecPositions.py

@@ -12,8 +12,6 @@ template:
   </object>
 """
 
-import logging
-
 from mxcubecore.HardwareObjects import SpecMotor
 
 
@@ -71,7 +69,7 @@ class SpecMotorWSpecPositions(SpecMotor.SpecMotor):
         try:
             self.move(self.predefinedPositions[positionName])
         except Exception:
-            logging.getLogger("HWR").exception(
+            self.log.exception(
                 "Cannot move motor %s: invalid position name.", str(self.username)
             )
 
@@ -90,4 +88,4 @@ class SpecMotorWSpecPositions(SpecMotor.SpecMotor):
         try:
             self.execute_command("setNewPosition", positionName, positionOffset)
         except AttributeError:
-            logging.getLogger("HWR").exception("Cannot set new predefined position")
+            self.log.exception("Cannot set new predefined position")

mxcubecore/HardwareObjects/SpecShell.py

@@ -6,8 +6,6 @@ template:
   </procedure>
 """
 
-import logging
-
 from mxcubecore.BaseHardwareObjects import HardwareObject
 
 try:
@@ -54,7 +52,7 @@ class SpecShell(HardwareObject):
             )
         except AttributeError:
             self.specConnection = None
-            logging.getLogger("HWR").error("SpecShell: you must specify a spec version")
+            self.log.error("SpecShell: you must specify a spec version")
         else:
             self.specOutput.connectToSpec(
                 "output/tty",
@@ -155,7 +153,7 @@ class SpecShell(HardwareObject):
                 try:
                     buf_list = buf.split()
                 except Exception:
-                    logging.getLogger("HWR").exception("")
+                    self.log.exception("")
                 else:
                     i = 0
                     while i < len(buf_list):
@@ -163,20 +161,20 @@ class SpecShell(HardwareObject):
                         try:
                             cmd_aux = buf_list[i + 1]
                         except Exception:
-                            logging.getLogger("HWR").exception("")
+                            self.log.exception("")
                         else:
                             try:
                                 left_par = cmd_aux[0]
                                 right_par = cmd_aux[-1]
                                 midle_num = cmd_aux[1:-1]
                             except Exception:
-                                logging.getLogger("HWR").exception("")
+                                self.log.exception("")
                             else:
                                 if left_par == "(" and right_par == ")":
                                     try:
                                         int(midle_num)
                                     except Exception:
-                                        logging.getLogger("HWR").exception("")
+                                        self.log.exception("")
                                     else:
                                         commands_list.append(cmd_name.lstrip("*"))
                         i += 2
@@ -222,7 +220,7 @@ class SpecShell(HardwareObject):
             try:
                 self.specShellCommand.abort()
             except SpecClient.SpecClientError.SpecClientError as diag:
-                logging.getLogger("HWR").exception("")
+                self.log.exception("")
 
     def outputReceived(self, output):
         if self.lsdefRunning:
@@ -250,7 +248,7 @@ class SpecShell(HardwareObject):
                 else:
                     cmds.append(cmd.method)
         except Exception:
-            logging.getLogger("HWR").exception("")
+            self.log.exception("")
         return cmds
 
     def getAllCommands(self):

mxcubecore/HardwareObjects/SpecState.py

@@ -6,8 +6,6 @@ template:
   </procedure>
 """
 
-import logging
-
 from mxcubecore.BaseHardwareObjects import Procedure
 
 try:
@@ -28,7 +26,7 @@ class SpecState(Procedure):
             )
         except AttributeError:
             self.specConnection = None
-            logging.getLogger("HWR").error("SpecState: you must specify a spec version")
+            self.log.error("SpecState: you must specify a spec version")
         else:
             SpecClient.SpecEventsDispatcher.connect(
                 self.specConnection, "connected", self.specConnected
@@ -63,7 +61,7 @@ class SpecState(Procedure):
         try:
             cmd = self.get_command_object("SpecStateMacro")
         except KeyError:
-            logging.getLogger("HWR").exception("")
+            self.log.exception("")
         else:
             if cmd is not None:
                 cmd.disconnect_signal("commandReady", self.commandReady)
@@ -97,15 +95,15 @@ class SpecState(Procedure):
 
     def emitSpecState(self, entering):
         if entering == self.lastState:
-            # logging.getLogger("HWR").debug('SpecState: %s already in %s' % (wwself.specversion,entering))
+            # self.log.debug('SpecState: %s already in %s' % (wwself.specversion,entering))
             return
 
         if self.lastState != "Unknown" and self.lastState != entering:
-            # logging.getLogger("HWR").debug('SpecState: %s from %s to %s ' % (self.specversion,self.lastState,entering))
+            # self.log.debug('SpecState: %s from %s to %s ' % (self.specversion,self.lastState,entering))
             signal_name = "specState%s" % self.lastState
             self.emit(signal_name, (False, self.specversion))
         # else:
-        #    logging.getLogger("HWR").debug('SpecState: %s entering %s' % (self.specversion,entering))
+        #    self.log.debug('SpecState: %s entering %s' % (self.specversion,entering))
 
         self.lastState = entering
         signal_name = "specState%s" % entering

mxcubecore/HardwareObjects/StateMachine.py

@@ -17,7 +17,6 @@
 #  You should have received a copy of the GNU Lesser General Public License
 #  along with MXCuBE. If not, see <http://www.gnu.org/licenses/>.
 
-import logging
 import time
 from datetime import datetime
 
@@ -71,12 +70,12 @@ class StateMachine(HardwareObject):
 
         for transition in self.transition_list:
             if not self.get_state_by_name(transition["source"]):
-                logging.getLogger("HWR").error(
+                self.log.error(
                     "Transition %s " % str(transition)
                     + "has a none existing source state: %s" % transition["source"]
                 )
             if not self.get_state_by_name(transition["dest"]):
-                logging.getLogger("HWR").error(
+                self.log.error(
                     "Transition %s " % str(transition)
                     + "has a none existing destination state: %s" % transition["dest"]
                 )
@@ -90,19 +89,19 @@ class StateMachine(HardwareObject):
 
             for condition_name in transition["conditions_true"]:
                 if not self.get_condition_by_name(condition_name):
-                    logging.getLogger("HWR").error(
+                    self.log.error(
                         "Transition %s " % str(transition)
                         + "has a none existing condition: %s" % condition_name
                     )
             for condition_name in transition["conditions_false"]:
                 if not self.get_condition_by_name(condition_name):
-                    logging.getLogger("HWR").error(
+                    self.log.error(
                         "Transition %s " % str(transition)
                         + "has a none existing condition: %s" % condition_name
                     )
             for condition_name in transition["conditions_false_or"]:
                 if not self.get_condition_by_name(condition_name):
-                    logging.getLogger("HWR").error(
+                    self.log.error(
                         "Transition %s " % str(transition)
                         + "has a none existing condition: %s" % condition_name
                     )
@@ -112,7 +111,7 @@ class StateMachine(HardwareObject):
         self.bl_setup_hwobj = self.get_object_by_role("beamline_setup")
         for hwobj_name in dir(self.bl_setup_hwobj):
             if hwobj_name.endswith("hwobj"):
-                # logging.getLogger("HWR").debug(\
+                # self.log.debug(\
                 #     "StateMachine: Attaching hwobj: %s " % hwobj_name)
                 self.connect(
                     getattr(self.bl_setup_hwobj, hwobj_name),
@@ -136,7 +135,7 @@ class StateMachine(HardwareObject):
 
         condition = self.get_condition_by_name(condition_name)
         if condition:
-            # logging.getLogger("HWR").debug(\
+            # self.log.debug(\
             #  "StateMachine: condition '%s' changed to '%s'" \
             #   % (condition_name, value))
 
@@ -145,7 +144,7 @@ class StateMachine(HardwareObject):
                 self.emit("conditionChanged", self.condition_list)
                 self.update_fsm_state()
         else:
-            logging.getLogger("HWR").debug(
+            self.log.debug(
                 "StateMachine: condition '%s' not in the condition list"
                 % condition_name
             )
@@ -199,7 +198,7 @@ class StateMachine(HardwareObject):
             }
             self.history_state_list.append(history_state_item)
             self.previous_state = self.current_state
-            logging.getLogger("HWR").debug(
+            self.log.debug(
                 "StateMachine: current state " + "changed to : %s" % self.current_state
             )
             self.emit("stateChanged", self.history_state_list)

mxcubecore/HardwareObjects/TangoLimaMpegVideo.py

@@ -14,7 +14,6 @@ Example configuration:
 """
 
 import atexit
-import logging
 import os
 import signal
 import subprocess
@@ -76,7 +75,7 @@ class TangoLimaMpegVideo(TangoLimaVideo):
         return video_sizes
 
     def clean_up(self) -> None:
-        logging.getLogger("HWR").info("Shutting down video_stream...")
+        self.log.info("Shutting down video_stream...")
         os.kill(self._video_stream_process.pid, signal.SIGTERM)
 
     def start_video_stream_process(self) -> None:
@@ -117,7 +116,7 @@ class TangoLimaMpegVideo(TangoLimaVideo):
                 for p in ps:
                     p.kill()
             except psutil.NoSuchProcess:
-                logging.getLogger("HWR").exception("")
+                self.log.exception("")
 
             self._video_stream_process = None
 

mxcubecore/HardwareObjects/TangoLimaVideo.py

@@ -14,7 +14,6 @@ If video mode is not specified, BAYER_RG16 is used by default.
 """
 
 import io
-import logging
 import struct
 import time
 
@@ -78,7 +77,7 @@ class TangoLimaVideo(BaseHardwareObjects.HardwareObject):
             self.device.ping()
         except PyTango.DevFailed as traceback:
             last_error = traceback[-1]
-            logging.getLogger("HWR").error("%s: %s", str(self.name()), last_error.desc)
+            self.log.error("%s: %s", str(self.name()), last_error.desc)
 
             self.device = BaseHardwareObjects.Null()
         else:
@@ -88,7 +87,7 @@ class TangoLimaVideo(BaseHardwareObjects.HardwareObject):
                 self._sleep_time = float(self.get_property("interval")) / 1000.0
 
             if self.get_property("control_video", "True"):
-                logging.getLogger("HWR").info("MXCuBE controlling video")
+                self.log.info("MXCuBE controlling video")
 
                 if self.device.video_live:
                     self.device.video_live = False
@@ -98,7 +97,7 @@ class TangoLimaVideo(BaseHardwareObjects.HardwareObject):
 
                 self.device.video_live = True
             else:
-                logging.getLogger("HWR").info("MXCuBE NOT controlling video")
+                self.log.info("MXCuBE NOT controlling video")
 
         self.update_state(BaseHardwareObjects.HardwareObjectState.READY)
 

mxcubecore/HardwareObjects/TangoMachineInfo.py

@@ -29,8 +29,6 @@ Example xml_ configuration:
  </object>
 """
 
-import logging
-
 from mxcubecore.HardwareObjects.abstract.AbstractMachineInfo import AbstractMachineInfo
 
 __copyright__ = """ Copyright © by the MXCuBE collaboration """
@@ -82,7 +80,7 @@ class TangoMachineInfo(AbstractMachineInfo):
             try:
                 self._mach_info_dict.update({name: getattr(self, name).get_value()})
             except Exception as err:
-                logging.getLogger("HWR").exception(err)
+                self.log.exception(err)
 
         return self._mach_info_dict.copy()
 

mxcubecore/HardwareObjects/TangoMotor.py

@@ -20,8 +20,6 @@
 TangoMotor class defines motor in the Tango control system (used and tested in DESY/P11
 """
 
-import logging
-
 import gevent
 
 from mxcubecore.HardwareObjects.abstract.AbstractMotor import AbstractMotor
@@ -108,7 +106,7 @@ class TangoMotor(AbstractMotor):
                 if self.get_property("default_limits"):
                     self.update_limits(eval(self.get_property("default_limits")))
             except Exception:
-                logging.getLogger("HWR").exception("")
+                self.log.exception("")
 
         self.cmd_stop = self.get_command_object("stopAxis")
         if self.cmd_stop is None:

mxcubecore/HardwareObjects/UserTypeISPyBLims.py

@@ -90,14 +90,12 @@ class UserTypeISPyBLims(ISPyBAbstractLIMS):
 
         # Authentication
         if self.authServerType == "ldap":
-            logging.getLogger("HWR").debug(
-                "Starting LDAP authentication %s" % login_name
-            )
+            self.log.debug("Starting LDAP authentication %s" % login_name)
             self.login_ok = self.ldap_login(login_name, psd, ldap_connection)
             msg = loginID
-            logging.getLogger("HWR").debug("User %s logged in LDAP" % login_name)
+            self.log.debug("User %s logged in LDAP" % login_name)
         elif self.authServerType == "ispyb":
-            logging.getLogger("HWR").debug("ISPyB login")
+            self.log.debug("ISPyB login")
             self.login_ok, msg = self.ispyb_login(login_name, psd)
         else:
             raise Exception("Authentication server type is not defined")
@@ -105,7 +103,7 @@ class UserTypeISPyBLims(ISPyBAbstractLIMS):
         if not self.login_ok:
             msg = "%s." % msg.capitalize()
             # refuse Login
-            logging.getLogger("HWR").error("ISPyB login not ok")
+            self.log.error("ISPyB login not ok")
             raise Exception("Error lims authentication")
 
         # login succeed, get proposal and sessions
@@ -185,7 +183,7 @@ class UserTypeISPyBLims(ISPyBAbstractLIMS):
                                         session.endDate, "%Y-%m-%d %H:%M:%S"
                                     )
                                 except Exception:
-                                    logging.getLogger("HWR").exception("")
+                                    self.log.exception("")
                                 sessions.append(utf_encode(asdict(session)))
 
                     except WebFault as e:
@@ -281,7 +279,7 @@ class UserTypeISPyBLims(ISPyBAbstractLIMS):
                                 session.endDate, "%Y-%m-%d %H:%M:%S"
                             )
                         except Exception:
-                            logging.getLogger("HWR").exception("")
+                            self.log.exception("")
 
                         sessions.append(utf_encode(asdict(session)))
 
@@ -292,7 +290,7 @@ class UserTypeISPyBLims(ISPyBAbstractLIMS):
         except URLError:
             logging.getLogger("ispyb_client").warning(_CONNECTION_ERROR_MSG)
 
-            logging.getLogger("HWR").exception("")
+            self.log.exception("")
             return empty_dict
 
         logging.getLogger("ispyb_client").info(str(sessions))

mxcubecore/HardwareObjects/XMLRPCServer.py

@@ -80,7 +80,7 @@ class XMLRPCServer(HardwareObject):
         try:
             self.open()
         except Exception:
-            logging.getLogger("HWR").exception("Can't start XML-RPC server")
+            self.log.exception("Can't start XML-RPC server")
 
     def close(self):
         try:
@@ -88,7 +88,7 @@ class XMLRPCServer(HardwareObject):
             self._server.server_close()
             del self._server
         except AttributeError:
-            logging.getLogger("HWR").exception("")
+            self.log.exception("")
 
     def open(self):
         # The value of the member self.port is set in the xml configuration
@@ -110,7 +110,7 @@ class XMLRPCServer(HardwareObject):
             )
 
         msg = "XML-RPC server listening on: %s:%s" % (self.host, self.port)
-        logging.getLogger("HWR").info(msg)
+        self.log.info(msg)
 
         self.connect(
             HWR.beamline.gphl_workflow,
@@ -187,7 +187,7 @@ class XMLRPCServer(HardwareObject):
         try:
             cryoshutter_hwobj.getCommandObject("anneal")(time)
         except Exception as ex:
-            logging.getLogger("HWR").exception(str(ex))
+            self.log.exception(str(ex))
             raise
         return True
 
@@ -216,7 +216,7 @@ class XMLRPCServer(HardwareObject):
             self.emit("add_to_queue", (task, None, set_on))
 
         except Exception as ex:
-            logging.getLogger("HWR").exception(str(ex))
+            self.log.exception(str(ex))
             raise
         return True
 
@@ -230,7 +230,7 @@ class XMLRPCServer(HardwareObject):
         try:
             self.emit("start_queue")
         except Exception as ex:
-            logging.getLogger("HWR").exception(str(ex))
+            self.log.exception(str(ex))
             raise
         return True
 
@@ -279,7 +279,7 @@ class XMLRPCServer(HardwareObject):
         try:
             node_id = HWR.beamline.queue_model.add_child_at_id(parent_id, child)
         except Exception as ex:
-            logging.getLogger("HWR").exception(str(ex))
+            self.log.exception(str(ex))
             raise
         return node_id
 
@@ -291,7 +291,7 @@ class XMLRPCServer(HardwareObject):
         try:
             node = HWR.beamline.queue_model.get_node(node_id)
         except Exception as ex:
-            logging.getLogger("HWR").exception(str(ex))
+            self.log.exception(str(ex))
             raise
         return node
 
@@ -312,7 +312,7 @@ class XMLRPCServer(HardwareObject):
                 )
 
         except Exception as ex:
-            logging.getLogger("HWR").exception(str(ex))
+            self.log.exception(str(ex))
             raise
         return True
 
@@ -329,7 +329,7 @@ class XMLRPCServer(HardwareObject):
             model = HWR.beamline.queue_model.get_node(node_id)
             model.lims_id = lims_id
         except Exception as ex:
-            logging.getLogger("HWR").exception(str(ex))
+            self.log.exception(str(ex))
             raise
         else:
             return True
@@ -342,7 +342,7 @@ class XMLRPCServer(HardwareObject):
         try:
             return HWR.beamline.queue_manager.is_executing(node_id)
         except Exception as ex:
-            logging.getLogger("HWR").exception(str(ex))
+            self.log.exception(str(ex))
             raise
 
     def queue_status(self):
@@ -415,7 +415,7 @@ class XMLRPCServer(HardwareObject):
                 ho = self._getattr_from_path(HWR, path)
                 value = ho.get_value()
             except:
-                logging.getLogger("HWR").exception("Could no get %s " % str(path))
+                self.log.exception("Could no get %s " % str(path))
 
         return value
 
@@ -443,13 +443,11 @@ class XMLRPCServer(HardwareObject):
 
     def save_twelve_snapshots_script(self, path):
         path = path[14:]  # NBNB: Temporary fix, to be addressed in calling code
-        logging.getLogger("HWR").info(
-            "Taking 6 snapshots to be saved in  %s " % str(path)
-        )
+        self.log.info("Taking 6 snapshots to be saved in  %s " % str(path))
         HWR.beamline.diffractometer.run_script("Take6Snapshots, " + path)
 
     def save_multiple_snapshots(self, path_list, show_scale=False):
-        logging.getLogger("HWR").info("Taking snapshot %s " % str(path_list))
+        self.log.info("Taking snapshot %s " % str(path_list))
 
         try:
             for angle, path in path_list:
@@ -459,11 +457,11 @@ class XMLRPCServer(HardwareObject):
                 HWR.beamline.diffractometer.wait_ready()
                 self.save_snapshot(path, show_scale, handle_light=False)
         except Exception as ex:
-            logging.getLogger("HWR").exception("Could not take snapshot %s " % str(ex))
+            self.log.exception("Could not take snapshot %s " % str(ex))
 
     def save_snapshot(self, imgpath, showScale=False, handle_light=True):
         res = True
-        logging.getLogger("HWR").info("Taking snapshot %s " % str(imgpath))
+        self.log.info("Taking snapshot %s " % str(imgpath))
 
         try:
             if showScale:
@@ -471,7 +469,7 @@ class XMLRPCServer(HardwareObject):
             else:
                 HWR.beamline.sample_view.save_snapshot(imgpath, overlay=False, bw=False)
         except Exception as ex:
-            logging.getLogger("HWR").exception("Could not take snapshot %s " % str(ex))
+            self.log.exception("Could not take snapshot %s " % str(ex))
             res = False
         finally:
             pass
@@ -482,7 +480,7 @@ class XMLRPCServer(HardwareObject):
         """
         Saves the current position as a centered position.
         """
-        logging.getLogger("HWR").debug("Saving position via XMLRPC")
+        self.log.debug("Saving position via XMLRPC")
         HWR.beamline.diffractometer.save_current_position()
         return True
 
@@ -629,7 +627,7 @@ class XMLRPCServer(HardwareObject):
         """
         Sets the level of the back light
         """
-        logging.getLogger("HWR").info("Setting backlight level to %s" % level)
+        self.log.info("Setting backlight level to %s" % level)
         HWR.beamline.diffractometer.setBackLightLevel(level)
 
     def get_back_light_level(self):

mxcubecore/HardwareObjects/abstract/AbstractAperture.py

@@ -22,7 +22,6 @@
 
 from __future__ import annotations
 
-import logging
 from warnings import warn
 
 from mxcubecore.BaseHardwareObjects import HardwareObject
@@ -57,12 +56,12 @@ class AbstractAperture(HardwareObject):
         try:
             self._diameter_size_list = eval(self.get_property("diameter_size_list"))
         except Exception:
-            logging.getLogger("HWR").error("Aperture: no diameter size list defined")
+            self.log.error("Aperture: no diameter size list defined")
 
         try:
             self._position_list = eval(self.get_property("position_list"))
         except Exception:
-            logging.getLogger("HWR").error("Aperture: no position list defined")
+            self.log.error("Aperture: no position list defined")
 
     def get_diameter_size_list(self) -> list[float]:
         """Get list of diameter sizes.
@@ -102,7 +101,7 @@ class AbstractAperture(HardwareObject):
                 self._diameter_size_list[self._current_diameter_index] / 1000.0,
             )
         else:
-            logging.getLogger("HWR").warning(
+            self.log.warning(
                 "Aperture: Diameter index %d is not valid" % diameter_index
             )
 
@@ -123,9 +122,7 @@ class AbstractAperture(HardwareObject):
         if diameter_size in self._diameter_size_list:
             self.set_diameter_index(self._diameter_size_list.index(diameter_size))
         else:
-            logging.getLogger("HWR").warning(
-                "Aperture: Selected diameter is not in the diameter list"
-            )
+            self.log.warning("Aperture: Selected diameter is not in the diameter list")
 
     def get_position_name(self) -> str:
         """Get current position name.
@@ -152,7 +149,7 @@ class AbstractAperture(HardwareObject):
             self._current_position_name = position_name
             self.emit("valueChanged", self._current_position_name)
         else:
-            logging.getLogger("HWR").warning(
+            self.log.warning(
                 "Aperture: Position %s is not in the position list" % position_name
             )
 
@@ -166,9 +163,7 @@ class AbstractAperture(HardwareObject):
             self._current_position_name = self._position_list[position_index]
             self.emit("valueChanged", self._current_position_name)
         else:
-            logging.getLogger("HWR").warning(
-                "Aperture: Selected position is not in the position list"
-            )
+            self.log.warning("Aperture: Selected position is not in the position list")
 
     def set_in(self):
         """Set aperture in the beam."""