diff --git a/docs/_static/portal_focus_exp1_fig1.png b/docs/_static/portal_focus_exp1_fig1.png new file mode 100644 index 0000000..c848785 Binary files /dev/null and b/docs/_static/portal_focus_exp1_fig1.png differ diff --git a/docs/_static/portal_focus_exp1_fig2.png b/docs/_static/portal_focus_exp1_fig2.png new file mode 100644 index 0000000..e67252b Binary files /dev/null and b/docs/_static/portal_focus_exp1_fig2.png differ diff --git a/docs/_static/portal_focus_exp2_fig1.png b/docs/_static/portal_focus_exp2_fig1.png new file mode 100644 index 0000000..cc49b7e Binary files /dev/null and b/docs/_static/portal_focus_exp2_fig1.png differ diff --git a/docs/_static/portal_focus_exp2_fig2.png b/docs/_static/portal_focus_exp2_fig2.png new file mode 100644 index 0000000..a5345c6 Binary files /dev/null and b/docs/_static/portal_focus_exp2_fig2.png differ diff --git a/docs/delegate-resources/getting-started.rst b/docs/delegate-resources/getting-started.rst index f999561..2dbe0df 100644 --- a/docs/delegate-resources/getting-started.rst +++ b/docs/delegate-resources/getting-started.rst @@ -91,13 +91,26 @@ Recordings are available for past seminars. .. _DP0-Delegate-Resources-Get-Started-Activities: -===================== -Additional activities -===================== +============================= +Participate in DP0 activities +============================= Inform improvements for the RSP ------------------------------- +**Participate in RSP usability testing.** +Work through a few of these :doc:`/delegate-resources/usability-exercises`, +which range from beginner- to advanced-level +and are designed to build new skills with the RSP. +Then provide feedback to Rubin Observatory via a designated :ref:`DP0-Delegate-Resources-Exercises-Form`. + +.. toctree:: + :maxdepth: 1 + :glob: + + usability-exercises + + **Participate in feedback surveys.** When requested, complete feedback surveys for Rubin Observatory. diff --git a/docs/delegate-resources/usability-exercises.rst b/docs/delegate-resources/usability-exercises.rst new file mode 100644 index 0000000..a258d42 --- /dev/null +++ b/docs/delegate-resources/usability-exercises.rst @@ -0,0 +1,255 @@ +###################### +RSP Feedback Exercises +###################### + +.. Review the README on instructions to contribute. +.. Review the style guide to keep a consistent approach to the documentation. +.. Static objects, such as figures, should be stored in the _static directory. Review the _static/README on instructions to contribute. +.. Do not remove the comments that describe each section. They are included to provide guidance to contributors. +.. Do not remove other content provided in the templates, such as a section. Instead, comment out the content and include comments to explain the situation. For example: + - If a section within the template is not needed, comment out the section title and label reference. Do not delete the expected section title, reference or related comments provided from the template. + - If a file cannot include a title (surrounded by ampersands (#)), comment out the title from the template and include a comment explaining why this is implemented (in addition to applying the ``title`` directive). + +.. This is the label that can be used for cross referencing this file. +.. Recommended title label format is "Directory Name"-"Title Name" -- Spaces should be replaced by hyphens. +.. _DP0-Delegate-Resources-Exercises: +.. Each section should include a label for cross referencing to a given area. +.. Recommended format for all labels is "Title Name"-"Section Name" -- Spaces should be replaced by hyphens. +.. To reference a label that isn't associated with an reST object such as a title or figure, you must include the link and explicit title using the syntax :ref:`link text `. +.. A warning will alert you of identical labels during the linkcheck process. + +.. This section should provide a brief, top-level description of the page. + +The following exercises are designed as a usability and functionality test +of the Portal Aspect of the Rubin Science Platform (RSP; +`data.lsst.cloud `_). +The goal is to understand how users interact with the Portal and identify +areas that may require improvement. +These exercises were also designed serve also as challenged-based +learning opportunities, complementary to the :ref:`DP0-Delegate-Resources-Get-Started-Docs-and-Tuts`. + +**Who can participate?** +Anyone with an RSP account at `data.lsst.cloud `_. + +**How to participate?** +There are six exercises to choose from, two each at the beginner, +intermediate, and experienced levels. +Choose an exercise (use the table of contents at upper right), +work through it, then complete the :ref:`DP0-Delegate-Resources-Exercises-Form`. +The entire process should not take more than 25 minutes per exercise, +and might be much faster depending on RSP experience. + +**Resources.** +First, try the exercise on its own, then use any of these resources +which are relevant. +The `DP0.2 documentation `_, +`DP0.2 schema browser `_, +and `DP0.2 Portal tutorials `_. +The `DP0.3 documentation `_, +`DP0.3 schema browser `_, +and `DP0.3 Portal tutorials `_. +The `Portal (Firefly) Help pages `_ (image display). + +**Answer key.** +In some cases, there are multiple ways to achieve a task in the RSP. +Find at least one demonstration per exercise in the +`Portal usability test answer key `_. + + +.. _DP0-Delegate-Resources-Exercises-Form: + +============= +Feedback form +============= + +Thank you for completing the form, your feedback is essential and will be +used by the Rubin Community Science Team (CST) to design processes to +scientifically validate the RSP and enhance user experience. + +The same form is used for all exercises. + +Each exercise should take no more than 20 minutes; if it is taking +longer, go to the feedback form and note that it couldn't be finished +in the time. + +The feedback form is not anonymous and collects email addresses, so that +CST members may follow up in some cases. + +Link to this form: `https://forms.gle/PdqNgW8ErV277tih9 `_. + + +.. _DP0-Delegate-Resources-Exercises-1: + +===================== +Exercise 1 (beginner) +===================== + +Navigate in a web browser to `data.lsst.cloud `_ +and log in to the Portal Aspect. + +Retrieve the ``g_psfFlux``, ``g_calibFlux``, and the ``g_extendedness`` columns +from the DP0.2 Object catalog for objects within 15 arcminutes of the galaxy cluster +at Right Ascension 55.75 degrees and Declination -32.27 degrees. +Plot the ``psfFlux`` vs. the ``calibFlux`` flux columns. +In the results table, impose a constraint to only plot objects with extendedness +equal to 1. +Change the plot symbols to open circles. + +**Reminder**: +If this task takes more than 20 minutes, please mark +it as "could not be completed" in the feedback form and indicate how far you got. + +:ref:`DP0-Delegate-Resources-Exercises-Form`. + + +.. _DP0-Delegate-Resources-Exercises-2: + +===================== +Exercise 2 (beginner) +===================== + +Create a ``g-r`` color vs. ``i`` magnitude diagram using the ``calibFlux`` columns in the DP0.2 Object catalog, +for all objects within 120 arcseconds of Right Ascension 60 degrees and Declination -35 degrees. +Zoom in on the clump of points with color values approximately in the range of -4 < ``g-r`` < 4. +Save the plot as a PNG file to your local computer. **Hint**: After retrieving the ``{band}_calibFlux`` columns, +use the expression ``(-2.5*log10({band}_calibFlux) + 31.4)`` to convert the fluxes in nanoJankys to magnitudes in the AB system. + +**Reminder**: +If this task takes more than 20 minutes, please mark +it as "could not be completed" in the feedback form and indicate how far you got. + +:ref:`DP0-Delegate-Resources-Exercises-Form` + +.. _DP0-Delegate-Resources-Exercises-3: + +========================= +Exercise 3 (intermediate) +========================= + +Retrieve the four DP0.2 processed visit images (PVI), also known as "calexp" images, obtained with LSST band ``i``, +before the date of ``MJD 59840``, whose boundaries contain the point with Right Ascension 55.75 degrees +and Declination -32.27 degrees. In the results view, choose the option to display the images in a grid. +Use the "Image center drop down" tool to center the first displayed image on the search coordinates. +Use the "Image alignment drop down" tool to align and lock all displayed images by the World Coordinate System (WCS) +and zoom-in 3 times. + +**Reminder**: +If this task takes more than 20 minutes, please mark +it as "could not be completed" in the feedback form and indicate how far you got. + +:ref:`DP0-Delegate-Resources-Exercises-Form` + +.. _DP0-Delegate-Resources-Exercises-4: + +========================= +Exercise 4 (intermediate) +========================= + +Use the ADQL interface to obtain, from the DP0.2 DiaSource table, an ``r``-band light curve for the Type Ia supernova +which has a ``diaObjectId`` of ``1250953961339360185``. Retrieve the ``r``-band fluxes and their errors derived from +a linear least-squares fit of a PSF model, and the effective mid-exposure time, for all ``diaSources`` associated +with this ``diaObjectId``. Plot the light curve as the flux as a function of time, with error bars associated with +each flux point. Change the plot style to use connected points, the point style to be red circles, and then sort the +results by ``midPointTai``. +Update the plot axes labels to be "PSF Difference-Image Flux" and "MJD of the Exposure Midpoint". +Save the plot as a PNG file to your local computer. + +**Hint**: In the ADQL query, the filter name will need to be +formatted as a string (e.g., ``'r'``). + +**Reminder**: +If this task takes more than 20 minutes, please mark +it as "could not be completed" in the feedback form and indicate how far you got. + +:ref:`DP0-Delegate-Resources-Exercises-Form` + +.. _DP0-Delegate-Resources-Exercises-5: + +======================== +Exercise 5 (experienced) +======================== + +The following figure, which corresponds to Figure 15 from the +`The LSST DESC DC2 Simulated Sky Survey `_ paper, +has three panels: the grid of tracts in the DC2 simulation area on the left, the image of tract ``3828`` on the center, +and a zoom-in image approximately centered near a particularly bright elongated galaxy on the right. +The galaxy is located at Right Ascension = 3h46m56.21s and Declination = -36d05m27.7s (EQ_J2000). + +.. figure:: /_static/portal_focus_exp1_fig1.png + :name: portal_focus_exp1_fig1 + :alt: A screenshot of Figure 15 from the "The LSST DESC DC2 Simulated Sky Survey" paper. + The figure has three panels from left to right: the grid of tracts in the DC2 simulation area on the left, + the image of tract ``3828`` on the center, and a zoom-in image approximately centered near a particularly + bright elongated galaxy on the right. + + Figure 15 from the "The LSST DESC DC2 Simulated Sky Survey" paper. + +Use the Portal Aspect of the RSP to reproduce the following figure, which shows an image of the same galaxy +in the ``r`` band, including: + +* The compass with cardinal points (N-E compass) +* The footprint of the Hubble Space Telescope Wide Field Camera 3 - Infrared channel (WFC3/IR) +* The extraction of a light profile of the galaxy. Save the light profile as a CSV file. + +**Hint**: Use a color stretch "Linear: Stretch -1 Sigma to 30 Sigma” to resemble the figure below. + +.. figure:: /_static/portal_focus_exp1_fig2.png + :name: portal_focus_exp1_fig2 + :alt: A screenshot of the Portal Aspect of the Rubin Science Platform with three panels, two on top + and one at the bottom. The top left panel displays the image of a galaxy from the DC2 simulation + in the `r` band. There is a red compass in the upper-left part of the panel, displaying the + cardinal directions. The footprint of the Hubble Space Telescope Wide Field Camera 3 - Infrared channel (WFC3/IR) + is overlayed as a square, and an extraction line crosses the galaxy from left to right. The top-right panel + shows a two-dimensional plot of flux in ADU vs offset in arcseconds, corresponding to the light profile + extracted from the galaxy by the line in the top-left panel. The bottom panel shows a table with + different objects from the image. + + Screenshot of a DC2 galaxy from the Portal Aspect of the RSP. + +**Reminder**: +If this task takes more than 20 minutes, please mark +it as "could not be completed" in the feedback form and indicate how far you got. + +:ref:`DP0-Delegate-Resources-Exercises-Form` + +.. _DP0-Delegate-Resources-Exercises-6: + +======================== +Exercise 6 (experienced) +======================== + +Query the DP0.2 Object catalog for the galaxy cluster around Right Ascension 3h43m00.00s and Declination -32d16m19.00s +to visualize the region where the cluster is and plot the "red sequence" in a color-magnitude diagram +(for example, ``r-i`` vs ``i``), as illustrated in the image below. + +.. figure:: /_static/portal_focus_exp2_fig1.png + :name: portal_focus_exp2_fig1 + :alt: A screenshot of the Portal Aspect of the Rubin Science Platform with two panels. + The left panel shows a galaxy cluster from the DC2 simulation and the right panel + plots the cluster "red sequence" as an "r-i" vs "i" color-magnitude plot. + + Screenshot of a DC2 galaxy from the Portal Aspect of the RSP. + +Then, select the points in the red sequence to highlight the cluster members in the image, as shown in the image below. + +.. figure:: /_static/portal_focus_exp2_fig2.png + :name: portal_focus_exp2_fig2 + :alt: A screenshot of the Portal Aspect of the Rubin Science Platform with two panels. + The left panel shows a galaxy cluster from the DC2 simulation with squares + identifying the cluster members explicitly, and the right panel + plots the cluster "red sequence" as an "r-i" vs "i" color-magnitude plot. + +**Hint 1**: use a search radius of 200 arcseconds. + +**Hint 2**: you can use the ``scisql_nanojanskyToAbMag`` SQL function to convert +fluxes to magnitudes (filter out negative fluxes before using the function). + +**Definition**: The red sequence in galaxy clusters refers to a tight correlation observed in color-magnitude diagrams, +where many of the galaxies in a cluster show a similar red color and brightness, +indicating they are older, more evolved galaxies with less star formation. + +**Reminder**: +If this task takes more than 20 minutes, please mark +it as "could not be completed" in the feedback form and indicate how far you got. + +:ref:`DP0-Delegate-Resources-Exercises-Form`