Source code for jdaviz.configs.default.plugins.subset_tools.subset_tools

import os
import warnings

import numpy as np

from astropy.time import Time
import astropy.units as u
from glue.core.message import EditSubsetMessage, SubsetUpdateMessage
from glue.core.edit_subset_mode import (AndMode, AndNotMode, OrMode,
                                        ReplaceMode, XorMode, NewMode)
from glue.core.roi import CircularROI, CircularAnnulusROI, EllipticalROI, RectangularROI
from glue.core.subset import (RoiSubsetState, RangeSubsetState, CompositeSubsetState,
                              MaskSubsetState)
from glue.icons import icon_path
from glue_jupyter.widgets.subset_mode_vuetify import SelectionModeMenu
from glue_jupyter.common.toolbar_vuetify import read_icon
from traitlets import Any, List, Unicode, Bool, observe

from specutils import SpectralRegion
from photutils.aperture import (CircularAperture, SkyCircularAperture,
                                EllipticalAperture, SkyEllipticalAperture,
                                RectangularAperture, SkyRectangularAperture,
                                CircularAnnulus, SkyCircularAnnulus)
from regions import (Regions, CirclePixelRegion, CircleSkyRegion,
                     EllipsePixelRegion, EllipseSkyRegion,
                     RectanglePixelRegion, RectangleSkyRegion,
                     CircleAnnulusPixelRegion, CircleAnnulusSkyRegion)

from jdaviz.core.region_translators import regions2roi, aperture2regions
from jdaviz.core.events import (SnackbarMessage, GlobalDisplayUnitChanged,
                                LinkUpdatedMessage, SubsetRenameMessage, DataRenamedMessage)
from jdaviz.core.registries import tray_registry
from jdaviz.core.template_mixin import (PluginTemplateMixin, DatasetSelect,
                                        SubsetSelect, SelectPluginComponent,
                                        LoadersMixin)
from jdaviz.core.tools import ICON_DIR
from jdaviz.core.user_api import PluginUserApi
from jdaviz.core.helpers import _next_subset_num
from jdaviz.utils import (MultiMaskSubsetState, _chain_regions, data_has_valid_wcs,
                          _get_celestial_wcs)

from jdaviz.configs.default.plugins.subset_tools import utils


__all__ = ['SubsetTools']

SUBSET_MODES = {
    'new': NewMode,
    'replace': ReplaceMode,
    'OrState': OrMode,
    'AndState': AndMode,
    'XorState': XorMode,
    'AndNotState': AndNotMode,
    'RangeSubsetState': RangeSubsetState,
    'RoiSubsetState': RoiSubsetState
}
SUBSET_MODES_PRETTY = {
    'new': NewMode,
    'replace': ReplaceMode,
    'or': OrMode,
    'and': AndMode,
    'xor': XorMode,
    'andnot': AndNotMode,
}
SUBSET_TO_PRETTY = {v: k for k, v in SUBSET_MODES_PRETTY.items()}
COMBO_OPTIONS = list(SUBSET_MODES_PRETTY.keys())


