ZEISS Microscopy Knowledge Base
Help
ZEISS Microscopy Knowledge Base

Guided Acquisition

This module enables you to create an automated workflow to acquire overview images, detect relevant objects with an image analysis and re-image these positions, using another experiment. Additionally, you can set up the Guided Acquisition to automatically repeat the detailed scan or the entire workflow to observe changes over time, such as the growth of organoids or embryos.

Guided Acquisition Workflow:

  1. Scan or inspect a large area (or over a long period of time).
  2. Perform an analysis to detect interesting objects.
  3. Acquire detailed images for every detected object.

A possible application is to detect rare events, for example to find transfected cells. For example, the sample contains many cells that are stained with a blue dye, but only a few are additionally expressing GFP. Guided Acquisition allows you to find these cells and run another, for example high-magnification, experiment on these positions.

After performing a (low-magnification) overview scan, the image analysis detects all cells and determines which of them are expressing GFP, i.e. show a certain intensity in the GFP channel. Then the microscope revisits all GFP-expressing cells and performs a second acquisition there, for example with higher magnification, a z-stack, etc. The analysis results are automatically saved to a folder.

Three-panel schematic: Overview Scan; Automated Image Analysis; Detail Scan. Stage axes, circles, red arrows, targets.

Preliminary Work to Guided Acquisition

For a successful Guided Acquisition experiment, you need to prepare an overview and a detailed experiment as well as an image analysis setting. If you want to process your overview image before it is analyzed, you also need a suitable setting for each processing step or function you want to execute.

Overview scan

You have defined the experiment for the overview scan. Typically, the overview scan is using a lower magnification in combination with a tile experiment.

Processing setting(s)

You have defined a suitable setting for each processing step or function you want to execute. For more information, see General Settings.
Note that if you want to use Shading Correction with a reference image, you have to define your setting in Batch mode!

Image analysis setting

You have defined a suitable image analysis setting, see Creating a New Image Analysis Setting.

Detailed scan

You can perform for example the following experiments:

  • simple Z-stacks with a high-NA objective lens
  • Multi-Channel Z-stacks using an optical sectioning method like SD, Apotome or Airyscan
  • Tile experiments
    Note: If you have activated Auto-Distribute for New Tile Regions for support point distribution in the Tiles tool, this is saved in the experiment and used for Guided Acquisition as well.
  • Time Series
    Note that for detailed experiments that are defined as a time series, a time series for each detected object is performed before moving to the next detected object. In order to create a time series which acquires the first time point for all detected objects before starting the acquisition for the second time point, use the Repeat Detailed Scan option.

Parcentricity

If you use different detectors for the overview and the detailed scan, it might be necessary to correct for the shift between both detectors (to ensure parcentricity). For this you have to take an image at the exact same position with both cameras and then determine the offset between the two (to ensure parcentricity). The reference to calculate this offset is the image taken with the camera for the overview experiment. You can then enter the values for the shift in X and Y in the guided acquisition setup.

Focus strategies

You have several options, to perform a focus strategy.

Detailed scan and overview scan can be defined with their own focus strategy using Focus Surface and/or Software Autofocus.

During the Guided Acquisition experiment, you can define additional focusing steps. They are independent from the focus strategy defined on the Acquisition tab, see Focus Strategy Tool.

For more information on Guided Acquisition, see Performing a Guided Acquisition.

Performing a Guided Acquisition

Objective Range

When positions are defined near the border of the stage, areas which are found in the overview scan might not be reached with the higher magnification objective of the detailed scan.

  1. Define the overview scan only in regions which can be reached with the objective used in the detailed scan.

Auto Immersion

