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

Documentation and technical debt in meas_base/PixelFlags.cc

    XMLWordPrintable

    Details

    • Story Points:
      3
    • Team:
      Data Release Production

      Description

      The port from HSC of SafeClipAssembleCoaddTask has left some documentation and code quality changes to be made. Specifics include:

      • In the process of porting, functionality was added which allowed users to specify additional mask planes to be converted to pixel flags. However this was fundamentally incompatible with the flag handler functionality that LSST was currently using. PixelFlags was thus modified to allow SafeClipAssemble coadd to work with the user defined masks, but that made it fundamentally different than the other plugins. In the future this plugin should be brought more in line with all the other measurement framework. This will most likely involve rewriting sections of the measurement framework, to add the ability for users to more directly set runtime behaviors of the measurement plugins (such as specifying non default mask planes to work with).
      • Because PixelFlags could no longer use the the flag handler framework, sections of the SafeCentroidExtractor had to be duplicated within PixelFlags. This duplicated code is non-ideal and should be rectified. Possibly in the process of rewriting the measurement framework, the utils could be expanded to have convenience methods to access functionality when not using flag handlers
      • As with all of the measurement framework, PixelFlags needs better documentation. This includes some line to line comments, but more importantly the over all functionality of the routine needs documentation. This includes: what the routine does; how it works; and why various design decisions were made

        Attachments

          Issue Links

            Activity

            Hide
            swinbank John Swinbank added a comment -

            Reviewed for the DM-CCB, 2019-09-04. This ticket still seems relevant, although low priority. We should take heed of it when discussing a potential future measurement framework redesign.

            Show
            swinbank John Swinbank added a comment - Reviewed for the DM-CCB, 2019-09-04. This ticket still seems relevant, although low priority. We should take heed of it when discussing a potential future measurement framework redesign.
            Hide
            Parejkoj John Parejko added a comment -

            Since I was just wondering what the difference between e.g. "interpolated" and "interpolatedCenter" was, as part of this documentation, we need to propagate up the chain the flag doc strings (e.g. to the database schemas) and clarify them. For example, apparently all the "*Center" flags mean "within a 3x3 box around the centroid", per PixelFlags.cc:186): that should be made explicit in the docs.

            Show
            Parejkoj John Parejko added a comment - Since I was just wondering what the difference between e.g. "interpolated" and "interpolatedCenter" was, as part of this documentation, we need to propagate up the chain the flag doc strings (e.g. to the database schemas) and clarify them. For example, apparently all the "*Center" flags mean "within a 3x3 box around the centroid", per PixelFlags.cc:186 ): that should be made explicit in the docs.

              People

              Assignee:
              Parejkoj John Parejko
              Reporter:
              nlust Nate Lust
              Watchers:
              Eric Bellm, Jim Bosch, John Parejko, John Swinbank, Nate Lust
              Votes:
              0 Vote for this issue
              Watchers:
              5 Start watching this issue

                Dates

                Created:
                Updated:

                  Jenkins

                  No builds found.