spacetelescope · cshanahan1 · Nov 14, 2024 · Nov 6, 2024 · Nov 13, 2024 · Nov 13, 2024
@@ -62,6 +62,8 @@ Specviz2d
 
 Other Changes and Additions
 ---------------------------
+- Added a short description of each plugin in the side menu, visible before the plugin is opened. Removes redundant descriptions above link
+  out to documentation when plugin is opened. [#3268]
 
 4.0.1 (unreleased)
 ==================

@@ -2758,6 +2758,7 @@ def compose_viewer_area(viewer_area_items):
             self._application_handler._tools[name] = tool
 
         for name in config.get('tray', []):
+
             tray = tray_registry.members.get(name)
 
             tray_item_instance = tray.get('cls')(app=self, tray_instance=True)
@@ -2766,10 +2767,13 @@ def compose_viewer_area(viewer_area_items):
             # plugin itself
             tray_item_label = tray.get('label')
 
+            tray_item_description = tray_item_instance.plugin_description
+
             # NOTE: is_relevant is later updated by observing irrelevant_msg traitlet
             self.state.tray_items.append({
                 'name': name,
                 'label': tray_item_label,
+                'description': tray_item_description,
                 'is_relevant': len(tray_item_instance.irrelevant_msg) == 0,
                 'widget': "IPY_MODEL_" + tray_item_instance.model_id
             })

@@ -112,10 +112,17 @@
               <v-expansion-panels accordion multiple focusable flat tile v-model="state.tray_items_open">
                 <v-expansion-panel v-for="(trayItem, index) in state.tray_items" :key="index">
                   <div v-if="trayItem.is_relevant && trayItemVisible(trayItem, state.tray_items_filter)">
-                    <v-expansion-panel-header >
-                      <j-tooltip :tipid="trayItem.name">
-                        {{ trayItem.label }}
-                      </j-tooltip>
+                    <v-expansion-panel-header>
+                      <v-list-item style="display: grid; min-height: 6px">
+                        <v-list-item-title>
+                          <j-tooltip :tipid="trayItem.name">
+                            {{ trayItem.label }}
+                          </j-tooltip>
+                        </v-list-item-title>
+                        <v-list-item-subtitle style="white-space: normal; font-size: 8pt">
+                          {{ trayItem.description }}
+                        </v-list-item-subtitle>
+                      </v-list-item>
                     </v-expansion-panel-header>
                     <v-expansion-panel-content style="margin-left: -12px; margin-right: -12px;">
                       <jupyter-widget v-if="state.tray_items_open.includes(index)" :widget="trayItem.widget"></jupyter-widget>

@@ -91,6 +91,9 @@ class MomentMap(PluginTemplateMixin, DatasetSelectMixin, SpectralSubsetSelectMix
     def __init__(self, *args, **kwargs):
         super().__init__(*args, **kwargs)
 
+        # description displayed under plugin title in tray
+        self._plugin_description = 'Create a 2D image from a data cube.'
+
         self.moment = None
 
         self.continuum_dataset = DatasetSelect(self,

@@ -3,7 +3,7 @@
     :config="config"
     plugin_key="Moment Maps"
     :api_hints_enabled.sync="api_hints_enabled"
-    :description="docs_description || 'Create a 2D image from a data cube.'"
+    :description="docs_description"
     :link="docs_link || 'https://jdaviz.readthedocs.io/en/'+vdocs+'/'+config+'/plugins.html#moment-maps'"
     :uses_active_status="uses_active_status"
     @plugin-ping="plugin_ping($event)"

@@ -69,6 +69,10 @@ class Slice(PluginTemplateMixin):
 
     def __init__(self, *args, **kwargs):
         super().__init__(*args, **kwargs)
+
+        # description displayed under plugin title in tray
+        self._plugin_description = 'Select and interact with slice of cube in image viewers.'
+
         self._cached_properties = ['valid_selection_values', 'valid_selection_values_sorted',
                                    'valid_indicator_values', 'valid_indicator_values_sorted',
                                    'valid_values', 'valid_values_sorted']
@@ -103,6 +107,9 @@ def __init__(self, *args, **kwargs):
                                    handler=self._on_global_display_unit_changed)
         self._initialize_location()
 
+        self.docs_description = 'The slice can also be changed interactively\
+                                 in the spectrum viewer by activating the slice tool.'
+
     @property
     def _cube_viewer_default_label(self):
         if hasattr(self.app, '_jdaviz_helper') and self.app._jdaviz_helper is not None:

@@ -3,7 +3,7 @@
     :config="config"
     :plugin_key="plugin_key || 'Slice'"
     :api_hints_enabled.sync="api_hints_enabled"
-    :description="docs_description || 'Select slice of the cube to show in the image viewers.  The slice can also be changed interactively in the spectrum viewer by activating the slice tool.'"
+    :description="docs_description"
     :irrelevant_msg="irrelevant_msg"
     :link="docs_link || 'https://jdaviz.readthedocs.io/en/'+vdocs+'/'+config+'/plugins.html#slice'"
     :popout_button="popout_button"

@@ -124,6 +124,9 @@ class SpectralExtraction(PluginTemplateMixin, ApertureSubsetSelectMixin,
     def __init__(self, *args, **kwargs):
         super().__init__(*args, **kwargs)
 
+        # description displayed under plugin title in tray
+        self._plugin_description = 'Extract a spectrum from a spectral cube.'
+
         self.extracted_spec = None
 
         self.dataset.filters = ['is_flux_cube']

@@ -3,7 +3,7 @@
     :config="config"
     :plugin_key="plugin_key || 'Spectral Extraction'"
     :api_hints_enabled.sync="api_hints_enabled"
-    :description="docs_description || 'Extract a '+resulting_product_name+' from a spectral cube.'"
+    :description="docs_description"
     :link="docs_link || 'https://jdaviz.readthedocs.io/en/'+vdocs+'/'+config+'/plugins.html#spectral-extraction'"
     :uses_active_status="uses_active_status"
     @plugin-ping="plugin_ping($event)"

@@ -28,6 +28,9 @@ def __init__(self, *args, **kwargs):
         super().__init__(*args, **kwargs)
         self.jdaviz_version = __version__
 
+        # description displayed under plugin title in tray
+        self._plugin_description = 'Information about Jdaviz.'
+
         if __version__ != "unknown":
             _ver_pypi = latest_version_from_pypi("jdaviz")
             if _ver_pypi:

@@ -1,6 +1,6 @@
 <template>
   <j-tray-plugin
-    :description="docs_description || 'About Jdaviz.'"
+    :description="docs_description"
     :link="docs_link || 'https://jdaviz.readthedocs.io/en/'+vdocs+'/'"
     :popout_button="popout_button"
     :scroll_to.sync="scroll_to">

@@ -67,6 +67,9 @@ def __init__(self, *args, **kwargs):
             # on the user's machine, so export support in cubeviz should be disabled
             self.export_enabled = False
 
+        # description displayed under plugin title in tray
+        self._plugin_description = 'Collapse a spectral cube along one axis.'
+
     @property
     def _default_spectrum_viewer_reference_name(self):
         return self.jdaviz_helper._default_spectrum_viewer_reference_name

@@ -3,7 +3,7 @@
     :config="config"
     plugin_key="Collapse"
     :api_hints_enabled.sync="api_hints_enabled"
-    :description="docs_description || 'Collapse a spectral cube along one axis.'"
+    :description="docs_description"
     :link="docs_link || 'https://jdaviz.readthedocs.io/en/'+vdocs+'/'+config+'/plugins.html#collapse'"
     :popout_button="popout_button"
     :scroll_to.sync="scroll_to">

@@ -80,6 +80,10 @@ class DataQuality(PluginTemplateMixin, ViewerSelectMixin):
 
     def __init__(self, *args, **kwargs):
         super().__init__(*args, **kwargs)
+
+        # description displayed under plugin title in tray
+        self._plugin_description = 'Data Quality layer visualization options.'
+
         self.icons = {k: v for k, v in self.app.state.icons.items()}
 
         self.science_layer = LayerSelect(

@@ -3,7 +3,7 @@
     :config="config"
     plugin_key="Data Quality"
     :api_hints_enabled.sync="api_hints_enabled"
-    :description="docs_description || 'Data Quality layer visualization options.'"
+    :description="docs_description'"
     :link="docs_link || 'https://jdaviz.readthedocs.io/en/'+vdocs+'/'+config+'/plugins.html#data-quality'"
     @plugin-ping="plugin_ping($event)"
     :popout_button="popout_button">

@@ -16,6 +16,7 @@
 
 from jdaviz.core.events import AddDataMessage, SnackbarMessage
 from jdaviz.core.user_api import PluginUserApi
+
 from specutils import Spectrum1D
 from astropy import units as u
 from astropy.nddata import CCDData
@@ -115,6 +116,9 @@ def __init__(self, *args, **kwargs):
                                       'filename_auto',
                                       'filename_invalid_msg')
 
+        # description displayed under plugin title in tray
+        self._plugin_description = 'Export data/plots and other outputs to a file.'
+
         # NOTE: if adding export support for non-plugin products, also update the language
         # in the UI as well as in _set_dataset_not_supported_msg
         self.dataset.filters = ['is_not_wcs_only', 'not_child_layer',

@@ -3,7 +3,7 @@
     :config="config"
     plugin_key="Export"
     :api_hints_enabled.sync="api_hints_enabled"
-    description='Export data or plots from the app to a file.'
+    :description="docs_description"
     :link="docs_link || 'https://jdaviz.readthedocs.io/en/'+vdocs+'/'+config+'/plugins.html#export'"
     :popout_button="popout_button"
     :scroll_to.sync="scroll_to">

@@ -75,6 +75,9 @@ def __init__(self, *args, **kwargs):
         # set the filter on the dataset and viewer options
         self._update_dataset_viewer_filters()
 
+        # description displayed under plugin title in tray
+        self._plugin_description = 'Smooth data with a Gaussian kernel.'
+
     @property
     def _default_spectrum_viewer_reference_name(self):
         return getattr(

@@ -3,7 +3,7 @@
     :config="config"
     plugin_key="Gaussian Smooth"
     :api_hints_enabled.sync="api_hints_enabled"
-    :description="docs_description || 'Smooth data with a Gaussian kernel.'"
+    :description="docs_description"
     :link="docs_link || 'https://jdaviz.readthedocs.io/en/'+vdocs+'/'+config+'/plugins.html#gaussian-smooth'"
     :popout_button="popout_button"
     :scroll_to.sync="scroll_to">

@@ -126,6 +126,9 @@ def __init__(self, *args, **kwargs):
 
         self._disable_if_no_data()
 
+        # description displayed under plugin title in tray
+        self._plugin_description = 'Plot spectral lines from preset or custom line lists.'
+
     @property
     def _default_spectrum_viewer_reference_name(self):
         return getattr(

@@ -1,6 +1,6 @@
 <template>
   <j-tray-plugin
-    :description="docs_description || 'Plot lines from preset or custom line lists.'"
+    :description="docs_description"
     :link="docs_link || 'https://jdaviz.readthedocs.io/en/'+vdocs+'/'+config+'/plugins.html#line-lists'"
     :disabled_msg="disabled_msg"
     :popout_button="popout_button"

@@ -96,6 +96,15 @@ def __init__(self, *args, **kwargs):
         self.hub.subscribe(self, RemoveDataMessage,
                            handler=lambda msg: self._recompute_mark_positions(msg.viewer))
 
+        self.docs_description = "Press 'm' with the cursor over a viewer to log\
+                                the mouseover information. To change the\
+                                selected layer, click the layer cycler in the\
+                                mouseover information section of the app-level\
+                                toolbar."
+
+        # description displayed under plugin title in tray
+        self._plugin_description = 'Create markers on viewers.'
+
     def _create_viewer_callbacks(self, viewer):
         if not self.is_active:
             return

@@ -2,7 +2,7 @@
   <j-tray-plugin
     :config="config"
     plugin_key="Markers"
-    :description="docs_description || 'Create and export markers.  Press m with the cursor over a viewer to log the mouseover information.  To change the selected layer, click the layer cycler in the mouseover information section of the app-level toolbar.'"
+    :description="docs_description"
     :link="docs_link || 'https://jdaviz.readthedocs.io/en/'+vdocs+'/'+config+'/plugins.html#markers'"
     :uses_active_status="uses_active_status"
     @plugin-ping="plugin_ping($event)"

@@ -17,7 +17,7 @@ class MetadataViewer(PluginTemplateMixin, DatasetSelectMixin):
     :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.open_in_tray`
     * :meth:`~jdaviz.core.template_mixin.PluginTemplateMixin.close_in_tray`
     * ``dataset`` (:class:`~jdaviz.core.template_mixin.DatasetSelect`):
       Dataset to expose the metadata.
@@ -42,6 +42,9 @@ def __init__(self, *args, **kwargs):
         # override the default filters on dataset entries to require metadata in entries
         self.dataset.add_filter('not_from_plugin')
 
+        # description displayed under plugin title in tray
+        self._plugin_description = 'View metadata.'
+
     @property
     def user_api(self):
         return PluginUserApi(self, expose=('dataset', 'show_primary'), readonly=('metadata',))

@@ -3,7 +3,7 @@
     :config="config"
     plugin_key="Metadata"
     :api_hints_enabled.sync="api_hints_enabled"
-    :description="docs_description || 'View metadata.'"
+    :description="docs_description"
     :link="docs_link || 'https://jdaviz.readthedocs.io/en/'+vdocs+'/'+config+'/plugins.html#metadata-viewer'"
     :popout_button="popout_button"
     :scroll_to.sync="scroll_to">

@@ -120,6 +120,9 @@ def __init__(self, *args, **kwargs):
         self._initialized_models = {}
         self._display_order = False
 
+        # description displayed under plugin title in tray
+        self._plugin_description = 'Fit an analytic model to data or a subset of data.'
+
         # create the label first so that when model_component defaults to the first selection,
         # the label automatically defaults as well
         self.model_component_label = AutoTextField(self, 'comp_label', 'comp_label_default',

@@ -3,7 +3,7 @@
     :config="config"
     plugin_key="Model Fitting"
     :api_hints_enabled.sync="api_hints_enabled"
-    :description="docs_description || 'Fit an analytic model to data or a subset.'"
+    :description="docs_description"
     :link="docs_link || 'https://jdaviz.readthedocs.io/en/'+vdocs+'/'+config+'/plugins.html#model-fitting'"
     :popout_button="popout_button"
     :scroll_to.sync="scroll_to">

@@ -378,6 +378,10 @@ class PlotOptions(PluginTemplateMixin, ViewerSelectMixin):
 
     def __init__(self, *args, **kwargs):
         super().__init__(*args, **kwargs)
+
+        # description displayed under plugin title in tray
+        self._plugin_description = 'Set viewer and layer data options.'
+
         self.layer = LayerSelect(self, 'layer_items', 'layer_selected',
                                  'viewer_selected', 'layer_multiselect')
 

@@ -3,7 +3,7 @@
     :config="config"
     plugin_key="Plot Options"
     :api_hints_enabled.sync="api_hints_enabled"
-    :description="docs_description || 'Viewer and data/layer options.'"
+    :description="docs_description"
     :link="docs_link || 'https://jdaviz.readthedocs.io/en/'+vdocs+'/'+config+'/plugins.html#plot-options'"
     :uses_active_status="uses_active_status"
     @plugin-ping="plugin_ping($event)"

@@ -108,6 +108,15 @@ class SubsetPlugin(PluginTemplateMixin, DatasetSelectMixin):
     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.'
+
         self.components = {
             'g-subset-mode': SelectionModeMenu(session=self.session)
         }

@@ -1,6 +1,6 @@
 <template>
   <j-tray-plugin
-    :description="docs_description || 'Tools for selecting and interacting with subsets.'"
+    :description="docs_description"
     :link="docs_link || 'https://jdaviz.readthedocs.io/en/'+vdocs+'/'+config+'/plugins.html#subset-tools'"
     :popout_button="popout_button"
     :scroll_to.sync="scroll_to">

@@ -85,6 +85,9 @@ class SimpleAperturePhotometry(PluginTemplateMixin, ApertureSubsetSelectMixin,
     def __init__(self, *args, **kwargs):
         super().__init__(*args, **kwargs)
 
+        # description displayed under plugin title in tray
+        self._plugin_description = 'Perform aperture photometry for drawn regions.'
+
         self.background = SubsetSelect(self,
                                        'background_items',
                                        'background_selected',
@@ -104,6 +107,9 @@ def __init__(self, *args, **kwargs):
         self.table.headers_avail = headers
         self.table.headers_visible = headers
 
+        # description displayed under plugin title in tray
+        self.plugin_description = 'Perform aperture photometry for drawn regions.'
+
         self.plot_types = ["Curve of Growth", "Radial Profile", "Radial Profile (Raw)"]
         self.current_plot_type = self.plot_types[0]
         self._fitted_model_name = 'phot_radial_profile'

@@ -1,6 +1,6 @@
 <template>
   <j-tray-plugin
-    :description="docs_description || 'Perform aperture photometry for drawn regions.'"
+    :description="docs_description"
     :link="docs_link || 'https://jdaviz.readthedocs.io/en/'+vdocs+'/'+config+'/plugins.html#aperture-photometry'"
     :uses_active_status="uses_active_status"
     @plugin-ping="plugin_ping($event)"