Uploaded image for project: 'Data Management'
  1. Data Management
  2. DM-7950

Display of upper limits in WISE light curves in LSST portal

    XMLWordPrintable

    Details

    • Story Points:
      6
    • Sprint:
      SUIT Sprint 2018-04, SUIT Sprint 2018-05
    • Team:
      Science User Interface

      Description

      When preparing the light curve viewer for the WISE MEP table (roughly equivalent to the LSST ForcedSource), it is important to be aware of the precise definitions of the magnitude and magnitude-error columns in the table.

      w1mpro_ep: Single-exposure W1 profile-fit magnitude, or the magnitude of the 95% confidence brightness upper limit if the W1 flux measurement has SNR<2. This column is null if no useful flux measurement could be made on this frame, or if the W1 frame was not used in the Multiframe processing.

      w1sigmpro_ep: Single-exposure W1 profile-fit photometric measurement uncertainty in mag units. This column is null if the W1 profile-fit magnitude is a 95% confidence upper limit or if the W1 frame was not use in the Multiframe processing.

      (Similar considerations apply for w2*, w3*, and w4*.)

      When displaying this data in a time-series plot or other x-y plot, it would be very helpful to the science user if the plot symbol allowed the user to understand whether the w1mpro_ep value is a measurement or upper limit.

      This could be minimally accomplished by ensuring that error bars (based on w1sigmpro_ep) are always displayed when available – and with the display of an error bar suppressed when the value in that column is null. In this case the absence of an error bar would be a cue to the user that the plotted value is an upper limit. While this preserves the available information, it requires the user to be aware of the WISE convention - it's not a universal one.

      Therefore, it would be significantly preferable if we established a convention of a plot symbol to be used for upper limits, so that they remain intelligible even when the display of error bars is turned off. I would suggest that appropriate choices for upper limit symbols would be either a triangle or a "T" symbol, with the point of the triangle / stem of the "T" facing in the direction of fainter magnitudes (i.e., larger actual values of the variable). This convention could then also be used in general x-y plots, not just in time series.

      It may also be useful to consider whether in table displays a visual cue could be provided to the user that a value shown is an upper limit.

      When the value displayed is not a magnitude, but a flux (e.g., w1flux_ep), the AllWISE processing returns the actual best-fit value in all cases, which can therefore be a negative number for sources that are near or below the detection threshold for an image. Thus, for fluxes, no upper-limit symbol is required. The display of error bars (e.g., based on w1sigflux_ep) is essential for these negative values to be intelligible to scientific users.

        Attachments

          Issue Links

            Activity

            Hide
            gpdf Gregory Dubois-Felsmann added a comment -

            This ticket captures discussions following the SUIT team group meeting this afternoon.

            Show
            gpdf Gregory Dubois-Felsmann added a comment - This ticket captures discussions following the SUIT team group meeting this afternoon.
            Hide
            ejoliet Emmanuel Joliet added a comment - - edited

            We can add a custom marker/symbol to XYplot using highchart svg renderer and custom path command to build a 'T' for example:

            // Define a custom symbol path that would represent a 'T'
            Highcharts.SVGRenderer.prototype.symbols.upperLimit = function (x, y, w, h) {
                return ['M',x,y, 'L', x + w, y, 'M', x+w/2, y, 'L', x + w / 2, y+h, 'z'];
            };
            if (Highcharts.VMLRenderer) {
                Highcharts.VMLRenderer.prototype.symbols.upperLimit = Highcharts.SVGRenderer.prototype.symbols.upperLimit;
            }
            

            Then when calling the chart, we can specify the symbol 'T' such as:

            series: [{
                        name: 'w1sigmpro_ep',
                        marker: {
                            symbol: 'triangle'
                        },
                        data: [7.0, 6.9, 9.5, 14.5, null, 21.5, 25.2, 26.5, 23.3, 18.3, 13.9, 9.6]
             
                    }, {
                        name: 'w1mpro_ep',
                        marker: {
                            symbol: 'triangle'
                        },
                        data: [3.8, 4.2, 5.7, 8.5, {
                            y: 3456.7,
                            marker: {
                                symbol: 'upperLimit'
                            }
                        }, 15.2, 17.0, 16.6, 14.2, 10.3, 6.6, 4.8]
                    }]
            

            Show
            ejoliet Emmanuel Joliet added a comment - - edited We can add a custom marker/symbol to XYplot using highchart svg renderer and custom path command to build a 'T' for example: // Define a custom symbol path that would represent a 'T' Highcharts.SVGRenderer.prototype.symbols.upperLimit = function (x, y, w, h) { return [ 'M' ,x,y, 'L' , x + w, y, 'M' , x+w/2, y, 'L' , x + w / 2, y+h, 'z' ]; }; if (Highcharts.VMLRenderer) { Highcharts.VMLRenderer.prototype.symbols.upperLimit = Highcharts.SVGRenderer.prototype.symbols.upperLimit; } Then when calling the chart, we can specify the symbol 'T' such as: series: [{ name: 'w1sigmpro_ep' , marker: { symbol: 'triangle' }, data: [7.0, 6.9, 9.5, 14.5, null , 21.5, 25.2, 26.5, 23.3, 18.3, 13.9, 9.6]   }, { name: 'w1mpro_ep' , marker: { symbol: 'triangle' }, data: [3.8, 4.2, 5.7, 8.5, { y: 3456.7, marker: { symbol: 'upperLimit' } }, 15.2, 17.0, 16.6, 14.2, 10.3, 6.6, 4.8] }]
            Show
            tatianag Tatiana Goldina added a comment - https://github.com/Caltech-IPAC/firefly/pull/615

              People

              Assignee:
              tatianag Tatiana Goldina
              Reporter:
              gpdf Gregory Dubois-Felsmann
              Reviewers:
              Loi Ly
              Watchers:
              David Shupe, Emmanuel Joliet, Gregory Dubois-Felsmann, Loi Ly, Tatiana Goldina, Trey Roby
              Votes:
              0 Vote for this issue
              Watchers:
              6 Start watching this issue

                Dates

                Created:
                Updated:
                Resolved:

                  Jenkins

                  No builds found.