Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Migration of unmigrated content due to installation of a new plugin

ImgMan User

...

Guide

  1. #Overview
  2. #Starting ImgMan from Matlab Desktop
  3. #Viewing Live Images
  4. #Collecting Images
  5. #Browsing Image Datasets
  6. #Analyzing Single Image
  7. Online Help #Help

Overview

ImgMan (short for Image Management) is a suite of Matlab applications for collecting and analyzing beam images from laser cameras and profile monitors at LCLS. ImgMan consists of the Image Acquisition, Image Browser, and Image Analysis windowsapplications.

Starting ImgMan from Matlab Desktop

To start ImgMan from Matlab, type

Code Block

imgAcq_main

in the Command Window.

Viewing Live Images


In the Image Acquistion Acquisition window, select a camera and check the "Show Live Image" box. After a short delay, the window expands, and you can see the live image as well as the #Image Processing Panel, which can be found on all three main windows of ImgMan.



Image Processing Panel


Image Processing Panel contains widgets for setting image processing parameters, e.g. slicing, background subtraction, filters, cropping, color mapps, annotations (centroids), unit scales, the image processing algorithm. UsuallyIn general, ImgMan propagates changes of paramaters handles changes to these parameters immediately. However, if there is an "Apply" button is present, you must press it before some costly image processing parameters are applied (or is started (alternatively, you can check the "Instant" Apply box).

Collecting Images


In the Image Acquisition window, select a camera, specify the desired number of background and beam images, and press the "Measure" button. If you don't want to save images locally, uncheck the "Save ImagesRetrieve images" box. You can follow monitor the progress of the measurment measurement either in the Image Acquisition window or in cmlog. Each measurement results in one dataset of images. When the measurement is finished, the number on the dataset label increases by 1.

Saving and Loading Datasets


Press "Save" button to open a "Save As..." dialog and save your image datasets. Press "Load" button to open a "Load File..." dialog and load image datasets.

Browsing Image Datasets


In the Image Acquisition window, press the "Browse..." button to open the image browser #Image Browser. You can select a dataset, browse images, and specify image processing parameters through on an #Image Processing Panel.


Analyzing Single Image


In the Image Browser window, press the "Analyze..." button to open an Image #Image Analysis window application for the corresponding image. Image Analysis also contains an #Image Processing Panel.



Online Help For ImgMan

Image Acquisition

...

Column

ALGORITHM popupmenu

  • Select an image processing algorithm.

BACKGROUND IMAGES edit

  • Specify the number of background images to be acquired.

BEAM IMAGES edit

  • Specify the number of beam images to be acquired.

BEAM SIZE UNITS popupmenu

  • Select image axes units.

BROWSE... button

  • Open the Image Browser.

CAMERA popupmenu

  • Select a camera from the list.

CANCEL button

  • Cancel the image acquisition.

CAPTURE... button

  • Display the current live image (screenshot) in another window.

COLOR MAP edit

  • Specify the number of colors.

COLOR MAP popupemu

  • Specify the name of the colormap.

COLOR MAP slider

  • Select the number of colors.

CROP checkboxes

  • Select which cropping to apply to the image.

DATASET edit

  • Specify the name of the next image dataset.

FILTERS checkboxes

  • Select desired image filters.

HELP button

  • Display help.

LOAD... button

  • Load image datasets from hard drive.

MEASURE button

  • Start image acquisition. Might be disabled.

NUMBER SLICES edit

  • Specify the number of slices.

SAVE... button

  • Save image datasets to hard drive.

SAVE.... CURRENT CENTROID button

  • Open a dialog to save the current centroid.

SAVE IMAGES checkbox

  • Enable/disable the local saving of images.

SHOW CENTROIDS checkboxes

  • Select to display the desired centroids.

SLICE INDEX edit

  • Specify the index of the slice.

SLICE PLANE checkboxes

  • Select the plane for slicing.

SUBTRACT BACKGROUND checkboxes

  • Select which background to subtract from the image.

UNDOCK button

  • Display live image in another (resizable) figure.
Image Analysis

...

ImgMan (short for Image Management) is a suite of Matlab applications for collecting and analyzing beam images from laser cameras and profile monitors at LCLS. ImgMan consists of the Image Acquisition, Image Browser, and Image Analysis applications.
For more details, check the User's Guide.

Image Acquisition

Image Acquisition is used to acquire background and beam images from cameras in the LCLS beam line. Some cameras are associated with a screen, which you must put IN first. After specifying the number of the desired background and beam images, press the "Measure" button to start the acquisition. You can monitor the status of your measurement on the main panel.
When the acquisition is complete, you can browse through your image datasets.


Image Added

You also have the ability to process live images and extract beam data from them.


Image Added

Image Analysis

Image Analysis is used to analyze single images from your dataset. Images are processed, and beam data is extracted according to the parameters that you specify. You can trim the width or the height of the cropped area- depending on which slice plane you have selected.


Image Added

Image Browser

Image Browser is used to browse through image datasets. Images are processed according to the parameters that you specify. You can set a master crop area for all images in a dataset.


Image Added

...

Column

ADJUST CROP AREA... button
Open a window to adjust either the width (if slice plane is X) or the height (if slice plane is Y) of the crop area of the image.

ALGORITHM popupmenu

  • Select an image processing algorithm.

APPLY button

  • Apply changes of the image processing parameters.

BEAM SIZE UNITS popupmenu

  • Select image axes units.

COLOR MAP edit

  • Specify the number of colors.

COLOR MAP popupemu

  • Specify the name of the colormap.

COLOR MAP slider

  • Select the number of colors.

CROP checkboxes

  • Select which cropping to apply to the image.

FILTERS checkboxes

  • Select desired image filters.

INSTANT APPLY checkbox

  • Enable/disable the instant application of the changes of the image processing parameters.

NEXT IMAGE button

  • Display next image in the dataset

PREVIOUS IMAGE button

  • Display previous image in the dataset.

SHOW CENTROIDS checkboxes

  • Select to display the desired centroids.

SLICE INDEX edit

  • Specify the index of the slice.

SLICE PLANE checkboxes

  • Select the plane for slicing.

SUBTRACT BACKGROUND checkboxes

  • Select which background to subtract from the image.
Image Browser

Image Removed