pyampp.gxbox.box_view2d

Classes

MapBoxViewState	Reusable state container for focused map+box visualization tools.
MapBoxDisplayWidget	Reusable widget shell for map display + interactive box overlays.

Module Contents

class pyampp.gxbox.box_view2d.MapBoxViewState

Reusable state container for focused map+box visualization tools.

This is intentionally lightweight and plotting-backend agnostic so it can be reused by multiple future GUIs (FOV selector, box inspector, model preview, …).

session_input: pyampp.gxbox.selector_api.SelectorSessionInput

selected_context_id: str | None = None

selected_bottom_id: str | None = None

geometry: pyampp.gxbox.selector_api.BoxGeometrySelection | None = None

fov: pyampp.gxbox.selector_api.DisplayFovSelection | None = None

fov_box: pyampp.gxbox.selector_api.DisplayFovBoxSelection | None = None

map_files: dict[str, str] | None = None

refmaps: dict | None = None

base_maps: dict | None = None

base_wcs_header: str | None = None

base_geometry: pyampp.gxbox.selector_api.BoxGeometrySelection | None = None

map_source_mode: str = 'auto'

square_fov: bool = False

display_observer_key: str = 'earth'

geometry_definition_observer_key: str = 'earth'

fov_definition_observer_key: str = 'earth'

custom_observer_ephemeris: dict | None = None

custom_observer_label: str | None = None

custom_observer_source: str | None = None

class pyampp.gxbox.box_view2d.MapBoxDisplayWidget(parent: PyQt5.QtWidgets.QWidget | None = None)

Bases: PyQt5.QtWidgets.QWidget

Reusable widget shell for map display + interactive box overlays.

Current implementation provides: - SunPy map plotting using the map’s native WCS projection - a static box-outline overlay derived from the current geometry state - a stable API for future drag/resize interaction layers

show_loading_placeholder(message: str = 'Preparing viewer data...') → None

showEvent(event)

set_display_observer_key(observer_key: str | None) → None

set_custom_display_observer_pb0r(*, b0_deg, l0_deg, rsun_arcsec, obs_date=None, rsun_cm=None, label: str | None = None, source: str | None = None) → bool

set_custom_observer_identity(*, label: str | None = None, source: str | None = None) → None

initialize(session_input: pyampp.gxbox.selector_api.SelectorSessionInput) → None

refresh_session_view() → None

set_available_maps(map_ids: Iterable[str]) → None

set_context_map_id(map_id: str | None) → None

set_bottom_map_id(map_id: str | None) → None

set_map_file_paths(map_files: dict[str, str]) → None

set_map_source_mode(mode: str) → None

set_geometry_edit_enabled(enabled: bool) → None

set_entry_box_path(entry_box_path: str | pathlib.Path | None, *, load_session_model: bool = True) → None

set_geometry_selection(selection: pyampp.gxbox.selector_api.BoxGeometrySelection) → None

set_fov_selection(selection: pyampp.gxbox.selector_api.DisplayFovSelection) → None

set_square_fov(enabled: bool, *, refresh: bool = True) → None

set_action_state_callback(callback) → None

committed_line_seeds()

commit_live_3d_edits(line_seeds, streamlines, z_base=0.0) → None

cancel_live_3d_edits() → None

current_geometry_selection() → pyampp.gxbox.selector_api.BoxGeometrySelection | None

current_fov_selection() → pyampp.gxbox.selector_api.DisplayFovSelection | None

current_fov_box_selection() → pyampp.gxbox.selector_api.DisplayFovBoxSelection | None

projected_box_fov() → pyampp.gxbox.selector_api.DisplayFovSelection | None

set_geometry_change_callback(callback) → None

set_map_info_callback(callback) → None

set_status_callback(callback) → None

current_status_text() → str

set_observer_info_callback(callback) → None

set_fov_change_callback(callback) → None

state() → MapBoxViewState | None

observer_options() → tuple[tuple[str, str], Ellipsis]

observer_enabled_keys() → set[str]

set_available_observer_keys(observer_keys: Iterable[str] | None, *, notice: str | None = None) → None

current_display_observer_key() → str

current_observer_persistence_state() → dict[str, Any]

current_observer_info() → dict[str, str]

open_live_3d_viewer() → None

clear_fieldlines() → None

plot_fieldlines(streamlines, z_base=0.0) → None

save_current_plot(output_path: str) → None

show_full_sun_view() → None

show_box_fov_view(pad_factor: float | None = None) → None

recompute_fov_from_box() → None