lsst-pipe-base 30.2026.300__py3-none-any.whl → 30.2026.500__py3-none-any.whl

lsst/pipe/base/connectionTypes.py

@@ -41,35 +41,36 @@ from lsst.utils.introspection import find_outside_stacklevel
 
 @dataclasses.dataclass(frozen=True)
 class BaseConnection:
-    """Base class used for declaring `PipelineTask` connections.
-
-    Attributes
-    ----------
-    name : `str`
-        The name used to identify the dataset type.
-    storageClass : `str`
-        The storage class used when (un)/persisting the dataset type.
-    multiple : `bool`
-        Indicates if this connection should expect to contain multiple objects
-        of the given dataset type.  Tasks with more than one connection with
-        ``multiple=True`` with the same dimensions may want to implement
-        `.PipelineTaskConnections.adjustQuantum` to ensure those datasets are
-        consistent (i.e. zip-iterable) in `PipelineTask.runQuantum()` and
-        notify the execution system as early as possible of outputs that will
-        not be produced because the corresponding input is missing.
-    deprecated : `str`, optional
-        A description of why this connection is deprecated, including the
-        version after which it may be removed.
-
-        If not `None`, the string is appended to the docstring for this
-        connection and the corresponding config Field.
-    """
+    """Base class used for declaring `PipelineTask` connections."""
 
     name: str
+    """The name used to identify the dataset type."""
+
     storageClass: str
+    """The storage class used when (un)/persisting the dataset type."""
+
     doc: str = ""
+    """Documentation for this connection."""
+
     multiple: bool = False
+    """Indicates if this connection should expect to contain multiple objects
+    of the given dataset type.
+
+    Tasks with more than one connection with ``multiple=True`` with the same
+    dimensions may want to implement `.PipelineTaskConnections.adjustQuantum`
+    to ensure those datasets are consistent (i.e. zip-iterable) in
+    `PipelineTask.runQuantum()` and notify the execution system as early as
+    possible of outputs that will not be produced because the corresponding
+    input is missing.
+    """
+
     deprecated: str | None = dataclasses.field(default=None, kw_only=True)
+    """A description of why this connection is deprecated, including the
+    version after which it may be removed.
+
+    If not `None`, the string is appended to the docstring for this
+    connection and the corresponding config Field.
+    """
 
     _connection_type_set: ClassVar[str]
     _deprecation_context: str = ""
@@ -110,32 +111,15 @@ class BaseConnection:
 class DimensionedConnection(BaseConnection):
     """Class used for declaring PipelineTask connections that includes
     dimensions.
-
-    Attributes
-    ----------
-    name : `str`
-        The name used to identify the dataset type.
-    storageClass : `str`
-        The storage class used when (un)/persisting the dataset type.
-    multiple : `bool`
-        Indicates if this connection should expect to contain multiple objects
-        of the given dataset type.  Tasks with more than one connection with
-        ``multiple=True`` with the same dimensions may want to implement
-        `.PipelineTaskConnections.adjustQuantum` to ensure those datasets are
-        consistent (i.e. zip-iterable) in `PipelineTask.runQuantum` and notify
-        the execution system as early as possible of outputs that will not be
-        produced because the corresponding input is missing.
-    dimensions : iterable of `str`
-        The `lsst.daf.butler.Butler` `lsst.daf.butler.Registry` dimensions used
-        to identify the dataset type identified by the specified name.
-    isCalibration : `bool`, optional
-        `True` if this dataset type may be included in CALIBRATION-type
-        collections to associate it with a validity range, `False` (default)
-        otherwise.
     """
 
     dimensions: Iterable[str] = ()
+    """The keys of the butler data coordinates for this dataset type."""
+
     isCalibration: bool = False
+    """ `True` if this dataset type may be included in
+    `~lsst.daf.butler.CollectionType.CALIBRATION` collections to associate it
+    with a validity range, `False` (default) otherwise."""
 
     def __post_init__(self):
         super().__post_init__()
