Cherry-picking from branch 15554. Pipe_tasks to numpydoc. Conflicts resolved.

Author: WERKSQUAD

python/lsst/pipe/tasks/calibrate.py

@@ -257,6 +257,9 @@ class CalibrateTask(pipeBase.CmdLineTask):
         sources and matches. See @ref lsst.meas.astrom.displayAstrometry for
         the meaning of the various symbols.
 
+
+    Examples
+    --------
     For example, put something like:
 
     .. code-block:: py
@@ -290,6 +293,35 @@ def DebugInfo(name):
 
     def __init__(self, butler=None, astromRefObjLoader=None,
                  photoRefObjLoader=None, icSourceSchema=None, **kwargs):
+        """Construct a CalibrateTask
+
+        Parameters
+        ----------
+        butler :
+            The butler is passed to the refObjLoader constructor
+            in case it is needed.  Ignored if the refObjLoader argument
+            provides a loader directly.
+        astromRefObjLoader :
+            An instance of LoadReferenceObjectsTasks
+            that supplies an external reference catalog for astrometric
+            calibration.  May be None if the desired loader can be constructed
+            from the butler argument or all steps requiring a reference catalog
+            are disabled.
+        photoRefObjLoader :
+            An instance of LoadReferenceObjectsTasks
+            that supplies an external reference catalog for photometric
+            calibration.  May be None if the desired loader can be constructed
+            from the butler argument or all steps requiring a reference catalog
+            are disabled.
+        icSourceSchema :
+            schema for icSource catalog, or None.
+            Schema values specified in config.icSourceFieldsToCopy will be
+            taken from this schema. If set to None, no values will be
+            propagated from the icSourceCatalog
+        kwargs :
+            other keyword arguments for
+            lsst.pipe.base.CmdLineTask
+        """
         pipeBase.CmdLineTask.__init__(self, **kwargs)
 
         if icSourceSchema is None and butler is not None:

python/lsst/pipe/tasks/characterizeImage.py

@@ -273,6 +273,25 @@ def DebugInfo(name):
     RunnerClass = pipeBase.ButlerInitializedTaskRunner
 
     def __init__(self, butler=None, refObjLoader=None, schema=None, **kwargs):
+        """Construct a CharacterizeImageTask
+
+        Parameters
+        ----------
+        butler :
+            A butler object is passed to the refObjLoader constructor in case
+            it is needed to load catalogs.  May be None if a catalog-based star selector is
+            not used, if the reference object loader constructor does not require a butler,
+            or if a reference object loader is passed directly via the refObjLoader argument.
+        refObjLoader :
+            An instance of LoadReferenceObjectsTasks that supplies an
+            external reference catalog to a catalog-based star selector.  May be None if a
+            catalog star selector is not used or the loader can be constructed from the
+            butler argument.
+        schema :
+            initial schema (an lsst.afw.table.SourceTable), or None
+        kwargs :
+            other keyword arguments for lsst.pipe.base.CmdLineTask
+        """
         pipeBase.CmdLineTask.__init__(self, **kwargs)
         if schema is None:
             schema = SourceTable.makeMinimalSchema()