[no ci] networks docstrings: summary/inference network indicator (#462)

- From the table in the `bayesflow.networks` module overview, one cannot
  tell which network belongs to which group. This commit adds short
  labels to indicate inference networks (IN) and summary networks (SN)

Author: vpratz

bayesflow/experimental/cif/cif.py

@@ -12,7 +12,7 @@
 # disable module check, use potential module after moving from experimental
 @serializable("bayesflow.networks", disable_module_check=True)
 class CIF(InferenceNetwork):
-    """Implements a continuously indexed flow (CIF) with a `CouplingFlow`
+    """(IN) Implements a continuously indexed flow (CIF) with a `CouplingFlow`
     bijection and `ConditionalGaussian` distributions p and q. Improves on
     eliminating leaky sampling found topologically in normalizing flows.
     Built in reference to [1].

bayesflow/experimental/continuous_time_consistency_model.py

@@ -25,7 +25,7 @@
 # disable module check, use potential module after moving from experimental
 @serializable("bayesflow.networks", disable_module_check=True)
 class ContinuousTimeConsistencyModel(InferenceNetwork):
-    """Implements an sCM (simple, stable, and scalable Consistency Model)
+    """(IN) Implements an sCM (simple, stable, and scalable Consistency Model)
     with continous-time Consistency Training (CT) as described in [1].
     The sampling procedure is taken from [2].
 

bayesflow/experimental/free_form_flow/free_form_flow.py

@@ -22,7 +22,7 @@
 # disable module check, use potential module after moving from experimental
 @serializable("bayesflow.networks", disable_module_check=True)
 class FreeFormFlow(InferenceNetwork):
-    """Implements a dimensionality-preserving Free-form Flow.
+    """(IN) Implements a dimensionality-preserving Free-form Flow.
     Incorporates ideas from [1-2].
 
     [1] Draxler, F., Sorrenson, P., Zimmermann, L., Rousselot, A., & Köthe, U. (2024).F

bayesflow/networks/__init__.py

@@ -1,5 +1,7 @@
 """
 A rich collection of neural network architectures for use in :py:class:`~bayesflow.approximators.Approximator`\ s.
+
+The module features inference networks (IN), summary networks (SN), as well as general purpose networks.
 """
 
 from .consistency_models import ConsistencyModel

bayesflow/networks/consistency_models/consistency_model.py

@@ -14,8 +14,8 @@
 
 @serializable("bayesflow.networks")
 class ConsistencyModel(InferenceNetwork):
-    """Implements a Consistency Model with Consistency Training (CT) a described in [1-2]. The adaptations to CT
-    described in [2] were taken into account in our implementation for ABI [3].
+    """(IN) Implements a Consistency Model with Consistency Training (CT) as described in [1-2].
+    The adaptations to CT described in [2] were taken into account in our implementation for ABI [3].
 
     [1] Song, Y., Dhariwal, P., Chen, M. & Sutskever, I. (2023). Consistency Models. arXiv preprint arXiv:2303.01469
 

bayesflow/networks/coupling_flow/coupling_flow.py

@@ -15,7 +15,7 @@
 
 @serializable("bayesflow.networks")
 class CouplingFlow(InferenceNetwork):
-    """Implements a coupling flow as a sequence of dual couplings with permutations and activation
+    """(IN) Implements a coupling flow as a sequence of dual couplings with permutations and activation
     normalization. Incorporates ideas from [1-5].
 
     [1] Kingma, D. P., & Dhariwal, P. (2018).

bayesflow/networks/deep_set/deep_set.py

@@ -13,7 +13,7 @@
 
 @serializable("bayesflow.networks")
 class DeepSet(SummaryNetwork):
-    """Implements a deep set encoder introduced in [1] for learning permutation-invariant representations of
+    """(SN) Implements a deep set encoder introduced in [1] for learning permutation-invariant representations of
     set-based data, as generated by exchangeable models.
 
     [1] Zaheer, M., Kottur, S., Ravanbakhsh, S., Poczos, B., Salakhutdinov, R. R., & Smola, A. J. (2017).

bayesflow/networks/flow_matching/flow_matching.py

@@ -21,7 +21,7 @@
 
 @serializable("bayesflow.networks")
 class FlowMatching(InferenceNetwork):
-    """Implements Optimal Transport Flow Matching, originally introduced as Rectified Flow, with ideas incorporated
+    """(IN) Implements Optimal Transport Flow Matching, originally introduced as Rectified Flow, with ideas incorporated
     from [1-3].
 
     [1] Rectified Flow: arXiv:2209.03003

bayesflow/networks/time_series_network/time_series_network.py

@@ -10,7 +10,7 @@
 @serializable("bayesflow.networks")
 class TimeSeriesNetwork(SummaryNetwork):
     """
-    Implements a LSTNet Architecture as described in [1]
+    (SN) Implements a LSTNet Architecture as described in [1]
 
     [1] Y. Zhang and L. Mikelsons, Solving Stochastic Inverse Problems with Stochastic BayesFlow,
     2023 IEEE/ASME International Conference on Advanced Intelligent Mechatronics (AIM),

bayesflow/networks/transformers/fusion_transformer.py

@@ -12,7 +12,8 @@
 
 @serializable("bayesflow.networks")
 class FusionTransformer(SummaryNetwork):
-    """Implements a more flexible version of the TimeSeriesTransformer that applies a series of self-attention layers
+    """
+    (SN) Implements a more flexible version of the TimeSeriesTransformer that applies a series of self-attention layers
     followed by cross-attention between the representation and a learnable template summarized via a recurrent net."""
 
     def __init__(