@@ -151,39 +135,6 @@ class DimensionedConnection(BaseConnection):
 class BaseInput(DimensionedConnection):
     """Class used for declaring PipelineTask input connections.
 
-    Attributes
-    ----------
-    name : `str`
-        The default name used to identify the dataset type.
-    storageClass : `str`
-        The storage class used when (un)/persisting the dataset type.
-    multiple : `bool`
-        Indicates if this connection should expect to contain multiple objects
-        of the given dataset type.  Tasks with more than one connection with
-        ``multiple=True`` with the same dimensions may want to implement
-        `.PipelineTaskConnections.adjustQuantum` to ensure those datasets are
-        consistent (i.e. zip-iterable) in `PipelineTask.runQuantum` and notify
-        the execution system as early as possible of outputs that will not be
-        produced because the corresponding input is missing.
-    dimensions : iterable of `str`
-        The `lsst.daf.butler.Butler` `lsst.daf.butler.Registry` dimensions used
-        to identify the dataset type identified by the specified name.
-    deferLoad : `bool`
-        Indicates that this dataset type will be loaded as a
-        `lsst.daf.butler.DeferredDatasetHandle`. PipelineTasks can use this
-        object to load the object at a later time.
-    minimum : `bool`
-        Minimum number of datasets required for this connection, per quantum.
-        This is checked in the base implementation of
-        `.PipelineTaskConnections.adjustQuantum`, which raises `NoWorkFound` if
-        the minimum is not met for `Input` connections (causing the quantum to
-        be pruned, skipped, or never created, depending on the context), and
-        `FileNotFoundError` for `PrerequisiteInput` connections (causing
-        QuantumGraph generation to fail).  `PipelineTask` implementations may
-        provide custom `~.PipelineTaskConnections.adjustQuantum`
-        implementations for more fine-grained or configuration-driven
-        constraints, as long as they are compatible with this minium.
-
     Raises
     ------
     TypeError
@@ -194,7 +145,24 @@ class BaseInput(DimensionedConnection):
     """
 
     deferLoad: bool = False
+    """Whether this dataset type will be loaded as a
+    `lsst.daf.butler.DeferredDatasetHandle`. PipelineTasks can use this
+    object to load the object at a later time.
+    """
+
     minimum: int = 1
+    """Minimum number of datasets required for this connection, per quantum.
+
+    This is checked in the base implementation of
+    `.PipelineTaskConnections.adjustQuantum`, which raises `NoWorkFound` if the
+    minimum is not met for `Input` connections (causing the quantum to be
+    pruned, skipped, or never created, depending on the context), and
+    `FileNotFoundError` for `PrerequisiteInput` connections (causing
+    QuantumGraph generation to fail).  `PipelineTask` implementations may
+    provide custom `~.PipelineTaskConnections.adjustQuantum` implementations
+    for more fine-grained or configuration-driven constraints, as long as they
+    are compatible with this minimum.
+    """
 
     def __post_init__(self) -> None:
         super().__post_init__()