[docs] @tray_registry('g-subset-tools', label="Subset Tools", category='core', sidebar='subsets') class SubsetTools(PluginTemplateMixin, LoadersMixin): """ See the :ref:`Subset Tools <imviz-subset-plugin>` for more details. Only the following attributes and methods are available through the :ref:`public plugin API <plugin-apis>`: * :meth:`~jdaviz.core.template_mixin.PluginTemplateMixin.show` * :meth:`~jdaviz.core.template_mixin.PluginTemplateMixin.open_in_tray` * :meth:`~jdaviz.core.template_mixin.PluginTemplateMixin.close_in_tray` * ``loaders`` Dictionary of loaders to load subsets into the plugin. * ``subset`` (:class:`~jdaviz.core.template_mixin.SubsetSelect`): Manages subset selection and creation * ``combination_mode`` (:class:`~jdaviz.core.template_mixin.SelectPluginComponent`): Allows selection of combination modes for subsets * ``recenter_dataset`` (:class:`~jdaviz.core.template_mixin.DatasetSelect`): Data used for recentering. * :meth:`recenter` * :meth:`get_center` * :meth:`set_center` * :meth:`import_region` * :meth:`get_regions` * :meth:`rename_selected` * :meth:`rename_subset` * :meth:`update_subset` * :meth:`simplify_subset` """ template_file = __file__, "subset_tools.vue" select = List([]).tag(sync=True) subset_select_mode = Unicode().tag(sync=True) subset_edit_value = Any().tag(sync=True) subset_items = List([]).tag(sync=True) subset_selected = Any().tag(sync=True) mode_selected = Unicode('add').tag(sync=True) show_region_info = Bool(True).tag(sync=True) subset_types = List([]).tag(sync=True) subset_definitions = List([]).tag(sync=True) glue_state_types = List([]).tag(sync=True) has_subset_details = Bool(False).tag(sync=True) recenter_dataset_items = List().tag(sync=True) recenter_dataset_selected = Unicode().tag(sync=True) subplugins_opened = Any().tag(sync=True) multiselect = Bool(False).tag(sync=True) # multiselect only for subset is_centerable = Bool(False).tag(sync=True) can_simplify = Bool(False).tag(sync=True) can_freeze = Bool(False).tag(sync=True) icon_replace = Unicode(read_icon(os.path.join(icon_path("glue_replace", icon_format="svg")), 'svg+xml')).tag(sync=True) # noqa icon_or = Unicode(read_icon(os.path.join(icon_path("glue_or", icon_format="svg")), 'svg+xml')).tag(sync=True) # noqa icon_and = Unicode(read_icon(os.path.join(icon_path("glue_and", icon_format="svg")), 'svg+xml')).tag(sync=True) # noqa icon_xor = Unicode(read_icon(os.path.join(icon_path("glue_xor", icon_format="svg")), 'svg+xml')).tag(sync=True) # noqa icon_andnot = Unicode(read_icon(os.path.join(icon_path("glue_andnot", icon_format="svg")), 'svg+xml')).tag(sync=True) # noqa icon_radialtocheck = Unicode(read_icon(os.path.join(ICON_DIR, 'radialtocheck.svg'), 'svg+xml')).tag(sync=True) # noqa icon_checktoradial = Unicode(read_icon(os.path.join(ICON_DIR, 'checktoradial.svg'), 'svg+xml')).tag(sync=True) # noqa combination_mode_items = List([]).tag(sync=True) combination_mode_selected = Any().tag(sync=True) def __init__(self, *args, **kwargs): super().__init__(*args, **kwargs) # description displayed under plugin title in tray config = self.app.config if config in ['cubeviz', 'specviz2d', 'mosviz', 'rampviz']: self._plugin_description = 'Select and interact with spectral/spatial subsets.' elif config == 'imviz': self._plugin_description = 'Select and interact with spatial subsets.' elif config == 'specviz': self._plugin_description = 'Select and interact with spectral subsets.' else: self._plugin_description = 'Select and interact with subsets.' self.components = { 'g-subset-mode': SelectionModeMenu(session=self.session) } self.session.hub.subscribe(self, EditSubsetMessage, handler=self._sync_selected_from_state) self.session.hub.subscribe(self, SubsetUpdateMessage, handler=self._on_subset_update) self.session.hub.subscribe(self, GlobalDisplayUnitChanged, handler=self._on_display_unit_changed) self.session.hub.subscribe(self, LinkUpdatedMessage, handler=self._on_link_update) self.session.hub.subscribe(self, SubsetRenameMessage, handler=self._sync_available_from_state) self.session.hub.subscribe(self, DataRenamedMessage, handler=self._on_data_renamed) self.subset = SubsetSelect(self, items='subset_items', selected='subset_selected', multiselect='multiselect', default_text="Create New", mode='subset_select_mode', edit_value='subset_edit_value', on_rename=self.rename_subset, on_remove=self.delete_subset) self.subset_states = [] self.selected_subset_group = None self.spectral_display_unit = None align_by = getattr(self.app, '_align_by', None) self.display_sky_coordinates = (align_by == 'wcs' and not self.multiselect) self.recenter_dataset = DatasetSelect(self, 'recenter_dataset_items', 'recenter_dataset_selected', multiselect=None) self.combination_mode = SelectPluginComponent(self, items='combination_mode_items', selected='combination_mode_selected', manual_options=COMBO_OPTIONS) @property def user_api(self): expose = ['subset', 'combination_mode', 'recenter_dataset', 'recenter', 'get_center', 'set_center', 'import_region', 'get_regions', 'rename_selected', 'rename_subset', 'update_subset', 'simplify_subset', 'delete_subset'] return PluginUserApi(self, expose)
[docs] def get_regions(self, region_type=None, list_of_subset_labels=None, use_display_units=False, return_sky_region=None, wrt_data=None): """ Return spatial and/or spectral subsets of ``region_type`` (spatial or spectral, default both) as ``regions`` or ``SpectralRegions`` objects, respectively. Parameters ---------- region_type : str or None, optional Specifies the type of subsets to retrieve. Options are ``spatial`` to retrieve only spatial subsets, ``spectral`` to retrieve only spectral subsets or ``None`` (default) to retrieve both spatial and spectral subsets, when relevant to the current configuration. list_of_subset_labels : list of str or None, optional If specified, only subsets matching these labels will be included. If not specified, all subsets matching the ``region_type`` will be returned. use_display_units : bool, optional (For spectral subsets) If False (default), subsets are returned in the native data unit. If True, subsets are returned in the spectral axis display unit set in the Unit Conversion plugin. wrt_data : str or None Only applicable for spatial subsets, an error will be raised when ''region_type'' equals 'spectral'. Otherwise, spectral subsets will not be impacted when called. Controls return type of ``PixelRegion`` / ``SkyRegion``. To return a spatial subset in opposition with the current link type (e.g return ``PixelRegion`` when WCS linked, ``SkyRegion`` when pixel linked), ``wrt_data`` can be set to the data label of the dataset whose WCS should be used for this transformation. The default behavior (None) will return Pixel/Sky region based on app link type (Sky for Cubeviz), using the WCS of the subset's parent dataset (i.e the data layer the subset was created on). Returns ------- regions : dict A dictionary mapping subset labels to their respective ``regions`` objects (for spatial regions) or ``SpectralRegions`` objects (for spectral regions). Examples -------- >>> from jdaviz import Imviz, Cubeviz >>> from regions import PixCoord, CirclePixelRegion, CircleSkyRegion >>> from astropy.nddata import NDData >>> import numpy as np >>> import astropy.units as u >>> imviz = Imviz() >>> imviz.link_data(align_by='pixels') >>> data = NDData(np.ones((128, 128)) * u.nJy, wcs=getfixture('image_2d_wcs')) >>> imviz.load_data(data) >>> plg = imviz.plugins['Subset Tools'] >>> plg.import_region(CirclePixelRegion(center=PixCoord(x=1163.618408203125, y=1433.47998046875), radius=141.28575134277344)) # noqa E501 >>> type(plg.get_regions()['Subset 1']) <class 'regions.shapes.circle.CirclePixelRegion'> >>> type(plg.get_regions(wrt_data='NDData[DATA]')['Subset 1']) <class 'regions.shapes.circle.CircleSkyRegion'> >>> imviz.app.delete_subsets() >>> imviz.link_data(align_by='wcs') >>> plg.import_region(CirclePixelRegion(center=PixCoord(x=1163.618408203125, y=1433.47998046875), radius=141.28575134277344)) # noqa E501 >>> type(plg.get_regions()['Subset 2']) <class 'regions.shapes.circle.CircleSkyRegion'> >>> type(plg.get_regions(wrt_data='NDData[DATA]')['Subset 2']) <class 'regions.shapes.circle.CirclePixelRegion'> >>> cubeviz = Cubeviz() >>> cubeviz.load_data(getfixture('spectrum1d_cube')) >>> plg = cubeviz.plugins['Subset Tools'] >>> plg.import_region(CirclePixelRegion(center=PixCoord(x=24.27156066879736, y=22.183517455582475), radius=4.7523674964904785)) # noqa E501 >>> type(plg.get_regions()['Subset 1']) <class 'regions.shapes.circle.CircleSkyRegion'> >>> type(plg.get_regions(wrt_data='3D Spectrum [FLUX]')['Subset 1']) <class 'regions.shapes.circle.CirclePixelRegion'> """ if region_type is not None: region_type = region_type.lower() if region_type not in ['spectral', 'spatial']: raise ValueError("`region_type` must be 'spectral', 'spatial', or None for any.") elif region_type == 'spectral' and wrt_data: raise ValueError('Unable to retrieve SkyRegion objects for spectral subsets') if ((self.config == 'imviz' and region_type == 'spectral') or (self.config == 'specviz' and region_type == 'spatial')): raise ValueError(f"No {region_type} subsets in {self.config}.") region_type = [region_type] else: # determine subset return type(s) by config, if not specified region_type = {'imviz': ['spatial'], 'specviz': ['spectral']}.get(self.config, ['spatial', 'spectral']) if isinstance(wrt_data, str) and wrt_data not in self.data_collection: raise ValueError(f'{wrt_data} is not data in {self.data_collection}') if ((self.app._align_by == 'wcs' and wrt_data is None) or ((self.app._align_by == 'pixels' and self.config != 'cubeviz') and wrt_data) or self.config == 'cubeviz' and wrt_data is None): reg_type = 'sky_region' else: reg_type = 'region' # TODO: remove after deprecation period # Temporarily allow return_sky_region to function as before if wrt_data # is not set. if return_sky_region is not None and wrt_data: raise ValueError('return_sky_region no longer used, use wrt_data instead') elif return_sky_region is not None: wrt_data = self.app.data_collection[0].label warnings.warn(f'return_sky_region no longer used, use wrt_data instead. ' f'Defaulting to {wrt_data} for the wrt_data kwarg') reg_type = 'sky_region' if return_sky_region else 'region' # first get ALL subsets of specified spatial/spectral type(s) subsets = self.app.get_subsets(spectral_only=region_type == ['spectral'], spatial_only=region_type == ['spatial'], include_sky_region=reg_type == 'sky_region', use_display_units=use_display_units, wrt_data=wrt_data) labels = list_of_subset_labels or list(subsets.keys()) if isinstance(labels, str): labels = [labels] regions, failed_regs = {}, set() for subset_label in labels: try: ss = subsets[subset_label] if isinstance(ss, SpectralRegion): regions[subset_label] = ss else: reg = _chain_regions([x[reg_type] for x in ss], [x['glue_state'] for x in ss]) if reg is None: failed_regs.add(subset_label) else: regions[subset_label] = reg except ValueError: # key doesnt exist, subset wasn't retrieved failed_regs.add(subset_label) if len(failed_regs) > 0: warn_msg = f"Regions skipped: {', '.join(sorted(failed_regs))}" self.app.hub.broadcast(SnackbarMessage(warn_msg, color="warning", timeout=8000, sender=self.app)) warnings.warn(warn_msg, UserWarning) return regions
def _on_link_update(self, *args): """When linking is changed pixels<>wcs, change display units of the subset plugin from pixel (for pixel linking) to sky (for WCS linking). If there is an active selection in the subset plugin, push this change to the UI upon link change by calling _get_subset_definition, which will re-determine how to display subset information.""" align_by = getattr(self.app, '_align_by', None) self.display_sky_coordinates = (align_by == 'wcs') if self.subset_selected != self.subset.default_text: self._get_subset_definition(*args) def _sync_selected_from_state(self, *args): if not hasattr(self, 'subset') or self.multiselect: # during initial init, this can trigger before the component is initialized return if self.session.edit_subset_mode.edit_subset == []: self.app.state.subset_mode_create = True if self.subset_selected != self.subset.default_text: self.subset_selected = self.subset.default_text self.show_region_info = False else: self.app.state.subset_mode_create = False new_label = self.session.edit_subset_mode.edit_subset[0].label if new_label != self.subset_selected: if new_label not in [s['label'] for s in self.subset_items]: self._sync_available_from_state() self.subset_selected = self.session.edit_subset_mode.edit_subset[0].label self.show_region_info = True self._update_combination_mode() def _on_subset_update(self, msg): self._sync_selected_from_state() if 'Create New' in self.subset_selected: return subsets_avail = [sg.label for sg in self.app.data_collection.subset_groups] if self.subset_selected not in subsets_avail: # subset selection should re-default after processing the deleted subset, # for now we can safely ignore return self._get_subset_definition() subset_to_update = self.session.edit_subset_mode.edit_subset[0] self.subset._update_subset(subset_to_update, attribute="type") def _on_data_renamed(self, msg): """ Update displayed subset definitions when a dataset is renamed. This ensures the UI reflects the new dataset name without requiring a subset selection change. """ # Only refresh if a subset is currently selected and displayed if (self.subset_selected and self.subset_selected != self.subset.default_text and self.subset_definitions): # Re-generate the subset definitions to pick up any parent label changes self._get_subset_definition() def _sync_available_from_state(self, *args): if not hasattr(self, 'subset'): # during initial init, this can trigger before the component is initialized return self.subset_items = [{'label': self.subset.default_text}] + [ self.subset._subset_to_dict(subset) for subset in self.data_collection.subset_groups] @observe('subset_selected') def _sync_selected_from_ui(self, change): self.subset_definitions = [] self.subset_types = [] self.glue_state_types = [] self.is_centerable = False if not hasattr(self, 'subset'): # during initial init, this can trigger before the component is initialized return if change['new'] != self.subset.default_text: self._get_subset_definition(change['new']) self.show_region_info = change['new'] != self.subset.default_text m = [s for s in self.app.data_collection.subset_groups if s.label == change['new']] if m != self.session.edit_subset_mode.edit_subset: self.session.edit_subset_mode.edit_subset = m def _unpack_get_subsets_for_ui(self): """ Convert what app.get_subsets returns into something the UI of this plugin can display. """ if self.multiselect: self.is_centerable = True return include_sky_region = bool(self.display_sky_coordinates) subset_information = self.app.get_subsets(self.subset_selected, simplify_spectral=False, use_display_units=True, include_sky_region=include_sky_region) _around_decimals = 6 # Avoid 30 degrees from coming back as 29.999999999999996 if not subset_information: return if ((len(subset_information) == 1) and (isinstance(subset_information[0]["subset_state"], RangeSubsetState) or (isinstance(subset_information[0]["subset_state"], RoiSubsetState) and isinstance(subset_information[0]["subset_state"].roi, (CircularROI, RectangularROI, EllipticalROI))))): self.is_centerable = True else: self.is_centerable = False for spec in subset_information: subset_definition = [] subset_type = '' subset_state = spec["subset_state"] glue_state = spec["glue_state"] if isinstance(subset_state, RoiSubsetState): subset_definition.append({ "name": "Parent", "att": "parent", "value": subset_state.xatt.parent.label, "orig": subset_state.xatt.parent.label}) sky_region = spec['sky_region'] if self.display_sky_coordinates and (sky_region is not None): subset_definition += utils._sky_region_to_subset_def(sky_region) else: if isinstance(subset_state.roi, CircularROI): x, y = subset_state.roi.center() r = subset_state.roi.radius subset_definition += [ {"name": "X Center (pixels)", "att": "xc", "value": x, "orig": x}, {"name": "Y Center (pixels)", "att": "yc", "value": y, "orig": y}, {"name": "Radius (pixels)", "att": "radius", "value": r, "orig": r}] elif isinstance(subset_state.roi, RectangularROI): for att in ("Xmin", "Xmax", "Ymin", "Ymax"): real_att = att.lower() val = getattr(subset_state.roi, real_att) subset_definition.append( {"name": att + " (pixels)", "att": real_att, "value": val, "orig": val}) theta = np.around(np.degrees(subset_state.roi.theta), decimals=_around_decimals) subset_definition.append({"name": "Angle", "att": "theta", "value": theta, "orig": theta}) elif isinstance(subset_state.roi, EllipticalROI): xc, yc = subset_state.roi.center() rx = subset_state.roi.radius_x ry = subset_state.roi.radius_y theta = np.around(np.degrees(subset_state.roi.theta), decimals=_around_decimals) subset_definition += [ {"name": "X Center (pixels)", "att": "xc", "value": xc, "orig": xc}, {"name": "Y Center (pixels)", "att": "yc", "value": yc, "orig": yc}, {"name": "X Radius (pixels)", "att": "radius_x", "value": rx, "orig": rx}, {"name": "Y Radius (pixels)", "att": "radius_y", "value": ry, "orig": ry}, {"name": "Angle", "att": "theta", "value": theta, "orig": theta}] elif isinstance(subset_state.roi, CircularAnnulusROI): xc, yc = subset_state.roi.center() inner_r = subset_state.roi.inner_radius outer_r = subset_state.roi.outer_radius subset_definition += [{"name": "X Center (pixels)", "att": "xc", "value": xc, "orig": xc}, {"name": "Y Center (pixels)", "att": "yc", "value": yc, "orig": yc}, {"name": "Inner Radius (pixels)", "att": "inner_radius", "value": inner_r, "orig": inner_r}, {"name": "Outer Radius (pixels)", "att": "outer_radius", "value": outer_r, "orig": outer_r}] else: # pragma: no cover raise NotImplementedError(f"Unable to translate {subset_state.roi.__class__.__name__}") # noqa: E501 subset_type = subset_state.roi.__class__.__name__ elif isinstance(subset_state, RangeSubsetState): region = spec['region'] if isinstance(region, Time): lo = region.min() hi = region.max() subset_definition = [{"name": "Lower bound", "att": "lo", "value": lo.value, "orig": lo.value}, {"name": "Upper bound", "att": "hi", "value": hi.value, "orig": hi.value}] else: lo = region.lower hi = region.upper subset_definition = [{"name": "Lower bound", "att": "lo", "value": lo.value, "orig": lo.value, "unit": str(lo.unit)}, {"name": "Upper bound", "att": "hi", "value": hi.value, "orig": hi.value, "unit": str(hi.unit)}] subset_type = "Range" elif isinstance(subset_state, MultiMaskSubsetState): total_masked = subset_state.total_masked_first_data() subset_definition = [{"name": "Masked values", "att": "masked", "value": total_masked, "orig": total_masked}] subset_type = "Mask" if len(subset_definition) > 0: # Note: .append() does not work for List traitlet. self.subset_definitions = self.subset_definitions + [subset_definition] self.subset_types = self.subset_types + [subset_type] self.glue_state_types = self.glue_state_types + [glue_state] self.subset_states = self.subset_states + [subset_state] simplifiable_states = set(['AndState', 'XorState', 'AndNotState']) # Check if the subset has more than one subregion, is a range subset # type, and uses one of the states that can be simplified. Mask subset # types cannot be simplified so subsets contained that are skipped. if 'Mask' in self.subset_types: self.can_simplify = False elif ((len(self.subset_states) > 1) and isinstance(self.subset_states[0], RangeSubsetState) and ((len(simplifiable_states - set(self.glue_state_types)) < 3) or self.app.is_there_overlap_spectral_subset(self.subset_selected))): self.can_simplify = True else: self.can_simplify = False def _get_subset_definition(self, *args): """ Retrieve the parameters defining the selected subset, for example the upper and lower bounds for a simple spectral subset. """ self.subset_definitions = [] self.subset_types = [] self.glue_state_types = [] self.subset_states = [] self._unpack_get_subsets_for_ui()
[docs] def vue_freeze_subset(self, *args): sgs = {sg.label: sg for sg in self.app.data_collection.subset_groups} sg = sgs.get(self.subset_selected) masks = {} for data in self.app.data_collection: masks[data.uuid] = sg.subset_state.to_mask(data) sg.subset_state = MultiMaskSubsetState(masks)
def _simplify_subset(self, raise_error=True): if self.multiselect: msg = "Cannot simplify spectral subset when multiselect is active" if raise_error: raise ValueError(msg) else: self.hub.broadcast(SnackbarMessage(msg, color='warning', sender=self)) return if len(self.subset_states) < 2: msg = "Cannot simplify spectral subset of length less than 2" if raise_error: raise ValueError(msg) else: self.hub.broadcast(SnackbarMessage(msg, color='warning', sender=self)) return att = self.subset_states[0].att self.app.simplify_spectral_subset(subset_name=self.subset_selected, att=att, overwrite=True)
[docs] def simplify_subset(self): """ Simplify the selected spectral subset by combining all subregions into a single spectral region. This is only available for spectral subsets with more than one subregion. """ self._simplify_subset(raise_error=True)
[docs] def vue_simplify_subset(self, *args): self._simplify_subset(raise_error=False)
def _on_display_unit_changed(self, msg): # We only care about the spectral units, since flux units don't affect spectral subsets if msg.axis == "spectral": self.spectral_display_unit = msg.unit if self.subset_selected != self.subset.default_text: self._get_subset_definition(self.subset_selected) def _update_subset(self): status, reason = self._check_input() if not status: self.hub.broadcast(SnackbarMessage(reason, color='error', sender=self)) return for index, sub in enumerate(self.subset_definitions): if len(self.subset_states) <= index: return sub_states = self.subset_states[index] # we need to push updates to subset in pixels. to do this when wcs # linked, convert the updated subset parameters from sky to pix wcs = None if self.display_sky_coordinates: wcs = self.app._get_wcs_from_subset(sub_states) if wcs is not None: # convert newly entered sky coords to pixel updated_skyreg = utils._subset_def_to_region(self.subset_types[index], sub) # noqa updated_pixreg_attrs = utils._get_pixregion_params_in_dict(updated_skyreg.to_pixel(wcs)) # noqa # convert previous entered sky coords to pixel orig_skyreg = utils._subset_def_to_region(self.subset_types[index], sub, val='orig') # noqa orig_pixreg_attrs = utils._get_pixregion_params_in_dict(orig_skyreg.to_pixel(wcs)) # noqa for d_att in sub: if d_att["att"] == 'parent': # Read-only continue if self.display_sky_coordinates and (wcs is not None): d_att["value"] = updated_pixreg_attrs[d_att["att"]] d_att["orig"] = orig_pixreg_attrs[d_att["att"]] if (d_att["att"] == 'theta') and (self.display_sky_coordinates is False): # Humans use degrees but glue uses radians # We've already enforced this in wcs linking in _get_pixregion_params_in_dict d_val = np.radians(d_att["value"]) else: d_val = float(d_att["value"]) # Convert from display unit to original unit if necessary if self.subset_types[index] == "Range": if self.spectral_display_unit is not None: x_att = sub_states.att # since this is a spectrum range subset, we can get the native units # from the current reference data in the spectrum viewer sv = self.spectrum_viewer base_units = sv.state.reference_data.get_component(x_att).units if self.spectral_display_unit != base_units: d_val = d_val*u.Unit(self.spectral_display_unit) d_val = d_val.to(u.Unit(base_units)) d_val = d_val.value if float(d_att["orig"]) != d_val: if self.subset_types[index] == "Range": setattr(sub_states, d_att["att"], d_val) else: setattr(sub_states.roi, d_att["att"], d_val) self._push_update_to_ui()
[docs] def update_subset(self, subset_label=None, subregion=None, **kwargs): ''' Method to update the attributes of an existing subset. The attributes of a subset and their current values can be retrieved with the 'get_subset_definition` method. Parameters ---------- subset_label : str The name of the subset to update. If this is not the currently selected subset in the UI, it will be selected. subregion : int, optional The integer subregion index (in the subset_definitions dictionary) for which to modify the specified attributes. The attributes to update and their new values are passed as keyword arguments to this function, for example: plg = imviz.plugins['Subset Tools'] plg.update_subset('Subset 1', xmax = 9.522, xmin = 9.452) If no values to update are specified, this function will return the current definition of the specified subset. The "att" keys in the returned dictionaries are the attributes that can be updated with this method. ''' if subset_label is not None: if subset_label not in self.subset.choices: raise ValueError(f"{subset_label} is not an existing subset. " f"Available choices are: {self.subset.choices}") if subset_label != self.subset.selected: self.subset.selected = subset_label if not kwargs: # If no updates were requested, we instead return the current definition public_definition = {} for i in range(len(self.subset_definitions)): public_definition[f'subregion {i}'] = [] for d in self.subset_definitions[i]: if d['att'] == 'parent': continue public_definition[f'subregion {i}'].append({key:d[key] for key in d if key != "orig"}) # noqa return public_definition if len(self.subset_definitions) == 1: subregion = 0 elif subregion is None: raise ValueError("Specified subset has more than one subregion, please " "specify which integer subregion index to modify.") for key, value in kwargs.items(): for i in range(len(self.subset_definitions[subregion])): att_dict = self.subset_definitions[subregion][i] if att_dict['att'] == key: att_dict['value'] = value self.subset_definitions[subregion][i] = att_dict break else: raise ValueError(f"{key} is not an attribute of the specified subset/subregion.") self._update_subset()
[docs] def vue_update_subset(self, *args): if self.multiselect: self.hub.broadcast(SnackbarMessage("Cannot update subset " "when multiselect is active", color='warning', sender=self)) return self._update_subset()
def _push_update_to_ui(self, subset_name=None): """ Forces the UI to update how it represents the subset. Parameters ---------- subset_name : str The name of the subset that is being updated. """ if not subset_name: subset_name = self.subset_selected try: dc = self.data_collection subsets = dc.subset_groups subset_to_update = subsets[[x.label for x in subsets].index(subset_name)] self.session.edit_subset_mode.edit_subset = [subset_to_update] self.session.edit_subset_mode._combine_data(subset_to_update.subset_state, override_mode=ReplaceMode) except Exception as e: # pragma: no cover self.hub.broadcast(SnackbarMessage( f"Failed to update Subset: {repr(e)}", color='error', sender=self, traceback=e)) def _check_input(self): status = True reason = "" for index, sub in enumerate(self.subset_definitions): lo = hi = xmin = xmax = ymin = ymax = None inner_radius = outer_radius = None for d_att in sub: if d_att["att"] == "lo": lo = d_att["value"] elif d_att["att"] == "hi": hi = d_att["value"] elif d_att["att"] == "radius" and d_att["value"] <= 0: status = False reason = "Failed to update Subset: radius must be a positive scalar" break elif d_att["att"] == "xmin": xmin = d_att["value"] elif d_att["att"] == "xmax": xmax = d_att["value"] elif d_att["att"] == "ymin": ymin = d_att["value"] elif d_att["att"] == "ymax": ymax = d_att["value"] elif d_att["att"] == "outer_radius": outer_radius = d_att["value"] elif d_att["att"] == "inner_radius": inner_radius = d_att["value"] if lo and hi and hi <= lo: status = False reason = "Failed to update Subset: lower bound must be less than upper bound" break elif xmin and xmax and ymin and ymax and (xmax - xmin <= 0 or ymax - ymin <= 0): status = False reason = "Failed to update Subset: width and length must be positive scalars" break elif inner_radius and outer_radius and inner_radius >= outer_radius: status = False reason = "Failed to update Subset: inner radius must be less than outer radius" break return status, reason
[docs] def recenter(self): """ Recenter the selected subset on the centroid of the region of the current subset in the selected data layer. """ # Composite region cannot be centered. This only works for Imviz. if not self.is_centerable or self.config != 'imviz': # no-op raise NotImplementedError( f'Cannot recenter: is_centerable={self.is_centerable}, config={self.config}') from astropy.wcs.utils import pixel_to_pixel from photutils.aperture import ApertureStats from jdaviz.core.region_translators import regions2aperture def _do_recentering(subset, subset_state): try: type = 'sky_region' if self.app.config == 'imviz' and self.app._align_by == 'wcs' else 'region' # noqa: E501 reg = self.app.get_subsets(subset_name=subset, include_sky_region=type == 'sky_region', spatial_only=True)[0][type] aperture = regions2aperture(reg) data = self.recenter_dataset.selected_dc_item comp = data.get_component(data.main_components[0]) comp_data = comp.data phot_aperstats = ApertureStats(comp_data, aperture, wcs=data.coords) # Sky region from WCS linking, need to convert centroid back to pixels. if hasattr(reg, "to_pixel"): # Centroid was calculated in selected data. # However, Subset is always defined w.r.t. its parent, # so we need to convert back. x, y = pixel_to_pixel( data.coords, subset_state.xatt.parent.coords, phot_aperstats.xcentroid, phot_aperstats.ycentroid) else: x = phot_aperstats.xcentroid y = phot_aperstats.ycentroid if not np.all(np.isfinite((x, y))): raise ValueError(f'Invalid centroid ({x}, {y})') except Exception as e: self.set_center(self.get_center(subset_name=subset), subset_name=subset, update=False) self.hub.broadcast(SnackbarMessage( f"Failed to calculate centroid: {repr(e)}", color='error', sender=self, traceback=e)) else: self.set_center((x, y), subset_name=subset, update=True) if not self.multiselect: _do_recentering(self.subset_selected, self.subset.selected_subset_state) else: for sub, subset_state in zip(self.subset_selected, self.subset.selected_subset_state): if (sub != self.subset.default_text and not isinstance(subset_state, CompositeSubsetState)): self.is_centerable = True _do_recentering(sub, subset_state) elif (sub != self.subset.default_text and isinstance(subset_state, CompositeSubsetState)): self.hub.broadcast(SnackbarMessage(f"Unable to recenter " f"composite subset {sub}", color='error', sender=self))
[docs] def vue_recenter_subset(self, *args): self.recenter()
def _get_subset_state(self, subset_name=None): if self.multiselect and not subset_name: raise ValueError("Please include subset_name in when in multiselect mode") if subset_name is not None: return self.subset._get_subset_state(subset_name) # guaranteed to only return a single entry because of check above return self.subset.selected_subset_state
[docs] def get_center(self, subset_name=None): """Return the center of the Subset. This may or may not be the centroid obtain from data. Parameters ---------- subset_name : str The name of the subset that is being updated. Returns ------- cen : number, tuple of numbers, or `None` The center of the Subset in ``x`` or ``(x, y)``, depending on the Subset type, if applicable. If Subset is not centerable, this returns `None`. """ # Composite region cannot be centered. if not self.is_centerable: # no-op return subset_state = self._get_subset_state(subset_name) return subset_state.center()
[docs] def set_center(self, new_cen, subset_name=None, update=False): """Set the desired center for the selected Subset, if applicable. If Subset is not centerable, nothing is done. Parameters ---------- new_cen : number or tuple of numbers The new center defined either as ``x`` or ``(x, y)``, depending on the Subset type. subset_name : str The name of the subset that is being updated. update : bool If `True`, the Subset is also moved to the new center. Otherwise, only the relevant editable fields are updated but the Subset is not moved. Raises ------ NotImplementedError Subset type is not supported. """ # Composite region cannot be centered, so just grab first element. if not self.is_centerable: # no-op return subset_state = self._get_subset_state(subset_name) if isinstance(subset_state, RoiSubsetState): x, y = new_cen # x and y are arrays so this converts them back to floats x = float(x) y = float(y) sbst_obj = subset_state.roi if isinstance(sbst_obj, (CircularROI, CircularAnnulusROI, EllipticalROI, RectangularROI)): # noqa sbst_obj.move_to(x, y) else: # pragma: no cover raise NotImplementedError(f'Recentering of {sbst_obj.__class__} is not supported') elif isinstance(subset_state, RangeSubsetState): subset_state.move_to(new_cen) else: # pragma: no cover raise NotImplementedError( f'Getting center of {subset_state.__class__} is not supported') if update: self._push_update_to_ui(subset_name=subset_name) else: # Force UI to update on browser without changing the subset. tmp = self.subset_definitions self.subset_definitions = [] self.subset_definitions = tmp
# List of JSON-like dict is nice for front-end but a pain to look up, # so we use these helper functions. def _get_value_from_subset_definition(self, index, name, desired_key): subset_definition = self.subset_definitions[index] value = None for item in subset_definition: if item['name'] == name: value = item[desired_key] break return value def _set_value_in_subset_definition(self, index, name, desired_key, new_value): for i in range(len(self.subset_definitions[index])): if self.subset_definitions[index][i]['name'] == name: self.subset_definitions[index][i]['value'] = new_value break @observe('subset_selected') def set_selected_subset_group(self, _): for subset_group in self.app.data_collection.subset_groups: if subset_group.label == self.subset.selected: self.selected_subset_group = subset_group break
[docs] def rename_subset(self, old_label, new_label): """ Method to rename an existing subset Parameters ---------- old_label : str The current label of the subset to be renamed. new_label : str The new label to apply to the selected subset. """ # will emit a SubsetRenameMessage and call _sync_available_from_state() self.app._rename_subset(old_label, new_label)
[docs] def vue_rename_subset(self, msg): try: self.rename_subset(msg['old_label'], msg['new_label']) except Exception as e: self.hub.broadcast(SnackbarMessage(f"Failed to rename subset: {repr(e)}", color='error', sender=self, traceback=e)) else: self.hub.broadcast(SnackbarMessage(f"Renamed '{msg['old_label']}' to '{msg['new_label']}'", # noqa color='info', sender=self))
[docs] def rename_selected(self, new_label): """ Method to rename the subset currently selected in the Subset Tools plugin. Parameters ---------- new_label : str The new label to apply to the selected subset. """ subset_group = self.selected_subset_group if subset_group is None: raise TypeError("current selection is not a subset") self.app._rename_subset(self.subset.selected, new_label, subset_group=subset_group) self._sync_available_from_state()
[docs] def delete_subset(self, subset_label): ''' Method to remove an existing subset from the app. Parameters ---------- subset_label : str The label of the subset to be deleted ''' self.app.delete_subsets(subset_labels=subset_label)
[docs] def vue_delete_subset(self, msg): self.delete_subset(msg['subset_label'])
[docs] def import_region(self, region, edit_subset=None, combination_mode=None, max_num_regions=20, refdata_label=None, return_bad_regions=False, region_format=None, subset_label=None): """ Method for creating subsets from regions or region files. Parameters ---------- region : region, list of region objects, or str A region object can be one of the following: * Astropy ``regions`` object * ``photutils`` apertures (limited support until ``photutils`` fully supports ``regions``) * specutils ``SpectralRegion`` object A string which represents a ``regions`` or ``SpectralRegion`` file. If given as a list, it can only contain spectral or non-spectral regions, not both. edit_subset : str or `None` Subset to have region applied to it using combination_mode combination_mode : list, str, or `None` The way that regions are created or combined. If a list, then it must be the same length as ``regions``. If `None`, then a new subset will be created. Options are ['new', 'replace', 'or', 'and', 'xor', 'andnot'] max_num_regions : int or `None` Maximum number of regions to load, starting from top of the list. Default is 20. If you want to load everything, set it to `None`. Loading a large number of regions is not recommended due to performance impact. refdata_label : str or `None` **This is only applicable to non-spectral regions.** Label of data to use for sky-to-pixel conversion for a region, or mask creation. Data must already be loaded into Jdaviz. If `None`, defaults to the reference data in the default viewer. Choice of this data is particularly important when sky region is involved. return_bad_regions : bool If `True`, return the regions that failed to load (see ``bad_regions``); This is useful for debugging. If `False`, do not return anything (`None`). region_format : str or `None` Passed to ``Regions.read(format=region_format)``. Only applicable if ``region`` is a string pointing to a valid file that ``Regions`` can read. subset_label : list, str, or `None` Label to apply to the resulting subset(s), replacing the default "Subset [N]" naming scheme. If multiple regions are input, this should be a list of strings with length matching the number of resulting subsets. Returns ------- bad_regions : list of (obj, str) or `None` If requested (see ``return_bad_regions`` option), return a list of ``(region, reason)`` tuples for region objects that failed to load. If all the regions loaded successfully, this list will be empty. If not requested, return `None`. """ if isinstance(region, str): if os.path.exists(region): from regions import Regions try: raw_regs = Regions.read(region, format=region_format) except Exception: # nosec raw_regs = SpectralRegion.read(region) return self._load_regions(raw_regs, edit_subset, combination_mode, max_num_regions, refdata_label, return_bad_regions, subset_label=subset_label) else: return self._load_regions(region, edit_subset, combination_mode, max_num_regions, refdata_label, return_bad_regions, subset_label=subset_label)
def _load_regions(self, regions, edit_subset=None, combination_mode=None, max_num_regions=None, refdata_label=None, return_bad_regions=False, subset_label=None, **kwargs): """Load given region(s) into the viewer. WCS-to-pixel translation and mask creation, if needed, is relative to the image defined by ``refdata_label``. Meanwhile, the rest of the Subset operations are based on reference image as defined by Glue. .. note:: Loading too many regions will affect performance. A valid region can be loaded into one of the following categories: * An interactive Subset, as if it was drawn by hand. This is always done for supported shapes. Its label will be ``'Subset N'``, where ``N`` is an integer. * A masked Subset that will display on the image but cannot be modified once loaded. This is done if the shape cannot be made interactive. Its label will be ``'MaskedSubset N'``, where ``N`` is an integer. Parameters ---------- regions : list of obj A list of region objects. A region object can be one of the following: * Astropy ``regions`` object * ``photutils`` apertures (limited support until ``photutils`` fully supports ``regions``) * specutils ``SpectralRegion`` object edit_subset : str or `None` Subset to have region applied to it using combination_mode combination_mode : list, str, or `None` The way that regions are created or combined. If a list, then it must be the same length as regions. Each element describes how the corresponding region in regions will be applied. If `None`, then a new subset will be created. Options are ['new', 'replace', 'or', 'and', 'xor', 'andnot'] max_num_regions : int or `None` Maximum number of regions to load, starting from top of the list. Default is to load everything. refdata_label : str or `None` Label of data to use for sky-to-pixel conversion for a region, or mask creation. Data must already be loaded into Jdaviz. If `None`, defaults to the reference data in the default viewer. Choice of this data is particularly important when sky region is involved. return_bad_regions : bool If `True`, return the regions that failed to load (see ``bad_regions``); This is useful for debugging. If `False`, do not return anything (`None`). subset_label : list, str, or `None` Label to apply to the resulting subset(s), replacing the default "Subset [N]" naming scheme. If multiple regions are input, this should be a list of strings with length matching the number of resulting subsets. kwargs : dict Extra keywords to be passed into the region's ``to_mask`` method. **This is ignored if the region can be made interactive.** Returns ------- bad_regions : list of (obj, str) or `None` If requested (see ``return_bad_regions`` option), return a list of ``(region, reason)`` tuples for region objects that failed to load. If all the regions loaded successfully, this list will be empty. If not requested, return `None`. """ if len(self.app.data_collection) == 0: raise ValueError('Cannot load regions without data.') if not isinstance(regions, (list, tuple, Regions, SpectralRegion)): regions = [regions] if isinstance(subset_label, (list, tuple)): if len(subset_label) > 1 and len(set(subset_label)) < len(subset_label): raise ValueError("Each subset label must be unique") elif isinstance(subset_label, str): subset_label = [subset_label] bad_labels = [] if subset_label is not None: for label in subset_label: if not self.app._check_valid_subset_label(label, raise_if_invalid=False): bad_labels.append(label) if len(bad_labels) > 0: raise ValueError(f"subset_label contained invalid labels: {bad_labels}") n_loaded = 0 bad_regions = [] # To keep track of masked subsets. msg_prefix = 'MaskedSubset' msg_count = _next_subset_num(msg_prefix, self.app.data_collection.subset_groups) viewer_parameter = kwargs.pop('viewer', None) viewer_name = viewer_parameter or list(self.app._jdaviz_helper.viewers.keys())[0] viewer = self.app.get_viewer(viewer_name) # Subset is global but reference data is viewer-dependent. if refdata_label is None and hasattr(viewer.state, 'reference_data'): data = viewer.state.reference_data elif refdata_label is not None: data = self.app.data_collection[refdata_label] elif len(viewer.layers): data = viewer.layers[0].layer else: raise ValueError('No reference data found in viewer.') has_wcs = data_has_valid_wcs(data, ndim=2) or data_has_valid_wcs(data, ndim=3) combo_mode_is_list = isinstance(combination_mode, list) if combo_mode_is_list and len(combination_mode) != (len(regions)): raise ValueError("list of mode must be size of regions") elif combo_mode_is_list: unknown_options = list(set(combination_mode) - set(COMBO_OPTIONS)) if len(unknown_options) > 0: raise ValueError(f"{unknown_options} not one of {COMBO_OPTIONS}") previous_mode = self.app.session.edit_subset_mode.mode previous_subset = self.app.session.edit_subset_mode.edit_subset with self.app._jdaviz_helper.batch_load(): # This method can edit a particular subset or create a new subset # and apply the combination modes depending on this argument if edit_subset and combination_mode is not None: self.subset.selected = edit_subset elif edit_subset and combination_mode is None: # If combination_mode is not set, assume the user # wants to update the subset in edit_subset self.subset.selected = edit_subset combination_mode = 'replace' else: # self.app.session.edit_subset_mode.edit_subset = None self.subset.selected = self.subset.default_text label_index = 0 for index, region in enumerate(regions): # Set combination mode for how region will be applied to current subset # or created as a new subset if combo_mode_is_list: combo_mode = combination_mode[index] else: combo_mode = combination_mode # Combination_mode should be 'new' if combo_mode is not set or explicitly 'new' if combo_mode == 'new' or combo_mode is None: self.combination_mode.selected = 'new' elif combo_mode: self.combination_mode.selected = combo_mode if (isinstance(region, (SkyCircularAperture, SkyEllipticalAperture, SkyRectangularAperture, SkyCircularAnnulus, CircleSkyRegion, EllipseSkyRegion, RectangleSkyRegion, CircleAnnulusSkyRegion)) and not has_wcs): bad_regions.append((region, 'Sky region provided but data has no valid WCS')) continue if (isinstance(region, (CircularAperture, EllipticalAperture, RectangularAperture, CircularAnnulus, CirclePixelRegion, EllipsePixelRegion, RectanglePixelRegion, CircleAnnulusPixelRegion)) and (hasattr(self.app, '_link_type') and self.app._link_type == "wcs")): bad_regions.append((region, 'Pixel region provided but data is aligned by WCS')) continue # photutils: Convert to region shape first if isinstance(region, (CircularAperture, SkyCircularAperture, EllipticalAperture, SkyEllipticalAperture, RectangularAperture, SkyRectangularAperture, CircularAnnulus, SkyCircularAnnulus)): region = aperture2regions(region) # region: Convert to ROI. # NOTE: Out-of-bounds ROI will succeed; this is native glue behavior. if (isinstance(region, (CirclePixelRegion, CircleSkyRegion, EllipsePixelRegion, EllipseSkyRegion, RectanglePixelRegion, RectangleSkyRegion, CircleAnnulusPixelRegion, CircleAnnulusSkyRegion))): try: if getattr(data.coords, 'world_n_dim', None) == 3: data_wcs = _get_celestial_wcs(data.coords) state = regions2roi(region, wcs=data_wcs) else: state = regions2roi(region, wcs=data.coords) except ValueError: if '_orig_spatial_wcs' not in data.meta: bad_regions.append((region, f'Failed to load: _orig_spatial_wcs' f' meta tag not in {data.label}')) continue state = regions2roi(region, wcs=data.meta['_orig_spatial_wcs']) viewer.apply_roi(state) elif isinstance(region, (CircularROI, CircularAnnulusROI, EllipticalROI, RectangularROI)): viewer.apply_roi(region) elif isinstance(region, SpectralRegion): # Use viewer_name if provided in kwarg, otherwise use # default spectrum viewer name range_viewer = self.app.get_viewer(viewer_parameter) if viewer_parameter else self.spectrum_viewer # noqa s = RangeSubsetState(lo=region.lower.value, hi=region.upper.value, att=range_viewer.state.x_att) range_viewer.apply_subset_state(s) # Last resort: Masked Subset that is static (if data is not a cube) elif data.ndim == 2: im = None if hasattr(region, 'to_pixel'): # Sky region: Convert to pixel region if not has_wcs: bad_regions.append((region, 'Sky region provided but data has no valid WCS')) # noqa continue region = region.to_pixel(data.coords) if hasattr(region, 'to_mask'): try: mask = region.to_mask(**kwargs) im = mask.to_image(data.shape) # Can be None except Exception as e: # pragma: no cover bad_regions.append((region, f'Failed to load: {repr(e)}')) continue # Boolean mask as input is supported but not advertised. elif (isinstance(region, np.ndarray) and region.shape == data.shape and region.dtype == np.bool_): im = region if im is None: bad_regions.append((region, 'Mask creation failed')) continue # NOTE: Region creation info is thus lost. try: mask_label = f'{msg_prefix} {msg_count}' state = MaskSubsetState(im, data.pixel_component_ids) self.app.data_collection.new_subset_group(mask_label, state) msg_count += 1 except Exception as e: # pragma: no cover bad_regions.append((region, f'Failed to load: {repr(e)}')) continue else: bad_regions.append((region, 'Mask creation failed')) continue n_loaded += 1 if max_num_regions is not None and n_loaded >= max_num_regions: break if self.combination_mode.selected in ('new', 'replace') and subset_label is not None: # noqa self.rename_selected(subset_label[label_index]) label_index += 1 # Revert edit mode and subset to before the import_region call self.app.session.edit_subset_mode.edit_subset = previous_subset self.app.session.edit_subset_mode.mode = previous_mode n_reg_in = len(regions) n_reg_bad = len(bad_regions) if n_loaded == 0: snack_color = "error" elif n_reg_bad > 0: snack_color = "warning" else: snack_color = "success" self.app.hub.broadcast(SnackbarMessage( f"Loaded {n_loaded}/{n_reg_in} regions, max_num_regions={max_num_regions}, " f"bad={n_reg_bad}", color=snack_color, traceback=[(str(bad_region[0]), bad_region[1]) for bad_region in bad_regions], timeout=8000, sender=self.app)) if return_bad_regions: return bad_regions @observe('combination_mode_selected') def _combination_mode_selected_updated(self, change): self.app.session.edit_subset_mode.mode = SUBSET_MODES_PRETTY[change['new']] def _update_combination_mode(self): if self.app.session.edit_subset_mode.mode in SUBSET_TO_PRETTY.keys(): self.combination_mode_selected = SUBSET_TO_PRETTY[ self.app.session.edit_subset_mode.mode]