Package gda.px.camera

Class DummyCamera

java.lang.Object
gda.factory.ConfigurableBase
gda.factory.FindableConfigurableBase
gda.device.DeviceBase
gda.px.camera.DummyCamera
All Implemented Interfaces:
Device, Configurable, Findable, gda.observable.IObservable, Camera
@ServiceInterface(Camera.class) public class DummyCamera extends DeviceBase implements Camera
Dummy class for the gda.px.camera.Camera interface

  • Constructor Details

    • DummyCamera

      public DummyCamera()

  • Method Details

    • checkDetectorDistance

      public boolean checkDetectorDistance(double distance) throws DeviceException
      Description copied from interface: Camera
      Returns whether or not the requested detector distance is within the available range.
      Specified by:
      checkDetectorDistance in interface Camera
      Parameters:
      distance -
      Returns:
      true if it is, false if not
      Throws:
      DeviceException

    • getDetectorDistance

      public double getDetectorDistance() throws DeviceException
      Description copied from interface: Camera
      Get the current camera crystal to detector distance.
      Specified by:
      getDetectorDistance in interface Camera
      Returns:
      Current camera crystal to detector distance.
      Throws:
      DeviceException

    • getDetectorMotionTolerance

      public double getDetectorMotionTolerance() throws DeviceException
      Specified by:
      getDetectorMotionTolerance in interface Camera
      Throws:
      DeviceException

    • getMaxDistance

      public double getMaxDistance() throws DeviceException
      Description copied from interface: Camera
      Get the maximum allowed camera crystal to detector distance.
      Specified by:
      getMaxDistance in interface Camera
      Returns:
      Maximum camera crystal to detector distance.
      Throws:
      DeviceException

    • getMinDistance

      public double getMinDistance() throws DeviceException
      Description copied from interface: Camera
      Get the minimum allowed camera crystal to detector distance.
      Specified by:
      getMinDistance in interface Camera
      Returns:
      Minimum camera crystal to detector distance.
      Throws:
      DeviceException

    • isShutterOpen

      public boolean isShutterOpen() throws DeviceException
      Description copied from interface: Camera
      Get the current shutter state of the camera as a string.
      Specified by:
      isShutterOpen in interface Camera
      Returns:
      Current shutter state.
      Throws:
      DeviceException

    • makeDetectorSafe

      public void makeDetectorSafe(boolean wait) throws DeviceException
      Description copied from interface: Camera
      Returns the detector to a safe distance from the crystal position. At the end of data collection this may well be done to allow easy access to the crystal mounting area, for manual or automatic crystal mounting.
      Specified by:
      makeDetectorSafe in interface Camera
      Parameters:
      wait - Whether to wait until the move is complete, true to wait.
      Throws:
      DeviceException

    • waitWhileExposing

      public void waitWhileExposing() throws DeviceException
      Description copied from interface: Camera
      Wait until the camera is no longer performing an exposure.
      Specified by:
      waitWhileExposing in interface Camera
      Throws:
      DeviceException

    • waitWhileMoving

      public void waitWhileMoving() throws DeviceException
      Description copied from interface: Camera
      Wait until all elements of the camera are no longer moving.
      Specified by:
      waitWhileMoving in interface Camera
      Throws:
      DeviceException

    • expose

      public void expose() throws DeviceException
      Description copied from interface: Camera
      Perform a protein crystallography exposure according to the set parameters.

      This should be called after prepareForExposure. Then setDefaultSpeeds should be called afterwards.

      Specified by:
      expose in interface Camera
      Throws:
      DeviceException

    • moveDetectorTo

      public void moveDetectorTo(double distance) throws DeviceException
      Description copied from interface: Camera
      Moves the detector to achieve a required crystal to detector distance.
      Specified by:
      moveDetectorTo in interface Camera
      Parameters:
      distance - Required crystal to detector distance.
      Throws:
      DeviceException

    • setImageAngularSize

      public void setImageAngularSize(double angle) throws DeviceException
      Description copied from interface: Camera
      Set the omega rotation during an exposure (in degrees).
      Specified by:
      setImageAngularSize in interface Camera
      Parameters:
      angle - Omega rotation during an exposure (in degrees).
      Throws:
      DeviceException

    • setImageStartAngle

      public void setImageStartAngle(double position) throws DeviceException
      Description copied from interface: Camera
      Set the starting angle of the exposure.
      Specified by:
      setImageStartAngle in interface Camera
      Parameters:
      position - angle of the exposure (in degrees).
      Throws:
      DeviceException

    • setImageTime

      public void setImageTime(double time) throws DeviceException
      Description copied from interface: Camera
      Set the total shutter open time during an exposure (in seconds).
      Specified by:
      setImageTime in interface Camera
      Parameters:
      time - Shutter open time during an exposure (in seconds).
      Throws:
      DeviceException

    • setNumberPasses

      public void setNumberPasses(int numPasses) throws DeviceException
      Description copied from interface: Camera
      Set the number of repeated passes across the oscillation range during an exposure. This is assumed to be 1 by default. If this number is greater than 1 then the exposure time for each pass is adjusted so that the total exposure time is that set by setImageTime.
      Specified by:
      setNumberPasses in interface Camera
      Parameters:
      numPasses -
      Throws:
      DeviceException

    • open

      public void open() throws DeviceException
      Description copied from interface: Camera
      Open the shutter.
      Specified by:
      open in interface Camera
      Throws:
      DeviceException

    • getOmegaPosition

      public double getOmegaPosition() throws DeviceException
      Description copied from interface: Camera
      Returns the rotation axis's omega position.
      Specified by:
      getOmegaPosition in interface Camera
      Returns:
      Omega
      Throws:
      DeviceException

    • isSpeedAchievable

      public boolean isSpeedAchievable(double time, double oscillation) throws DeviceException
      Description copied from interface: Camera
      Based on passed parameters checks whether requested speed is achivable.
      Specified by:
      isSpeedAchievable in interface Camera
      Parameters:
      time - The exposure duration in seconds.
      oscillation - The rotation of the crystal during an exposure in degrees.
      Returns:
      true for achievable.
      Throws:
      DeviceException

    • moveOmegaBy

      public void moveOmegaBy(double distance) throws DeviceException
      Description copied from interface: Camera
      Move the rotation axis's omega axis by an increment.
      Specified by:
      moveOmegaBy in interface Camera
      Parameters:
      distance - The required increment in degrees.
      Throws:
      DeviceException

    • moveOmegaTo

      public void moveOmegaTo(double position) throws DeviceException
      Description copied from interface: Camera
      Move the rotation axis's omega axis to a position.
      Specified by:
      moveOmegaTo in interface Camera
      Parameters:
      position - The required position in degrees.
      Throws:
      DeviceException

    • stopOmega

      public void stopOmega() throws DeviceException
      Description copied from interface: Camera
      Move any motion of the rotation axis's omega axis.
      Specified by:
      stopOmega in interface Camera
      Throws:
      DeviceException

    • close

      public void close() throws DeviceException
      Description copied from interface: Device
      Close and unconfigure the device.
      Specified by:
      close in interface Device
      Overrides:
      close in class DeviceBase
      Throws:
      DeviceException

    • prepareForExposure

      public void prepareForExposure() throws DeviceException
      Description copied from interface: Camera
      This must be called after setting the exposure parameters (by calling setImageAngle, setImageTime and setImageStart) and before expose. This move the omega axis to the correct position for its run-up before opening the shutter during the exposure.
      Specified by:
      prepareForExposure in interface Camera
      Throws:
      DeviceException

    • setDefaultSpeeds

      public void setDefaultSpeeds() throws DeviceException
      Description copied from interface: Camera
      This should be called after an exposure to reset the omega motor parameters back to normal. This can also be called during a experiment emergency stop to ensure the beamline is returned to a known status.
      Specified by:
      setDefaultSpeeds in interface Camera
      Throws:
      DeviceException

    • setAcceleration

      public void setAcceleration(double acceleration) throws DeviceException
      Description copied from interface: Camera
      Set the acceleration used for ramp up and ramp down in degrees/sec/sec
      Specified by:
      setAcceleration in interface Camera
      Parameters:
      acceleration -
      Throws:
      DeviceException

    • getAcceleration

      public double getAcceleration() throws DeviceException
      Description copied from interface: Camera
      Acceleration of rotation axis in degrees/sec/sec used for ramp up and ramp down.
      Specified by:
      getAcceleration in interface Camera
      Returns:
      acceleration in degrees/sec/sec
      Throws:
      DeviceException