@@ -206,56 +174,6 @@ class BaseInput(DimensionedConnection):
 class Input(BaseInput):
     """Class used for declaring PipelineTask input connections.
 
-    Attributes
-    ----------
-    name : `str`
-        The default name used to identify the dataset type.
-    storageClass : `str`
-        The storage class used when (un)/persisting the dataset type.
-    multiple : `bool`
-        Indicates if this connection should expect to contain multiple objects
-        of the given dataset type.  Tasks with more than one connection with
-        ``multiple=True`` with the same dimensions may want to implement
-        `.PipelineTaskConnections.adjustQuantum` to ensure those datasets are
-        consistent (i.e. zip-iterable) in `PipelineTask.runQuantum` and notify
-        the execution system as early as possible of outputs that will not be
-        produced because the corresponding input is missing.
-    dimensions : iterable of `str`
-        The `lsst.daf.butler.Butler` `lsst.daf.butler.Registry` dimensions used
-        to identify the dataset type identified by the specified name.
-    deferLoad : `bool`
-        Indicates that this dataset type will be loaded as a
-        `lsst.daf.butler.DeferredDatasetHandle`. PipelineTasks can use this
-        object to load the object at a later time.
-    minimum : `bool`
-        Minimum number of datasets required for this connection, per quantum.
-        This is checked in the base implementation of
-        `.PipelineTaskConnections.adjustQuantum`, which raises `NoWorkFound` if
-        the minimum is not met for `Input` connections (causing the quantum to
-        be pruned, skipped, or never created, depending on the context), and
-        `FileNotFoundError` for `PrerequisiteInput` connections (causing
-        QuantumGraph generation to fail).  `PipelineTask` implementations may
-        provide custom `~.PipelineTaskConnections.adjustQuantum`
-        implementations for more fine-grained or configuration-driven
-        constraints, as long as they are compatible with this minium.
-    deferGraphConstraint : `bool`, optional
-        If `True`, do not include this dataset type's existence in the initial
-        query that starts the QuantumGraph generation process.  This can be
-        used to make QuantumGraph generation faster by avoiding redundant
-        datasets, and in certain cases it can (along with careful attention to
-        which tasks are included in the same QuantumGraph) be used to work
-        around the QuantumGraph generation algorithm's inflexible handling of
-        spatial overlaps.  This option has no effect when the connection is not
-        an overall input of the pipeline (or subset thereof) for which a graph
-        is being created, and it never affects the ordering of quanta.
-    deferBinding : `bool`, optional
-        If `True`, the dataset will not be automatically included in
-        the pipeline graph, ``deferGraphConstraint`` is implied.
-        The custom QuantumGraphBuilder is required to bind it and add a
-        corresponding edge to the pipeline graph.
-        This option allows to have the same dataset type as both
-        input and output of a quantum.
-
     Raises
     ------
     TypeError
@@ -266,8 +184,27 @@ class Input(BaseInput):
     """
 
     deferGraphConstraint: bool = False
+    """If `True`, do not include this dataset type's existence in the initial
+    query that starts the QuantumGraph generation process.
+
+    This can be used to make QuantumGraph generation faster by avoiding
+    redundant datasets, and in certain cases it can (along with careful
+    attention to which tasks are included in the same QuantumGraph) be used to
+    work around the QuantumGraph generation algorithm's inflexible handling of
+    spatial overlaps.  This option has no effect when the connection is not an
+    overall input of the pipeline (or subset thereof) for which a graph is
+    being created, and it never affects the ordering of quanta.
+    """
 
     deferBinding: bool = False
+    """If `True`, the dataset will not be automatically included in the
+    pipeline graph (``deferGraphConstraint=True`` is implied).
+
+    A custom `~.quantum_graph_builder.QuantumGraphBuilder` is required to bind
+    it and add a corresponding edge to the pipeline graph. This option allows
+    the same dataset type to be used as both an input and an output of a
+    quantum.
+    """
 
     _connection_type_set: ClassVar[str] = "inputs"
 
