Move ForcedPhotCoaddTask from meas_base

lsst · May 23, 2023 · b45607d · b45607d
1 parent e54da6c
commit b45607d
Show file tree

Hide file tree

Showing 5 changed files with 405 additions and 0 deletions.
diff --git a/doc/lsst.drp.tasks/tasks/lsst.meas.base.forcedPhotCoadd.ForcedPhotCoaddTask.rst b/doc/lsst.drp.tasks/tasks/lsst.meas.base.forcedPhotCoadd.ForcedPhotCoaddTask.rst
@@ -0,0 +1,49 @@
+.. lsst-task-topic:: lsst.drp.pipe.forcedPhotCoadd.ForcedPhotCoaddTask
+
+###################
+ForcedPhotCoaddTask
+###################
+
+``ForcedPhotCoaddTask`` performs forced measurement on a co-added image using as a reference catalog detections which were made on coadds in other bands.
+
+Butler datasets
+===============
+
+Input datasets
+--------------
+
+A ``Coadd_src`` variant (e.g. ``deepCoadd_src``)
+   Used as the reference catalog.
+   This is not loaded directly from the provided ``dataRef``; only the patch and tract are used, while the filter is set by the configuration of the references subtask.
+   See ``lsst.meas.base.references.CoaddSrcReferencesTask``.
+
+A ``Coadd_calexp`` variant (e.g. ``deepCoadd_calexp``)
+   Used as the measurement image.
+   Note that this means that :lsst-task:`lsst.pipe.tasks.multiBand.DetectCoaddSourcesTask` must have been run on the image previously.
+
+Ouptut datasets
+---------------
+
+A ``Coadd_forced_src`` variant (e.g. ``deepCoadd_forced_src``)
+   The resulting measurement catalog.
+
+.. _lsst.drp.pipe.forcedPhotCoadd.ForcedPhotCoaddTask-api:
+
+Python API summary
+==================
+
+.. lsst-task-api-summary:: lsst.meas.base.forcedPhotCoadd.ForcedPhotCoaddTask
+
+.. _lsst.drp.pipe.forcedPhotCoadd.ForcedPhotCoaddTask-subtasks:
+
+Retargetable subtasks
+=====================
+
+.. lsst-task-config-subtasks:: lsst.meas.base.forcedPhotCoadd.ForcedPhotCoaddTask
+
+.. _lsst.drp.pipe.forcedPhotCoadd.ForcedPhotCoaddTask-configs:
+
+Configuration fields
+====================
+
+.. lsst-task-config-fields:: lsst.meas.base.forcedPhotCoadd.ForcedPhotCoaddTask
diff --git a/python/lsst/__init__.py b/python/lsst/__init__.py
@@ -0,0 +1,2 @@
+import pkgutil
+__path__ = pkgutil.extend_path(__path__, __name__)
diff --git a/python/lsst/drp/__init__.py b/python/lsst/drp/__init__.py
@@ -0,0 +1,2 @@
+import pkgutil
+__path__ = pkgutil.extend_path(__path__, __name__)
diff --git a/python/lsst/drp/tasks/__init__.py b/python/lsst/drp/tasks/__init__.py
@@ -20,3 +20,5 @@
 # along with this program.  If not, see <https://www.gnu.org/licenses/>.
 
 from .version import *  # Generated by sconsUtils
+
+from .forcedPhotCoadd import *