Home * Installation * Using lsgui * Under the hood * Applications * Discussion * Contact Us
lsgui is configured to work with Windows Systems. All testing for this project has been conducted on a PC running Windows 10 or MacBook Pro with Parallels and Windows 10 and MATLAB R2019b and R2020a, with Imaging Acquisition Toolbox. Regardless of which camera you use, using the Lumascope's LED controller requires initialization in steps 1 and 2 under Default Lumascope Camera.
Installing Lumaview and hardware initialization
Click here to be directed to the download for Lumaview from Etaluma. We recommend installing Lumaview in the default location.
Before you can run lsgui, be sure to open Lumaview first to initialize the Lumascope camera and/or LED controller. Then quit Lumaview and launch lsgui. Repeat any time the Lumascope is unplugged.
Cameras
If you're running a compiled version of lsgui.exe, then make sure the version you're running was compiled with the correct camera selected (hopefully the name of the folder makes that clear).
If you're running lsgui from MATLAB's command line, select the camera you're using by editing around line 25 of lsgui.m, uncommenting whichever camera you have ("%" is MATLAB's comment symbol):
camera = @imageSource;
% camera = @ls720cam;
% camera = @basler;
Default Lumascope Camera & LED controller
- For users with the default LS620 or LS720 camera, before launching lsgui open Lumaview to complete the initialization of the Lumascope, and ensure the hardware is working. Then quit Lumaview and launch lsgui.
- MATLAB expects to find the file C:\Program Files (x86)\Etaluma\Lumaview720\LumaUSB.dll which is created by the Lumaview installer there by default. If Lumaview is not installed in that default location, you'll have to edit the init routine in ls620cam.m to (exactly) specify the full path of LumaUSB.dll.
- The image size parameter initialized in Lumaview -> Configuration -> Image Size has to exactly match the imageSize = 1200; line in ls620cam.m.
The Imaging Source DMM37UX178-ML Camera
This camera uses Sony's Starvis sensor offering extremely low noise and high sensitivity. Before using the Imaging Source DMM37UX178-ML camera with lsgui, an additional software package needs to be installed. The needed software is a plugin for MATLAB and can be found here.
To complete installation of this package,
- Open MATLAB
- Launch the image acquisition toolbox (imaqtool)
- Click tools, click register third party adapter
- Find the folder called "TIS IMAQ for MATLAB R2013b"
- Click the folder and click the file named "TISImaq_R2013_64.dll" (for 64-bit systems only) or "TISImaq_R2013_32.dll" (for 32-bit systems only)
- Click open
- Ensure that in the bottom left corner, it now says that installed adapter is "TISImaq_R2013b"
- Click Tools, Click "Refresh Image Acquisition Hardware (imaqreset)"
- Ensure that the camera is connected to the computer and appears in the top left box of the image acquisition tool window.
- You are now ready to use The Imaging Source Cameras with MATLAB and lsgui.exe
For users with The Imaging Source camera and TISImaq_R2013b adapter installed, Open MATLAB, launch the image acquisition toolbox (imaqtool), and ensure that the camera appears as an object. If the camera does not appear, do an image acquisition hardware reset (imaqreset) and see if the camera object refreshes and appears in the window.
This particular camera has a global shutter at up to 203FPS. It sacrifices noise and resolution for speed. Before using any Basler camera, ensure that you install the Basler Pylon Viewer found here. We have found this interface works the same with other USB Basler cameras. After you have installed pylon and verified the camera is working, quit Pylon and launch MATLAB. Once in MATLAB, click environment ->add-ons -> get add-ons, search "gentl" in the search bar, click on and install the adapter named "Image Acquisition Toolbox Support Package for GentlCam Interface".
NOTE: To properly recognize gentl cameras, the winvideo adapter must be Uninstalled otherwise all gentl cameras will appear as winvideo objects and be unavailable.
To verify installation of the package,
From MATLAB's command line, type imaqhwinfo. This will give you a list of installed adapters for camera interfaces through MATLAB. Ensure that gentl is listed. If it does not appear,
- Launch the image acquisition toolbox (imaqtool)
- Look in the bottom left corner for installed adapters.
- If still not visible, navigate back to the add-ons page as directed above and verify that the adapter says "installed".
- Click Tools, and click "Refresh Image Acquisition Hardware (imaqreset)"
- Ensure that the camera object appears in the top left window.
Installing lsgui.exe from scratch
In order to install a standalone version of lsgui, click this link to download the installer. If this is your first time installing lsgui, be sure to check the box during the installation process that says to download MATLAB Runtime. The MATLAB Runtime file is needed for lsgui to be able run in a standalone capacity outside of MATLAB. If you have already downloaded MATLAB Runtime, you do not need to click this box and can either proceed with the download from the link above or if you are trying to download the newest version of lsgui, click the link to the installer above and do not install MATLAB Runtime.
Installing and updating functions for use within MATLAB
In order to download the file with all functions for use in a MATLAB environment, click here. These functions can be placed in a folder and called from the MATLAB command line. Follow MATLAB directions to add this folder to MATLAB's path.
Using lsgui
Comments (1)
brian rasnow said
at 7:56 am on May 8, 2020
1) global sim; sim = false; % before launch or place in startup.m
(I think the other formerly global variables became persistent)?
2) Are there br_toolbox or other functions we need to provide for the non-exe version?
You don't have permission to comment on this page.