@@ -276,38 +213,6 @@ class Input(BaseInput):
 class PrerequisiteInput(BaseInput):
     """Class used for declaring PipelineTask prerequisite connections.
 
-    Attributes
-    ----------
-    name : `str`
-        The default name used to identify the dataset type.
-    storageClass : `str`
-        The storage class used when (un)/persisting the dataset type.
-    multiple : `bool`
-        Indicates if this connection should expect to contain multiple objects
-        of the given dataset type.  Tasks with more than one connection with
-        ``multiple=True`` with the same dimensions may want to implement
-        `.PipelineTaskConnections.adjustQuantum` to ensure those datasets are
-        consistent (i.e. zip-iterable) in `PipelineTask.runQuantum` and notify
-        the execution system as early as possible of outputs that will not be
-        produced because the corresponding input is missing.
-    dimensions : iterable of `str`
-        The `lsst.daf.butler.Butler` `lsst.daf.butler.Registry` dimensions used
-        to identify the dataset type identified by the specified name.
-    minimum : `bool`
-        Minimum number of datasets required for this connection, per quantum.
-        This is checked in the base implementation of
-        `.PipelineTaskConnections.adjustQuantum`, which raises
-        `FileNotFoundError` (causing QuantumGraph generation to fail).
-        `PipelineTask` implementations may provide custom
-        `~.PipelineTaskConnections.adjustQuantum` implementations for more
-        fine-grained or configuration-driven constraints, as long as they are
-        compatible with this minium.
-    lookupFunction : `typing.Callable`, optional
-        An optional callable function that will look up PrerequisiteInputs
-        using the DatasetType, registry, quantum dataId, and input collections
-        passed to it. If no function is specified, the default temporal spatial
-        lookup will be used.
-
     Raises
     ------
     TypeError
@@ -342,6 +247,13 @@ class PrerequisiteInput(BaseInput):
     lookupFunction: (
         Callable[[DatasetType, Registry, DataCoordinate, Sequence[str]], Iterable[DatasetRef]] | None
     ) = None
+    """An optional callable function that will look up PrerequisiteInputs
+    using the DatasetType, registry, quantum dataId, and input collections
+    passed to it.
+
+    If no function is specified, the default temporal/spatial lookup will be
+    used.
+    """
 
     _connection_type_set: ClassVar[str] = "prerequisiteInputs"
 

lsst/pipe/base/connections.py

@@ -495,15 +495,12 @@ class DeferredDatasetRef:
     """A wrapper class for `~lsst.daf.butler.DatasetRef` that indicates that a
     `PipelineTask` should receive a `~lsst.daf.butler.DeferredDatasetHandle`
     instead of an in-memory dataset.
-
-    Attributes
-    ----------
-    datasetRef : `lsst.daf.butler.DatasetRef`
-        The `lsst.daf.butler.DatasetRef` that will be eventually used to
-        resolve a dataset.
     """
 
     datasetRef: DatasetRef
+    """The `lsst.daf.butler.DatasetRef` that will be eventually used to
+    resolve a dataset.
+    """
 
     def __getattr__(self, name: str) -> Any:
         # make sure reduce is called on DeferredDatasetRef and not on

lsst/pipe/base/execution_reports.py

@@ -299,11 +299,6 @@ class QuantumGraphExecutionReport:
     produced DatasetTypes for each task. This report can be output as a
     dictionary or a yaml file.
 
-    Attributes
-    ----------
-    tasks : `dict`
-        A dictionary of TaskExecutionReports by task label.
-
     See Also
     --------
     TaskExecutionReport : A task report.

lsst/pipe/base/graph/graph.py

@@ -136,13 +136,14 @@ class QuantumGraph:
         Maps tasks to their InitOutput dataset refs. Dataset refs can be either
         resolved or non-resolved. For intermediate resolved refs their dataset
         ID must match ``initInputs`` and Quantum ``initInputs``.
-    globalInitOutputs : iterable [ `~lsst.daf.butler.DatasetRef` ], optional
+    globalInitOutputs : `~collections.abc.Iterable` \
+            [ `~lsst.daf.butler.DatasetRef` ], optional
         Dataset refs for some global objects produced by pipeline. These
         objects include task configurations and package versions. Typically
         they have an empty DataId, but there is no real restriction on what
         can appear here.
-    registryDatasetTypes : iterable [ `~lsst.daf.butler.DatasetType` ], \
-            optional
+    registryDatasetTypes : `~collections.abc.Iterable` \
+            [ `~lsst.daf.butler.DatasetType` ],  optional
         Dataset types which are used by this graph, their definitions must
         match registry. If registry does not define dataset type yet, then
         it should match one that will be created later.
@@ -488,7 +489,7 @@ class QuantumGraph:
 
         Returns
         -------
-        tasks : iterable of `TaskDef`
+        tasks : `~collections.abc.Iterable` [ `TaskDef` ]
             `TaskDef` objects that have the specified `DatasetTypeName` as an
             input, list will be empty if no tasks use specified
             `DatasetTypeName` as an input.
@@ -537,7 +538,7 @@ class QuantumGraph:
 
         Returns
         -------
-        result : iterable of `TaskDef`
+        result : `~collections.abc.Iterable` [`TaskDef`]
             `TaskDef` objects that are associated with the specified
             `DatasetTypeName`.
 
@@ -935,7 +936,7 @@ class QuantumGraph:
             saved structure. If supplied, the
             `~lsst.daf.butler.DimensionUniverse` from the loaded `QuantumGraph`
             will be validated against the supplied argument for compatibility.
-        nodes : iterable of [ `uuid.UUID` | `str` ] or `None`
+        nodes : `~collections.abc.Iterable` [ `uuid.UUID` | `str` ] or `None`
             UUIDs that correspond to nodes in the graph. If specified, only
             these nodes will be loaded. Defaults to None, in which case all
             nodes will be loaded.
@@ -1220,7 +1221,7 @@ class QuantumGraph:
             saved structure. If supplied, the
             `~lsst.daf.butler.DimensionUniverse` from the loaded `QuantumGraph`
             will be validated against the supplied argument for compatibility.
-        nodes : iterable of `uuid.UUID` or `None`
+        nodes : `~collections.abc.Iterable` [`uuid.UUID`] or `None`
             UUIDs that correspond to nodes in the graph. If specified, only
             these nodes will be loaded. Defaults to None, in which case all
             nodes will be loaded.
@@ -1438,7 +1439,7 @@ class QuantumGraph:
         Returns
         -------
         summary : `QgraphSummary`
-           Summary of QuantumGraph.
+            Summary of QuantumGraph.
         """
         inCollection = self.metadata.get("input", None)
         if isinstance(inCollection, str):