If you set up your Guided Acquisition experiment using an immersion objective and user input would be necessary between overview and detailed experiments, a dialog is displayed directly after clicking Start. With this dialog you can control if the immersion is created when changing the objective for the scan. The experiment runs uninterrupted afterwards.

  1. You have calibrated the XY stage.
  2. You have defined suitable experiments for overview and detailed scans, a suitable setting for each processing step or function you want to execute, and a suitable image analysis setting using the Image Analysis Wizard. For more information, see Preliminary Work to Guided Acquisition.
  1. On the Applications tab, open the Guided Acquisition tool.
  2. The parameters are displayed.
  3. Create a setting to save your experiment setup, see Using Guided Acquisition Settings.
  4. You have created a setting for your entire workflow.
  5. In the Overview Scan section, select the experiment you want to use for creating the overview image, the objective and (if available) the after-magnification lens to be used. Note that per default, objective and after-magnification are not stored as part of an experiment. If you have selected an experiment with multiple scenes or wells, you also have to select in which order the individual scenes should be acquired and processed.
  6. Your overview scan is set up.
  7. If your system is equipped with Definite Focus, the Find Surface before Overview Experiment and SW Autofocus before Overview Experiment checkboxes are visible. Activate the checkbox to perform an additional focusing step before the overview experiment.
  8. The focus action is defined.
  9. If you want to process your overview image before it is analyzed, click Add Processing Method.
  10. A processing section is added.
  11. Select a Method for processing and a corresponding Setting.
  12. The respective processing is set up.
  13. In the Image Analysis section, select a suitable setting to analyze the overview scan and detect the objects of interest.
  14. If your setting contains more than one class for analysis, the Class dropdown is displayed.
  15. Select the Class from the image analysis setting with multiple classes, which segmented regions should be imaged (e.g. with higher resolution) in the detailed experiment.
  16. If you want the detailed scans to stop after a particular amount of objects, activate Add Stop Criterion for Detailed Scans.
  17. Additional options to define an automatic stop criterion for detailed scans are displayed.
  18. Select the measurement feature that should be used to sort the objects detected by the image analysis and set the order for sorting the results. The drop down list displays all suitable measurement features as defined in selected the image analysis setting. Additionally, enter the maximum number of objects that should be scanned by the detailed experiment and select if it is the overall number of objects or the number of objects per well.
  19. You have set up a stop criterion for the detailed experiment.
  20. In the Detailed Experiment section, select the experiment for the detailed scan, the objective and, if available, the after-magnification lens to be used. Note that as default objective and after-magnification are not stored as part of an experiment.
  21. The detailed experiment is set up.
  22. If your system is equipped with Definite Focus, the checkbox Find Surface before First Detailed Experiment is available. Activate this checkbox to use the Definite Focus to find z-position of the glass surface once before the detailed scans. Activate SW Autofocus before First Detailed Experiment to perform a SW autofocus once before the detailed scans. Optionally, activate Recall Focus before each Detailed Experiment to store the difference between the glass surface and the sample and use this value for each of the detailed experiments.
  23. The focus action for the detailed experiment is defined.
  24. If you want to repeat the detailed scans or the entire Guided Acquisition workflow, activate Repeat Detailed Scan or Repeat Full Guided Acquisition Workflow.
  25. The settings for repetition are displayed.
  26. Define the settings for Cycles and Interval to set up the number of iteration and the minimum time between them. If you repeat the entire workflow, use the dropdown on the top to select which action should be performed if no objects are detected by the analysis in the first iteration.
  27. You have set up a repeated execution of the entire Guided Acquisition workflow or the detailed scan.
  28. Define the folder where you want to store the experiment data.
  29. The output folder is defined.
  30. Click Start.
  1. An overview scan is performed and a .czi image is acquired and saved to your folder.
    Four-panel microscopy viewer: brain cross-section overview with three orange boxes and three cyan zoom panels with green dots
  2. In the example above, the image in the top left shows the overview scan and three identified objects marked with an orange box. For these positions, a detailed scan is performed with a higher magnification.
  3. One Overview Scan Regions.csv and one OverviewScan Region.csv are displayed. The OverviewScan Region.csv table shows the found objects with ID, Bound Center X Stage [µm] and with Y Stage [µm], Bound Width, and Bound Height [µm], as well as Image Scene Container Name and Image Index Scene.
  4. For each detected object a detailed scan is performed. For each object, a *.czi image is acquired and stored in your folder.

Using Guided Acquisition Settings

Guided Acquisition offers you the possibility to save your whole experiment setup in a settings file. This file is saved in the folder for your Guided Acquisition experiment together with all the other settings, for example the overview and detailed experiment, the image analysis setting, and the image processing settings, if a processing step was selected.

Creating a Guided Acquisition setting

  1. On the Applications tab, open the Guided Acquisition tool.
  2. Click Dark blue rounded square icon with a white gear and a small white sparkle to its right and select New.
  3. Name the setting and press Enter on your keyboard or click small floppy disk icon with metallic top.
  1. You have created a setting for Guided Acquisition.

