Deprecate repeated functions in stcal

[stscijirahub]

Issue JP-4216 was created on JIRA by Timothy Brandt:

Several functions in stcal are unused or are effectively duplicates of functions elsewhere:

outlier_detection.utils.calc_gwcs_pixmap is effectively a duplicate of drizzle.utils.calc_pixmap

outlier_detection.utils.resample is used only by outlier_detection.utils.calc_gwcs_pixmap

alignment.resample_utils.calc_pixmap is effectively a duplicate of drizzle.utils.calc_pixmap and does not seem to be used anyway

alignment.util.reproject is effectively a duplicate of outlier_detection.utils.reproject, and does not appear to be used outside of alignment.resample_utils.calc_pixmap

All will be deprecated.  The calc_pixmap and calc_gwcs_pixmap functions will be mostly removed with only a line to use the drizzle version instead.

[stscijirahub]

Comment by Timothy Brandt on JIRA:

Note related issue spacetelescope/stcal#347

[stscijirahub]

Comment by Timothy Brandt on JIRA:

Proposed resolution: spacetelescope/stcal#485

[stscijirahub]

Comment by Timothy Brandt on JIRA:

Change of plans: spacetelescope/stcal#485 has been withdrawn in favor of https://github.com/spacetelescope/stcal/pull/488].  This will remove both instances of reproject and remove one instance of calc_pixmap.  A single instance of calc_pixmap matching the code in drizzle (though with the ability to interpolate between a sparsely evaluated grid of pixel transformations) will live in alignment and will be called by both resample and outlier_detection.  Future work can match the version of calc_pixmap in stcal with that in drizzle to enable a single function used by both.