lsst/pipe/base/log_capture.py

@@ -103,7 +103,7 @@ class _ExecutionLogRecordsExtra(pydantic.BaseModel):
 
         Parameters
         ----------
-        log_records : `ButlerLogRecords`
+        log_records : `lsst.daf.butler.ButlerLogRecords`
             Logs from a past attempt to run a quantum.
         """
         previous = self.model_validate(log_records.extra)

lsst/pipe/base/pipeline.py

@@ -54,13 +54,12 @@ from lsst.utils.introspection import get_full_type_name
 
 from . import automatic_connection_constants as acc
 from . import pipeline_graph, pipelineIR
-from ._instrument import Instrument as PipeBaseInstrument
+from ._instrument import Instrument as Instrument
 from .config import PipelineTaskConfig
 from .connections import PipelineTaskConnections
 from .pipelineTask import PipelineTask
 
 if TYPE_CHECKING:  # Imports needed only for type annotations; may be circular.
-    from lsst.obs.base import Instrument
     from lsst.pex.config import Config
 
 # ----------------------------------
@@ -496,7 +495,7 @@ class Pipeline:
         Returns
         -------
         pipeline: `Pipeline`
-           The new pipeline.
+            The new pipeline.
         """
         return cls.fromIR(copy.deepcopy(pipeline._pipelineIR))
 
@@ -606,7 +605,7 @@ class Pipeline:
 
     @property
     def subsets(self) -> MappingProxyType[str, set]:
-        """Returns a `MappingProxyType` where the keys are the labels of
+        """Returns a `types.MappingProxyType` where the keys are the labels of
         labeled subsets in the `Pipeline` and the values are the set of task
         labels contained within that subset.
         """
@@ -702,7 +701,7 @@ class Pipeline:
         """
         instrument_class_name = self._pipelineIR.instrument
         if instrument_class_name is not None:
-            instrument_class = cast(PipeBaseInstrument, doImportType(instrument_class_name))
+            instrument_class = cast(Instrument, doImportType(instrument_class_name))
             if instrument_class is not None:
                 return DataCoordinate.standardize(instrument=instrument_class.getName(), universe=universe)
         return DataCoordinate.make_empty(universe)
@@ -893,7 +892,7 @@ class Pipeline:
             raise NameError(f"Label {label} does not appear in this pipeline")
         taskClass: type[PipelineTask] = doImportType(taskIR.klass)
         config = taskClass.ConfigClass()
-        instrument: PipeBaseInstrument | None = None
+        instrument: Instrument | None = None
         if (instrumentName := self._pipelineIR.instrument) is not None:
             instrument_cls: type = doImportType(instrumentName)
             instrument = instrument_cls()

lsst/pipe/base/pipelineIR.py