Saving a Guided Acquisition setting

When you have set up your Guided Acquisition experiment and created a setting, you can save the set up as a setting.

  1. Click Dark blue rounded square icon with a white gear and a small white sparkle to its right and select Save.
  1. Your experiment set up is now saved.

Importing and exporting a Guided Acquisition setting

  1. On the Applications tab, open the Guided Acquisition tool.
  2. Click Dark blue rounded square icon with a white gear and a small white sparkle to its right and select Import or Export.
  3. A file browser opens.
  4. Select the file you want to import or the folder where you want to export the setting to.
  5. Click Open/Save.
  1. You have now imported/ exported a setting.

Deleting a Guided Acquisition setting

  1. On the Applications tab, open the Guided Acquisition tool.
  2. Select the setting that you want to delete in the drop-down list.
  3. Click Dark blue rounded square icon with a white gear and a small white sparkle to its right and select Delete.
  4. Confirm that you want to delete the file.
  1. The selected setting is deleted.

Guided Acquisition Tool

Parameter

Description

Dark blue rounded square icon with a white gear and a small white sparkle to its right
Options

-

New

Creates a new Guided Acquisition setting. Enter a name for the setting.

-

Rename

Renames the setting.

-

Save

Saves a modified setting under the current name. An asterisk indicates the modified state.

-

Save As

Saves the current setting under a new name. Enter a name for the setting.

-

Import

Imports an existing setting.

-

Export

Exports the current setting.

-

Delete

Deletes the current setting.

Repeat Full Guided Acquisition Workflow

Activated: Displays parameters to repeat the entire workflow over time.

Cycles

Only visible if Repeat Full Guided Acquisition Workflow is activated.
Defines the number of repetition cycles for the workflow with the slider or input field.

Interval

Only visible if Repeat Full Guided Acquisition Workflow is activated.
Defines the minimum requested time between cycles with the slider or input field. The dropdown selects the time unit (minutes, hours, days).

Object Detection Dropdown

Only visible if Repeat Full Guided Acquisition Workflow is activated.
Selects which action should be taken for repeated iterations if no object are detected during the workflow.

-

Keep Iterating if no Object Detected

Continues to iterate even if no objects are detected.

-

Stop Guided Acquisition if no Object Detected

Stops Guided Acquisition if no objects are detected.

-

Keep Acquiring Scenes without Analysis Findings

Only visible if your overview experiment contains a setup with multiple scenes.
Continues the acquisition also for scenes where nothing is detected by the analysis.

-

Exclude Scenes without Findings in Following Iterations

Only visible if your overview experiment contains a setup with multiple scenes.
Only acquires scenes in subsequent iterations, if the analysis produced results.

-

Exclude Wells without Findings in Following Iterations

Only visible if your overview experiment contains a setup with multiple wells.
Only acquires wells in subsequent iterations, if the analysis produced results.

Overview Scan

Defines the settings for the overview scan.

-

Experiment

Selects the experiment setup to acquire the overview scan.

-

Order

Only visible if your overview experiment contains a setup with multiple scenes or wells.
Selects in which order the individual scenes are acquired and processed. The following options are available:

  • Acquire All Scenes before Analysis: Acquires all scenes before the analysis is executed.
  • Acquire and Process Scenes Sequentially: Acquires and processes each scene sequentially.
  • Acquire and Process Wells Sequentially: Acquires and processes each well sequentially.

-

Objective

Selects the appropriate objective for the overview scan (typically with a low magnification). If the objective has already been defined in the experiment, it is read only (greyed out) here.

-

Optovar

Only visible if an optovar is available.

Selects the optovar for after magnification of the overview scan. If the optovar has already been defined in the experiment, it is read only/greyed out here.

-

Find Surface before Overview Experiment

Only visible if Definite Focus is licensed.

Performs a Find Surface before the overview scan. This step is independent from and additional to any focusing strategy defined in the overview experiment.

-

SW Autofocus before Overview Experiment

Performs a SW Autofocus before the overview scan and sets the found z-position as z-position for the overview scan. This step is independent from and additional to any focusing strategy defined in the overview experiment.

-

Initial Range

Only available if SW Autofocus is activated.

Sets the range for the software autofocus.

Processing

Displays a section for processing steps to process the overview image before it is analyzed.

-

Add Processing Method

Adds a step for a new processing method.

-

