CAS-GUI 1.0.5

Python package for creating imaging system GUIs.

CAS and CAS GUI

CAS GUI is a framework for rapidly building imaging system GUIs in Python. Originally designed for use in an optical imaging research in Mike Hughes' lab in the Applied Optics Group, University of Kent, it can be used to help develop GUIs for a wide range of applications which involve capturing and processing images from cameras or camera-like systems.

GUIs are built using PyQt5. Images are displayed using an instance of ImageDisplayQT, a widget for displaying scientific images. To create your own GUI, you simple subclass the base class of CAS GUI and define your own image processing function. There are helper functions for creating additional menus or image displays. You can customise as much as you want by over-riding other methods.

Documentation and Examples

Full documentation is on readthedocs.

Simple examples of GUIs can be found in the examples folder

Rough Guide

The CAS-GUI class, in src/cas_gui/base.py, is the base class for camera GUIs. This can be run as is, and will provide a simple camera image viewer with the possibility to adjust exposure, frame rate and gain. Select the input camera from the drop-down menu in the 'Source' menu and click 'Live Imaging' to begin. It will obviously only work for cameras you have set up on your system - try the Webcam (if you have one) or Simulated Camera first. The Simulated Camera can load a sequence of images from a tif stack in order to simulate camera acquisition. Alternatively, select the 'File' source to load in a saved image or tif stack.

Classes for handling camera communications are in the src/cas_gui/cameras folder. For a specific camera, a new class must be created that inherits from GenericCamera. Override the functions from GenericCamera to implement the relevant functionality. See the other camera python files in the folder for examples.

To create a GUI for a specific purpose, create a new class that inherits from CAS_GUI in base.py. Three simple example are provided in the examples folder - gui_example, gui_example_multi_frame and gui_example_multi_core.

Supported Cameras

Camera classes exist for the following camera families. Functionality is implemented only as needed, so not every function is supported for every camera:

• Webcam (WebCamera.py) - Returns monochrome images from webcameras. Partial support for exposure and gain (how well these work depend on the specific camera). Requires OpenCV.
• Webcam Colour (WebCameraColour.py) - As Webcam, but returns colour images. Requires OpenCV.
• Thorlabs DCX Series Camaras (DCXCameraInterface.py) - Supports setting and getting frame rate, exposure and gain. Requires instrumental package.
• Thorlabs Kiralux Camera (KiraluxCamera.py) - Supports setting and getting frame rate, exposure and gain. Triggering not supported. Requires Thorlabs Scientific Cameras SDK.
• FLIR FLea Camera (FleaCameraInterface.py) - Tested with Flea Camera series, may work with other cameras that use the Spinnaker API. Supports setting and getting frame rate, exposure and gain and triggering. Requires Spinnaker SDK.

In addition, there are two other camera classes:

• File Interface (FileInterface.py) - Provides an interface to an image stored as a file which is compatible with the camera interfaces, simplifying GUIs which need to work with both videos streams from cameras and saved images.
• Camera Simulator (SimulatedCamera.py) - Simulates a camera using a saved tif stack of images. Images are served at the requested frame rate. Requires PIL.

Examples

Examples of basic use of CAS are in the examples folder:

• GUI Example - Demonstrates how to sub-class CAS-GUI to produce a simple GUI which applies a smoothing filter to the live video display.
• GUI Multi Core Example - The same as GUI Example, but uses multiprocessing.
• GUI Example Multi Frame - Demonstrates how to sub-class CAS-GUI to produce a simple GUI which averages multiple frames from the live video display.
• Simulated Camera Example - Demonstrates how to capture images from a simulated camera which streams images from a tif stack file.
• Webcamera Example - Demonstrates how to capture monochrome images from a web camera.
• Flea Camera Example - Demonstrates how to capture images from a FLIR camera, including setting and getting various parameters and triggering.

Requirements

CAS requirements depends on the specific camera used (see list above).

CAS-GUI requires:

• PIL (Python Image Library)
• OpenCV
• PyQt5
• Numpy
• Matplotlib