@@ -220,12 +220,6 @@ class LabeledSubset:
 class ParametersIR:
     """Intermediate representation of parameters that are global to a pipeline.
 
-    Attributes
-    ----------
-    mapping : `dict` [`str`, `str`]
-        A mutable mapping of identifiers as keys, and shared configuration
-        as values.
-
     Notes
     -----
     These parameters are specified under a top level key named ``parameters``
@@ -706,7 +700,7 @@ class PipelineIR:
 
         Parameters
         ----------
-        loaded_yaml: `dict`
+        loaded_yaml : `dict`
             A dictionary which matches the structure that would be produced
             by a yaml reader which parses a pipeline definition document
         """

lsst/pipe/base/pipelineTask.py

@@ -55,7 +55,7 @@ class PipelineTask(Task):
     resulting data is also stored in a data butler.
 
     PipelineTask inherits from a `~lsst.pipe.base.Task` and uses the same
-    configuration mechanism based on :ref:`lsst.pex.config`. `PipelineTask`
+    configuration mechanism based on `lsst.pex.config`. `PipelineTask`
     classes also have a `PipelineTaskConnections` class associated with their
     config which defines all of the IO a `PipelineTask` will need to do.
     PipelineTask sub-class typically implements `run()` method which receives
@@ -75,12 +75,6 @@ class PipelineTask(Task):
     PipelineTask base class constructor, but may support other signatures as
     well.
 
-    Attributes
-    ----------
-    canMultiprocess : bool, True by default (class attribute)
-        This class attribute is checked by execution framework, sub-classes
-        can set it to ``False`` in case task does not support multiprocessing.
-
     Parameters
     ----------
     config : `~lsst.pex.config.Config`, optional
