schrodinger.maestro_utils.surface_manager.surface_manager_panel module

schrodinger.maestro_utils.surface_manager.surface_manager_panel.show_panel_as_floating_window()

Reparent the SurfaceManagerPanel singleton into a standalone non-modal dialog window and show it.

schrodinger.maestro_utils.surface_manager.surface_manager_panel.prepare_pane_for_docking()

Ensure the SurfaceManagerPanel singleton is in dock mode and inserted into the C++ popup container.

schrodinger.maestro_utils.surface_manager.surface_manager_panel.is_panel_in_float_mode() → bool

Return True if the surface manager panel is currently in float (standalone dialog) mode, False if it is docked as a popup.

schrodinger.maestro_utils.surface_manager.surface_manager_panel.select_entries(entry_ids: list[int])

Select the given entry_ids in the workspace surfaces table. Clears the previous selection.

Parameters:

entry_ids – List of entry IDs to select.

schrodinger.maestro_utils.surface_manager.surface_manager_panel.select_surface(entry_id: int, surface_name: str)

Selects the given surface in the workspace surfaces table. Clears the previous selection.

Parameters:

  • entry_id – Entry ID of the surface to select.

  • surface_name – Name of the surface to select.

schrodinger.maestro_utils.surface_manager.surface_manager_panel.show_display_tab(entry_id_to_surfaces: dict[int, set[str]])

Show the Display tab for the specified surfaces in the Surface Manager Panel.

Parameters:

entry_id_to_surfaces – Dictionary mapping entry IDs to sets of surface names.

schrodinger.maestro_utils.surface_manager.surface_manager_panel.show_volume_tab(entry_id: int, surface_name: str)

Show the Volume tab for the specified surface in the Surface Manager Panel.

Parameters:

  • entry_id – Entry ID of the surface.

  • surface_name – Name of the surface.

schrodinger.maestro_utils.surface_manager.surface_manager_panel.import_surface(entries_to_select: set[int] = None, **kwargs) → None

Opens file dialog to import surface/volume file. Supports file types: .vis, .plt, .cns, .map, .ccp4, .mrc, .vtk, .cub

Parameters:

  • entries_to_select – Set of entry IDs to select in the ChooseEntryDialog.

  • kwargs – Additional keyword arguments to pass to the ChooseEntryDialog.

class schrodinger.maestro_utils.surface_manager.surface_manager_panel.SurfaceManagerPanel(parent=None)

Bases: ExecutionMixin, PanelMixin, QWidget

Panel for managing surfaces.

__init__(parent=None)

Constructor for SurfaceManagerPanel. Sets up the UI and connects the signals.

runPanelCommand(panel_name: str)

Runs a command to show a specific panel in Maestro.

Parameters:

panel_name – Name of the panel to show.

updateStatusLabel()

Updates the status label with the number of displayed surfaces.

showEvent(event: QShowEvent)

Show event handler. Refreshes the secondary pane when the panel is shown. Also enables the details button if there are selected surfaces and closes the secondary pane if there are no selected surfaces.

Parameters:

event – The event.

closeEvent(event: QCloseEvent)

Cache the floating position when the standalone window is closed so reopening float mode restores the last user-chosen location.

Parameters:

event – The close event.

isInFloatMode() → bool
Returns:

True if the panel is currently shown as a floating standalone window; False if it is docked in the popup container.

showAsFloatingWindow()

Transition the panel to float mode and show it as a top-level window. If the panel is already visible, move it to the default docked location. Otherwise, restore to the cached floating position if available.

prepareForDocking()

Ensure the panel is in dock mode and handed back to the C++ popup container.

selectEntries(entry_ids: list[int])

Selects the given entry_ids in the workspace surfaces table. Also clears the previous selection.

Parameters:

entry_ids – List of entry IDs to select.

selectSurfaces(entry_id_to_surfaces: dict[int, set[str]])

Selects the given surfaces in the workspace surfaces table. Also clears the previous selection.

Parameters:

entry_id_to_surfaces – Dictionary mapping entry IDs to sets of surface names.

showSecondaryPane(entry_id_to_surfaces: dict[int, set[str]])

Show the secondary pane for the specified surfaces in the Surface Manager Panel.

Parameters:

entry_id_to_surfaces – Dictionary mapping entry IDs to lists of surface names.