navigate Logo

Getting Started

  • Quick Start Guide
  • Software Installation
  • I Want To…

User Guide

  • Supported Hardware
  • Supported File Formats
  • User Interface Walkthrough
  • Setting Up A Microscope
  • Acquiring Data
  • Case Studies

Development

  • Contributing Guidelines
  • Developer Install
  • Software Architecture
  • Feature Container
  • REST-API
  • Plugin Architecture

Troubleshooting & Known Issues

  • Troubleshooting
  • Known Issues

Plugins

  • navigate Plugin Template
  • navigate Confocal Projection
  • navigate at Scale
  • navigate Constant Velocity Acquisition
  • navigate MMCore
  • navigate ilastik Server
  • navigate Photoactivation

Reference

  • Implemented Microscopes
  • Software API
navigate
  • navigate.controller.sub_controllers.autofocus.AutofocusPopupController
  • View page source

navigate.controller.sub_controllers.autofocus.AutofocusPopupController

class navigate.controller.sub_controllers.autofocus.AutofocusPopupController(view: AutofocusPopup, parent_controller: Controller)

Bases: GUIController

Class creates the popup to configure autofocus parameters.

__init__(view: AutofocusPopup, parent_controller: Controller) → None
Parameters:
  • view (AutofocusPopup) – The view of the autofocus popup.

  • parent_controller (navigate.controller.controller.Controller) – The parent controller of the autofocus popup.

Methods

__init__(view, parent_controller)

param view:

The view of the autofocus popup.

close_popup(*_)

Closes the popup window

display_plot(data_and_flags)

Displays the autofocus plot

execute(command, *args)

This function is called when a command is passed from a child process.

initialize()

This function is called when the controller is initialized

populate_experiment_values()

Populate Experiment Values

register_event_listener(event_name, ...)

Register event listener in the parent_controller

set_experiment_values()

Sets values of widgets based on experiment setting

show_autofocus_setting(*_)

Show Autofocus Parameters

show_verbose_info(*info)

Prints verbose information to the console

showup()

Shows the popup window

start_autofocus()

Starts the autofocus process.

update_device_ref(*_)

Update device reference name

update_experiment_values()

Collects all the values of widgets

update_setting_dict(parameter)

Show Autofocus Parameters

Attributes

custom_events

Custom events for this controller

widgets

The autofocus setting dictionary.

microscope_name

The microscope name.

setting_dict

The autofocus setting dictionary.

autofocus_fig

The autofocus figure.

autofocus_coarse

The autofocus coarse plot.

coarse_plot

The autofocus coarse plot.

close_popup(*_: tuple[str]) → None

Closes the popup window

Parameters:

_ (tuple[str]) – The event arguments.

display_plot(data_and_flags: tuple[numpy.ndarray, bool, bool]) → None

Displays the autofocus plot

datatuple[np.ndarray, bool, bool]

(data, line_plot, clear_data) data: The data to be plotted. line_plot:

If True, the plot will be a line plot. If False, the plot will be a scatter plot.

clear_data:

If True, the plot will be cleared before plotting. If False, the plot will be added to the existing plot.

execute(command, *args)

This function is called when a command is passed from a child process.

Parameters:
  • command (str) – command name

  • args (tuple) – command arguments

initialize()

This function is called when the controller is initialized

This function initializes GUI based on configuration setting parameter: configuration_controller set range value for entry or spinbox widgets; add values to combobox get other necessary information for configuration.yml

populate_experiment_values() → None

Populate Experiment Values

Populates the experiment values from the experiment settings dictionary

register_event_listener(event_name, event_handler)

Register event listener in the parent_controller

Parameters:
  • event_name (str) – event name

  • event_handler (function) – event handler

set_experiment_values()

Sets values of widgets based on experiment setting

setting_dict is a dictionary

show_autofocus_setting(*_: tuple[str]) → None

Show Autofocus Parameters

Parameters:

_ (tuple[str]) – The event arguments.

show_verbose_info(*info)

Prints verbose information to the console

Parameters:

info (tuple) – information to be printed

showup() → None

Shows the popup window

start_autofocus() → None

Starts the autofocus process.

update_device_ref(*_: tuple[str]) → None

Update device reference name

Parameters:

_ (tuple[str]) – The event arguments.

update_experiment_values()

Collects all the values of widgets

setting_dict is a reference of experiment dictionary update the dictionary directly

update_setting_dict(parameter: str) → callable

Show Autofocus Parameters

Parameters:

parameter (str) – The parameter to be updated.

Returns:

The function to update the parameter

Return type:

callable

autofocus_coarse

The autofocus coarse plot.

Type:

object

autofocus_fig

The autofocus figure.

Type:

object

coarse_plot

The autofocus coarse plot.

Type:

object

property custom_events: dict[str, callable]

Custom events for this controller

Returns:

The custom events for this controller.

Return type:

dict[str, callable]

Type:

dict

microscope_name

The microscope name.

Type:

str

parent_controller

parent controller

Type:

Controller

setting_dict

The autofocus setting dictionary.

Type:

dict

view

GUI view

Type:

tkinter.Tk

widgets

The autofocus setting dictionary.

Type:

dict


© Copyright 2025, Dean Lab, UT Southwestern Medical Center.