@@ -102,7 +96,11 @@ class PipelineTask(Task):
     """
 
     ConfigClass: ClassVar[type[PipelineTaskConfig]]
+
     canMultiprocess: ClassVar[bool] = True
+    """Whether this task can be run by an executor that uses subprocesses for
+    parallelism.
+    """
 
     def __init__(
         self,

lsst/pipe/base/pipeline_graph/_dataset_types.py

@@ -106,8 +106,8 @@ class DatasetTypeNode:
             The internal networkx graph.
         get_registered : `~collections.abc.Callable` or `None`
             Callable that takes a dataset type name and returns the
-            `DatasetType` registered in the data repository, or `None` if it is
-            not registered.
+            `~lsst.daf.butler.DatasetType` registered in the data repository,
+            or `None` if it is not registered.
         dimensions : `lsst.daf.butler.DimensionUniverse`
             Definitions of all dimensions.
         previous : `DatasetTypeNode` or `None`

lsst/pipe/base/pipeline_graph/_edges.py

@@ -480,11 +480,11 @@ class ReadEdge(Edge):
         Parameters
         ----------
         current : `lsst.daf.butler.DatasetType` or `None`
-            The current graph-wide `DatasetType`, or `None`.  This will always
-            be the registry's definition of the parent dataset type, if one
-            exists.  If not, it will be the dataset type definition from the
-            task in the graph that writes it, if there is one.  If there is no
-            such task, this will be `None`.
+            The current graph-wide `~lsst.daf.butler.DatasetType`, or `None`.
+            This will always be the registry's definition of the parent dataset
+            type, if one exists.  If not, it will be the dataset type
+            definition from the task in the graph that writes it, if there is
+            one.  If there is no such task, this will be `None`.
         is_initial_query_constraint : `bool`
             Whether this dataset type is currently marked as a constraint on
             the initial data ID query in QuantumGraph generation.
@@ -496,7 +496,7 @@ class ReadEdge(Edge):
         producer : `str` or `None`
             The label of the task that produces this dataset type in the
             pipeline, or `None` if it is an overall input.
-        consumers : `Sequence` [ `str` ]
+        consumers : `~collections.abc.Sequence` [ `str` ]
             Labels for other consuming tasks that have already participated in
             this dataset type's resolution.
         is_registered : `bool`
@@ -512,7 +512,7 @@ class ReadEdge(Edge):
 
         Returns
         -------
-        dataset_type : `DatasetType`
+        dataset_type : `~lsst.daf.butler.DatasetType`
             The updated graph-wide dataset type.  If ``current`` was provided,
             this must be equal to it.
         is_initial_query_constraint : `bool`
@@ -659,13 +659,25 @@ class ReadEdge(Edge):
                     # compatible), since neither connection should take
                     # precedence.
                     if dataset_type != current:
-                        raise MissingDatasetTypeError(
-                            f"Definitions differ for input dataset type {self.parent_dataset_type_name!r}; "
-                            f"task {self.task_label!r} has {dataset_type}, but the definition "
-                            f"from {report_current_origin()} is {current}.  If the storage classes are "
-                            "compatible but different, registering the dataset type in the data repository "
-                            "in advance will avoid this error."
-                        )
+                        if visualization_only and dataset_type.dimensions == current.dimensions:
+                            # Make a visualization-only ambiguous storage class
+                            # "name".
+                            all_storage_classes = set(current.storageClass_name.split("/"))
+                            all_storage_classes.update(dataset_type.storageClass_name.split("/"))
+                            current = DatasetType(
+                                current.name,
+                                current.dimensions,
+                                "/".join(sorted(all_storage_classes)),
+                            )
+                        else:
+                            raise MissingDatasetTypeError(
+                                f"Definitions differ for input dataset type "
+                                f"{self.parent_dataset_type_name!r}; task {self.task_label!r} has "
+                                f"{dataset_type}, but the definition from {report_current_origin()} is "
+                                f"{current}.  If the storage classes are compatible but different, "
+                                "registering the dataset type in the data repository in advance will avoid "
+                                "this error."
+                            )
                 elif not visualization_only and not dataset_type.is_compatible_with(current):
                     raise IncompatibleDatasetTypeError(
                         f"Incompatible definition for input dataset type {self.parent_dataset_type_name!r}; "
@@ -788,15 +800,15 @@ class WriteEdge(Edge):
         Parameters
         ----------
         current : `lsst.daf.butler.DatasetType` or `None`
-            The current graph-wide `DatasetType`, or `None`.  This will always
-            be the registry's definition of the parent dataset type, if one
-            exists.
+            The current graph-wide `~lsst.daf.butler.DatasetType`, or `None`.
+            This will always be the registry's definition of the parent dataset
+            type, if one exists.
         universe : `lsst.daf.butler.DimensionUniverse`
             Object that holds all dimension definitions.
 
         Returns
         -------
-        dataset_type : `DatasetType`
+        dataset_type : `~lsst.daf.butler.DatasetType`
             A dataset type compatible with this edge.  If ``current`` was
             provided, this must be equal to it.
 

lsst/pipe/base/pipeline_graph/_pipeline_graph.py

@@ -897,6 +897,10 @@ class PipelineGraph:
             New config objects or overrides to apply to copies of the current
             config objects, with task labels as the keywords.
 
+        Returns
+        -------
+        None
+
         Raises
         ------
         ValueError
@@ -1632,7 +1636,7 @@ class PipelineGraph:
 
         Returns
         -------
-        subgraphs : `Iterable` [ `PipelineGraph` ]
+        subgraphs : `~collections.abc.Iterable` [ `PipelineGraph` ]
             An iterable over component subgraphs that could be run
             independently (they have only overall inputs in common).  May be a
             lazy iterator.
@@ -1755,6 +1759,10 @@ class PipelineGraph:
             not considered part of the pipeline graph in other respects, but it
             does get written with other provenance datasets).
 
+        Returns
+        -------
+        None
+
         Raises
         ------
         lsst.daf.butler.MissingDatasetTypeError
@@ -2228,7 +2236,7 @@ class PipelineGraph:
 
         Parameters
         ----------
-        updates : `Mapping` [ `str`, `TaskNode` ]
+        updates : `~collections.abc.Mapping` [ `str`, `TaskNode` ]
             New task nodes with task label keys.  All keys must be task labels
             that are already present in the graph.
         check_edges_unchanged : `bool`, optional