Method

Selects a processing method from a drop-down list.
Available processing methods:

  • Airyscan Processing
  • Apotome Raw Convert
  • Deconvolution (defaults)
  • Shading Correction
  • Extended Depth of Focus

-

Setting

Selects the setting for the processing method from the drop-down list.
Note: If you want to use Shading Correction with a reference image, you have to define your setting in Batch mode!

-

White trash bin on dark blue rounded-square icon
Remove

Removes this entire processing step.

Image Analysis

Defines the image analysis parameters for the workflow.

-

Setting

Selects the image analysis setting used to analyze the overview scan.

-

Class

Only visible if you have selected an analysis setting where more than one class is defined.
Selects the class of the image analysis whose regions are used to perform the detailed scans.

-

Add Stop Criterion for Detailed Scans

Activated: Displays options to define a stop criterion for the detailed experiment.

-

Select Feature

Only visible if Add Stop Criterion for Detailed Scans is activated.
Selects the measurement feature that is used to sort the objects detected by the image analysis from the list of suitable measurement features defined in the image analysis.

-

Select Order

Only visible if Add Stop Criterion for Detailed Scans is activated.
Selects the order for sorting the results.

-

Random Selection

Only visible if Add Stop Criterion for Detailed Scans is activated.
Activated: Selects the objects randomly. Select Feature and Select Order are disabled.

-

Max. Objects

Only visible if Add Stop Criterion for Detailed Scans is activated.
Sets the maximum number of objects that get scanned by the detailed experiment.

Repeat Detailed Scan

Activated: Displays parameters to repeat the detailed scan over time.

Cycles

Only visible if Repeat Detailed Scan is activated.
Defines the number of repetition cycles for the detailed scan with the slider or input field.

Interval

Only visible if Repeat Detailed Scan is activated.
Defines the minimum requested time between cycles with the slider or input field. The dropdown selects the time unit (minutes, hours, days).

Detailed Experiment

Defines the settings for the detailed scan.

-

Experiment

Selects the experiment setup to acquire a detailed scan at the position of each object detected by the image analysis.

-

Objective

Selects the appropriate objective for the detailed scan (typically with high magnification). If the objective has already been defined in the experiment, it is read only/greyed out here.

-

Optovar

Only visible if an optovar is available.

Selects the optovar for after magnification of the detailed scan. If the optovar has already been defined in the experiment, it is read only/greyed out here.

-

Find Surface before First Detailed Experiment

Only visible if Definite Focus is licensed.

Performs a Find Surface before the first detailed scan. This step is independent from and additional to any focusing strategy defined in the detailed experiment.

-

SW Autofocus before First Detailed Experiment

Performs a SW Autofocus before the first detailed scan and sets the found z-position as z-position for the detailed scan. This step is independent from and additional to any focusing strategy defined in the detailed experiment.
If the detailed experiment is not a tiles experiment, the focus strategy is automatically set to the “standard” behavior, i.e. the selected autofocus strategy will be performed on each tile of each detailed experiment or each time point for a time-series, respectively. If you want to use a different strategy, e.g. perform the selected autofocus strategy on each n-th tile of each detailed experiment, you have to activate the Tiles checkbox for the detailed experiment.
Then you can select the desired frequency of autofocus in the Focus Strategy tool under Stabilization Event Repetitions and Frequency when you switch to Expert mode.

-

Initial Range

Only available if SW Autofocus is activated.

Sets the range for the software autofocus.

-

Recall Focus before each Detailed Experiment

Only visible if Definite Focus is licensed and if Find Surface before First Detailed Experiment is activated.

Restores the saved focus position and applies it for each detailed experiment.

Output Folder

-

Output Folder

Determines the folder where the analysis results are saved.
A subfolder is automatically be created for each run of a Guided Acquisition experiment.
Note: When a ZEN Connect project is open, the output folder cannot be set here, but is defined by the ZEN Connect project.
Note: When using Guided Acquisition with Direct Processing, make sure that the processing computer has access to this output folder!

Open Output Folder after Execution

Activated: Opens the output folder after Guided Acquisition is finished.

Start

Starts Guided Acquisition.
The Start button turns into a Stop button as long as Guided Acquisition is running. Click Stop to stop the running Guided Acquisition workflow.

Impressum
Carl-Zeiss-Strasse 22
73447 Oberkochen
Germany
Legal