Acquire an Image (Beginner)

This guide will describe how to acquire a single image and a z-stack using the navigate software package.

Launching the Software Package

Open Anaconda Prompt

To start, you need to open the Anaconda Prompt. Follow these steps:

  1. On Windows, click on the Start menu.

  2. Type Anaconda Prompt into the search bar.

  3. Click on the Anaconda Prompt application to open it.

Note

Ensure that Anaconda and navigate are already installed on your system. If not, please refer to our Quick Start Guide for more information.

Activate Conda Environment

Once the Anaconda Prompt is open, activate the desired conda environment. By default, the command prompt will open the base environment (as shown in parentheses). To activate navigate environment, type the following command into the Anaconda command window and press Enter

(base) conda activate navigate

Launch the Software Package

After activating the environment, navigate should now be shown in parentheses. After you have already configured navigate, you can launch it by typing the following command into the Anaconda command window:

(navigate) navigate

The navigate software package will launch and the main window will appear.

Opening **navigate**.

Configure the Channel Settings

  • Select the Channels tab, which is located on the upper left of the main window.

  • Under the Channel Settings section, select the number of channels needed for imaging. For each channel selected, you will need to configure the acquisition settings:

    Channel settings in the **navigate** software package.
    • Select the appropriate Laser from the dropdown menu.

    • Select the appropriate Power for the laser.

    • Select the appropriate emission Filter from the dropdown menu.

    Changing the emission filter in **navigate**.
    • Specify the camera Exp. Time (ms). A good default value is 100 or 200 ms.

    • Specify the Interval to be 1.0. While this feature is not currently implemented, future releases will allow users to image different channels at different time intervals.

    • Specify the Defocus to be 0. This feature allows you to adjust for chromatic aberrations that result in focal shifts between each imaging channel.


Configure the Camera Settings

  • Select the Camera Settings tab.

  • For standard imaging applications, select Normal in the Sensor Modes dropdown menu within the Camera Modes section.

  • If you are using the rolling shutter, select Light-Sheet and specify its Readout Direction and Number of Pixels.

    Note

    For more information on how to configure the rolling shutter for ASLM operation, please refer to ASLM.

    Changing the camera sensor mode in **navigate**.
  • Choose the size of your camera’s field of view.
    • Specify the Region of Interest Settings by entering the appropriate Number of Pixels for both the Width and Height values. Alternatively, one can select from one of several default values in the Default FOVs section.

    Note

    The FOV Dimensions (microns) is automatically calculated based on the Number of Pixels and the pixel_size as specified in the zoom section of your your configuration.yaml file.

    zoom:
      pixel_size:
        20x: 0.325 # magnification, and pixel size in microns
    
    Changing the camera region of interest in **navigate**.

Note

If multiple channels are selected, each channel will be acquired with the same camera Sensor Mode, Readout Direction, and Region of Interest Settings.


Acquire in a Continuous Scan Mode

  • Select “Continuous Scan” in the dropdown next to the Acquire button in the acquire bar.

    Selecting the continuous scan mode in **navigate**.
  • Press Acquire. This will launch a live acquisition mode.

    Note

    If multiple channels are selected, each channel will be imaged sequentially. The order of imaging is determined by the order of the channels in the Channel Settings section of the Channels tab, and will proceed from the top to the bottom of this channel list.

    Launching the continuous scan mode in **navigate**.
  • Move the stage to identify the location of the sample.
    • Select the Stage Control tab, and use the graphical user interface to move the stage. This includes buttons for moving the stage in X, Y, Z , F, and Theta directions. * The step size for each axis can be adjusted with the spinbox next to each button. * For stages loaded in a synthetic mode, buttons will be disabled. * Absolute positions can be entered in the text boxes next to each button. * Check configuration settings for more information.

    • Alternatively, if available, use the manufacturer-provided joystick to position the sample.

    Note

    The axes for a light-sheet microscope vary in the literature. Here, we define the Y axis as the direction of the light-sheet propagation, the Z axis as the direction of the detection objective, and the X axis as the direction perpendicular to the light-sheet and detection objective axes.

    The F axis typically controls the position of the detection objective along the detection axis.

    The Theta axis typically controls the rotation of the sample.

    Warning

    One should always be careful when moving the stage.

    If the stage is moved too quickly, the sample and/or microscope may be damaged.

    We strongly recommend that you implement stage limits in your configuration file. Please refer to the configuration settings for more information.

    Moving the stage in **navigate**.
  • Press the Stop button in the acquisition bar to stop acquisition.

    Stopping the continuous scan mode in **navigate**.

Acquiring a Single Image

  • Check the Save Data box in the Timepoint Settings section under the Channels tab to save the acquired images. Check this box before acquiring data.

    Saving data in **navigate**.
  • Select Single Acquisition from the dropdown next to the Acquire button.

    Selecting the single acquisition mode in **navigate**.
  • Press Acquire to open the File Saving Dialog interface. Enter the sample parameters, notes, location to save file, and filetype in the File Saving Dialog that pops up.

    Saving data in **navigate**.
  • Press Acquire Data to initiate acquisition. Acquisition will automatically stop once the image is acquired.

    Note

    Each acquisition will be saved in a separate folder (e.g., Cell01, Cell02, …) within the directory specified in the File Saving Dialog interface.

    Data will not be overwritten between acquisitions.

    Saving data in **navigate**.

Acquiring a Z-Stack

  • Using the Stage Control, go to the desired z-position in the sample. Make sure that the sample is in focus. To use the autofocus feature, please refer to the Autofocus Settings.

    Adjusting the stage position in **navigate**.
  • Under the Channels tab, in Stack Acquisition Settings (μm) press Set Start Pos.

    Adjusting the stage position in **navigate**.
  • Using the Stage Control, go to a different z-position within the sample. Again, make sure that the sample is in focus.

    Adjusting the stage position in **navigate**.
  • Under the Channels tab, in Stack Acquisition Settings (μm) press Set End Pos.

    Adjusting the stage position in **navigate**.

    Note

    If there is a shift in F between the start and stop positions, the F axis will be ramped synchronously with Z to maintain focus.

    Check configuration settings for more information to determine if focus is enabled in hardware.

    Refer to Imaging on a mesoSPIM BT section for an example of how to acquire a z-stack with a focus ramp.

  • Type the desired step size in microns in the Step Size dialog box in Stack Acquisition Settings (μm).

    Note

    The minimum step size, and increment between steps, are graphical user interface defaults that are specified in the configuration.yaml file. More information can configuration settings

    gui:
      stack_acquisition:
        step_size:
          min: 0.100
          max: 1000
          step: 0.1
    
    _images/define-step-size.png
  • If using multiple channels for imaging, select either Per Z or Per Stack under Laser Cycling Settings in the Stack Acquisition Settings (μm) section under the Channels tab.

    • Per Z acquires all channels before moving the stage to a new position.

    • Per Stack acquires all images in a stack acquisition for a single channel before moving the stage back to the start position and restarting acquisition for the subsequent channel until all channels are imaged.

    _images/laser-cycling-settings.png
  • Select Z-Stack from the dropdown next to the Acquire button. Press Acquire.

    _images/z-stack-acquisition.png
  • Enter the sample parameters, notes, location to save file, and filetype in the File Saving Dialog that pops up.

  • Press Acquire Data to initiate acquisition. Acquisition will automatically stop once the image series is acquired.