pyFDN 0.2.0__tar.gz → 0.3.0__tar.gz

pyfdn-0.3.0/AUTHORS.rst

@@ -0,0 +1,17 @@
+=======
+Credits
+=======
+
+
+Core Contributors
+-----------------
+
+* Sebastian J. Schlecht
+* Facundo Franchino
+* Jeremy Bai
+* Alma Hova
+* Cristóbal Andrade
+* Gloria Dal Santo
+* Bharadwaj Lakuduva Suresh Babu
+* Gian Marco De Bortoli
+* Kalyan Pandey

{pyfdn-0.2.0 → pyfdn-0.3.0}/CONTRIBUTING.rst

@@ -137,8 +137,35 @@ Building the Documentation
 Repository Index
 ----------------
 
-.. note::
-    This section will be filled out later with the goal structure of the repository.
+The repository separates the installable package, executable examples,
+documentation sources, and tests:
+
+* ``src/pyFDN/`` contains the library. The top-level ``__init__.py`` defines
+  the public API, while ``process.py``, ``build_io.py``, and ``presets.py``
+  provide the main processing and persistence entry points.
+* ``src/pyFDN/generate/`` contains feedback-matrix and FDN construction
+  algorithms, including the allpass and scattering-delay-network builders.
+* ``src/pyFDN/td/`` contains stateful block-processing operators and the
+  connectors (``Series``, ``Parallel``, ``Recursion``) that wire them into a
+  time-domain graph. ``process_fdn`` uses ``MatrixFIR`` for polynomial feedback
+  matrices; ``SOSBank`` implements per-delay-line filter cascades used for
+  frequency-dependent absorption.
+* ``src/pyFDN/graphicEQ/`` contains graphic-EQ and absorption-filter design,
+  while ``src/pyFDN/translate/`` converts between delay state-space, transfer
+  function, pole-residue, impulse-response, and FLAMO representations.
+* ``src/pyFDN/train/`` contains the trainable FDN construction, objectives,
+  and optimization loop. ``src/pyFDN/auxiliary/`` holds shared analysis,
+  plotting, audio, delay, and numerical helpers.
+* ``examples/`` contains executable Marimo notebooks. Metadata at the top of
+  each ``example_*.py`` file drives the generated documentation gallery.
+* ``tests/`` mirrors the public feature areas with unit, regression, and
+  integration coverage; ``tests/reference/`` stores reference data and its
+  provenance notes.
+* ``docs/`` contains authored Sphinx pages and the scripts that generate API
+  stubs and galleries. Generated pages and HTML output are intentionally not
+  committed.
+* ``.github/`` contains the continuous-integration, packaging, and GitHub
+  Pages workflows.
 
 
 Testing Pipeline

pyfdn-0.3.0/HISTORY.rst

@@ -0,0 +1,37 @@
+=======
+History
+=======
+
+0.3.0 (2026-08-17)
+------------------
+
+* **Breaking:** replace the ``pyFDN.dsp`` subpackage with ``pyFDN.td``. The
+  top-level ``FeedbackDelay``, ``FIRMatrixFilter`` and ``SOSFilterBank``
+  exports are gone; use ``pyFDN.td`` operators instead.
+* **Breaking:** ship the packaged colorless-FDN presets as JSON rather than
+  MATLAB ``.mat`` files.
+* Add ``pyFDN.td``, a time-domain block-based processing graph built on NumPy
+  alone (no torch, no FFT), with the ``Series``, ``Parallel`` and
+  ``Recursion`` connectors and stateful ``Gain``, ``Delay``, ``SOSBank``,
+  ``MatrixFIR``, ``MatrixConvolver`` and ``TimeVaryingMatrix`` operators.
+* Add ``load_fdn_build``, ``save_fdn_build``, ``fdn_build_from_dict`` and
+  ``fdn_build_to_dict`` for reading and writing FDN builds as JSON.
+* Add an FDN-to-FAUST example that compiles a pyFDN design with adac, and a
+  reverberation-enhancement example.
+* Improve the example gallery and stop tracking generated documentation in the
+  repository.
+* Test on Python 3.14 in CI and the documentation build.
+
+0.2.0 (2026-08-10)
+------------------
+
+* Package compact audio examples and predefined colorless-FDN coefficients so
+  browser-hosted tutorials work without repository-relative files.
+* Add public APIs for packaged audio, FDN presets, and paper references.
+* Add generated documentation galleries and wheel-content checks.
+* Keep decay-estimation dependencies optional for a smaller core installation.
+
+0.1.0 (2025-07-02)
+------------------
+
+* First release on PyPI.

{pyfdn-0.2.0 → pyfdn-0.3.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: pyFDN
-Version: 0.2.0
+Version: 0.3.0
 Summary: Python library for Feedback Delay Networks
 Author: Sebastian J. Schlecht, Facundo Franchino, Jeremy Bai
 Maintainer: Facundo Franchino, Sebastian J. Schlecht
@@ -12,7 +12,7 @@ Classifier: Development Status :: 3 - Alpha
 Classifier: Intended Audience :: Science/Research
 Classifier: Programming Language :: Python :: 3
 Classifier: Programming Language :: Python :: 3.10
-Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.14
 Requires-Python: >=3.10
 Description-Content-Type: text/x-rst
 License-File: LICENSE
@@ -25,14 +25,18 @@ Requires-Dist: flamo>=0.2.14
 Requires-Dist: flareverb
 Provides-Extra: examples
 Requires-Dist: marimo; extra == "examples"
+Requires-Dist: adac; extra == "examples"
 Requires-Dist: matplotlib>=3.5.0; extra == "examples"
 Requires-Dist: plotly>=5.0.0; extra == "examples"
 Requires-Dist: multislope>=0.1.1; extra == "examples"
+Requires-Dist: pyroomacoustics; extra == "examples"
 Provides-Extra: test
 Requires-Dist: marimo; extra == "test"
+Requires-Dist: adac; extra == "test"
 Requires-Dist: matplotlib>=3.5.0; extra == "test"
 Requires-Dist: plotly>=5.0.0; extra == "test"
 Requires-Dist: multislope>=0.1.1; extra == "test"
+Requires-Dist: pyroomacoustics; extra == "test"
 Requires-Dist: pytest>=7.0.0; extra == "test"
 Requires-Dist: pytest-cov>=4.0.0; extra == "test"
 Requires-Dist: coverage>=7.0.0; extra == "test"
@@ -60,6 +64,8 @@ Requires-Dist: pandoc>=2.0; extra == "docs"
 Requires-Dist: plotly>=5.0.0; extra == "docs"
 Requires-Dist: matplotlib>=3.5.0; extra == "docs"
 Requires-Dist: multislope>=0.1.1; extra == "docs"
+Requires-Dist: pyroomacoustics; extra == "docs"
+Requires-Dist: adac; extra == "docs"
 Dynamic: license-file
 
 =====
@@ -93,6 +99,9 @@ Overview
 
 ``pyFDN`` provides building blocks for designing, simulating, and analysing Feedback Delay Networks (FDNs). The package focuses on reusable, tested helper functions that simplify typical FDN workflows such as creating orthogonal feedback matrices, designing loop filters, and inspecting pole locations. Using ``flamo`` as a dependency, ``pyFDN`` allows modular design of advanced FDN structure with DSP operations in time and frequency domain.
 
+The `pyFDN tutorial
+<https://artificial-audio.github.io/pyfdn-tutorial-2026/>`_ provides an introduction to the package.
+
 The source code is MIT-licensed. Small packaged tutorial resources retain the
 separate terms recorded in ``src/pyFDN/resources/ATTRIBUTION.md``; in
 particular, the Pori concert-hall impulse response is limited to
@@ -165,3 +174,12 @@ Or, inside an activated virtual environment::
 
 For linting and packaging helpers see ``Makefile`` (``make lint``/``make docs``)
 and ``tox.ini`` for multi-environment testing.
+
+
+Helpful links
+-------------
+
+* `List of papers on Feedback Delay Networks <https://github.com/gdalsanto/delay-network-reverbs>`_ .
+* `Multislope Estimation library <https://github.com/artificial-audio/multislope>`_ .
+* `FLAMO (An Open-Source Library for Frequency-Domain Differentiable Audio Processing) <https://github.com/gdalsanto/flamo>`_ .
+* `ADAC (Automatic Differentiable Audio Compilation) library <https://github.com/cucuwritescode/adac>`_ .

{pyfdn-0.2.0 → pyfdn-0.3.0}/README.rst

@@ -29,6 +29,9 @@ Overview
 
 ``pyFDN`` provides building blocks for designing, simulating, and analysing Feedback Delay Networks (FDNs). The package focuses on reusable, tested helper functions that simplify typical FDN workflows such as creating orthogonal feedback matrices, designing loop filters, and inspecting pole locations. Using ``flamo`` as a dependency, ``pyFDN`` allows modular design of advanced FDN structure with DSP operations in time and frequency domain.
 
+The `pyFDN tutorial
+<https://artificial-audio.github.io/pyfdn-tutorial-2026/>`_ provides an introduction to the package.
+
 The source code is MIT-licensed. Small packaged tutorial resources retain the
 separate terms recorded in ``src/pyFDN/resources/ATTRIBUTION.md``; in
 particular, the Pori concert-hall impulse response is limited to
@@ -101,3 +104,12 @@ Or, inside an activated virtual environment::
 
 For linting and packaging helpers see ``Makefile`` (``make lint``/``make docs``)
 and ``tox.ini`` for multi-environment testing.
+
+
+Helpful links
+-------------
+
+* `List of papers on Feedback Delay Networks <https://github.com/gdalsanto/delay-network-reverbs>`_ .
+* `Multislope Estimation library <https://github.com/artificial-audio/multislope>`_ .
+* `FLAMO (An Open-Source Library for Frequency-Domain Differentiable Audio Processing) <https://github.com/gdalsanto/flamo>`_ .
+* `ADAC (Automatic Differentiable Audio Compilation) library <https://github.com/cucuwritescode/adac>`_ .

pyfdn-0.3.0/docs/Makefile

@@ -0,0 +1,39 @@
+# Minimal makefile for Sphinx documentation
+#
+
+# You can set these variables from the command line.
+PYTHON        ?= python
+SPHINXOPTS    =
+SPHINXBUILD   ?= $(PYTHON) -msphinx
+SPHINXPROJ    = pyFDN
+SOURCEDIR     = .
+BUILDDIR      = _build
+SPHINXAPIDOC  ?= $(PYTHON) -msphinx.ext.apidoc
+
+# Put it first so that "make" without argument is like "make help".
+help:
+	@$(SPHINXBUILD) -M help "$(SOURCEDIR)" "$(BUILDDIR)" $(SPHINXOPTS) $(O)
+
+.PHONY: help Makefile clean clean-generated generate-rst html
+
+# API stubs and autosummary pages are reproducible build inputs. Remove them
+# before every build so deleted or renamed public objects cannot leave stale
+# documentation behind.
+clean-generated:
+	$(RM) modules.rst pyFDN.rst pyFDN.*.rst
+	$(RM) -r generated
+
+generate-rst: clean-generated
+	$(SPHINXAPIDOC) -f -o "$(SOURCEDIR)" ../src/pyFDN
+	$(PYTHON) patch_rst.py
+
+clean: clean-generated
+	@$(SPHINXBUILD) -M clean "$(SOURCEDIR)" "$(BUILDDIR)" $(SPHINXOPTS) $(O)
+
+html: generate-rst
+	@$(SPHINXBUILD) -M html "$(SOURCEDIR)" "$(BUILDDIR)" $(SPHINXOPTS) $(O)
+
+# Catch-all target: route all unknown targets to Sphinx using the new
+# "make mode" option.  $(O) is meant as a shortcut for $(SPHINXOPTS).
+%: Makefile
+	@$(SPHINXBUILD) -M $@ "$(SOURCEDIR)" "$(BUILDDIR)" $(SPHINXOPTS) $(O)

{pyfdn-0.2.0 → pyfdn-0.3.0}/docs/api_reference.rst

@@ -114,16 +114,29 @@ Graphic EQ
    pyFDN.shelving_filter
    pyFDN.bandpass_filter
 
-DSP Components
---------------
+Time-Domain Graph (``pyFDN.td``)
+--------------------------------
+
+Stateful block-processing operators, wired into a graph by the connectors and
+rendered with ``.process(signal)``. See :mod:`pyFDN.td`.
 
 .. autosummary::
    :toctree: generated/
    :nosignatures:
 
-   pyFDN.FeedbackDelay
-   pyFDN.FIRMatrixFilter
-   pyFDN.SOSFilterBank
+   pyFDN.td.TimeOperator
+   pyFDN.td.Identity
+   pyFDN.td.Gain
+   pyFDN.td.Delay
+   pyFDN.td.AbsoluteValue
+   pyFDN.td.SOSBank
+   pyFDN.td.MatrixFIR
+   pyFDN.td.MatrixConvolver
+   pyFDN.td.TimeVaryingMatrix
+   pyFDN.td.RecursionState
+   pyFDN.td.Series
+   pyFDN.td.Parallel
+   pyFDN.td.Recursion
 
 Delay Utilities
 ---------------
@@ -188,8 +201,8 @@ General Utilities
    pyFDN.pole_boundaries
    pyFDN.skew
 
-Packaged Examples & References
-------------------------------
+Build Files, Packaged Examples & References
+--------------------------------------------
 
 .. autosummary::
    :toctree: generated/
@@ -200,6 +213,10 @@ Packaged Examples & References
    pyFDN.load_audio
    pyFDN.available_fdn_presets
    pyFDN.load_fdn_preset
+   pyFDN.fdn_build_to_dict
+   pyFDN.fdn_build_from_dict
+   pyFDN.save_fdn_build
+   pyFDN.load_fdn_build
    pyFDN.paper_reference
    pyFDN.paper_link
 

{pyfdn-0.2.0 → pyfdn-0.3.0}/docs/audio_gallery.py

@@ -66,9 +66,9 @@ def render_gallery(examples: list[AudioExample]) -> str:
     lines = [
         ".. This file is generated by docs/audio_gallery.py. Do not edit it manually.",
         "",
-        "============",
+        "=============",
         "Audio Gallery",
-        "============",
+        "=============",
         "",
         "Audio examples demonstrating ``pyFDN``. The gallery is generated",
         "automatically from every packaged ``.wav`` file, grouped by resource category.",

{pyfdn-0.2.0 → pyfdn-0.3.0}/docs/conf.py

@@ -47,6 +47,11 @@ autosummary_imported_members = True
 # Napoleon settings (Google / NumPy docstrings)
 napoleon_google_docstring = True
 napoleon_numpy_docstring = True
+# Render "Attributes" sections as :ivar: fields instead of standalone
+# ``.. attribute::`` directives. Without this, every documented attribute is
+# registered twice (once by napoleon, once by autodoc's member scan) and Sphinx
+# warns about duplicate object descriptions.
+napoleon_use_ivar = True
 
 
 # Intersphinx mapping
@@ -114,7 +119,9 @@ latex_documents = [
 marimo_notebook_dir = "../examples"
 marimo_default_height = "800px"
 marimo_default_width = "100%"
-marimo_click_to_load = "overlay"  # Use overlay mode for better performance
+# ``True`` is rendered as the extension's overlay mode. Keep this a boolean;
+# sphinx-marimo declares the setting as such and Sphinx warns on string values.
+marimo_click_to_load = True
 marimo_load_button_text = "Load Interactive Notebook"
 
 # Build notebooks serially in-process. The export-mode override below patches the

{pyfdn-0.2.0 → pyfdn-0.3.0}/docs/example_gallery.py

@@ -60,27 +60,18 @@ def _plain_text(markdown: str) -> str:
     return text.strip()
 
 
-def _title_and_description(path: Path) -> tuple[str, str]:
+def _inferred_title(path: Path) -> str:
     blocks = _markdown_blocks(path)
     for block in blocks:
         lines = block.splitlines()
-        for index, line in enumerate(lines):
+        for line in lines:
             if not line.startswith("# "):
                 continue
             title = _plain_text(line[2:])
-            paragraphs = "\n".join(lines[index + 1 :]).strip().split("\n\n")
-            description = next(
-                (
-                    _plain_text(paragraph)
-                    for paragraph in paragraphs
-                    if paragraph.strip() and not paragraph.lstrip().startswith("#")
-                ),
-                "Open the rendered marimo notebook.",
-            )
-            return title, description
+            return title
 
     fallback = path.stem.removeprefix("example_").replace("_", " ").title()
-    return fallback, "Open the rendered marimo notebook."
+    return fallback
 
 
 def _metadata(path: Path) -> dict[str, str]:
@@ -93,25 +84,25 @@ def _metadata(path: Path) -> dict[str, str]:
     return metadata
 
 
-def _required_category(path: Path) -> str:
-    metadata = _metadata(path)
-    category = metadata.get("category")
-    if category:
-        return category
+def _required_metadata(path: Path, metadata: dict[str, str], key: str) -> str:
+    value = metadata.get(key)
+    if value:
+        return value
     relative = path.relative_to(PROJECT_ROOT)
-    raise ValueError(f"{relative} is missing a required '# gallery_category: ...' tag")
+    raise ValueError(f"{relative} is missing a required '# gallery_{key}: ...' tag")
 
 
 def discover_examples() -> list[Example]:
     examples = []
     for path in sorted(EXAMPLES_DIR.rglob("example_*.py")):
-        title, description = _title_and_description(path)
+        metadata = _metadata(path)
+        inferred_title = _inferred_title(path)
         examples.append(
             Example(
                 path,
-                title,
-                description,
-                _required_category(path),
+                metadata.get("title", inferred_title),
+                _required_metadata(path, metadata, "description"),
+                _required_metadata(path, metadata, "category"),
             )
         )
     return examples

pyfdn-0.3.0/docs/patch_rst.py

@@ -0,0 +1,35 @@
+#!/usr/bin/env python3
+"""Patch generated RST files to avoid duplicate object descriptions with api_reference."""
+
+import re
+from pathlib import Path
+
+DOCS = Path(__file__).parent
+
+# Replace pyFDN Module contents automodule with a link (avoids duplicates with api_reference)
+pyfdn_rst = DOCS / "pyFDN.rst"
+if pyfdn_rst.exists():
+    text = pyfdn_rst.read_text()
+    new = """Module contents
+---------------
+
+See :doc:`API Reference <api_reference>` for full documentation of all functions and classes."""
+    text = re.sub(
+        r"Module contents\n-+\n\n\.\. automodule:: pyFDN\n(   :[^\n]+\n)+",
+        new + "\n",
+        text,
+    )
+    pyfdn_rst.write_text(text)
+
+# Sub-package "Module contents" sections otherwise re-document every member
+# their __init__ re-exports. Keep the package docstring, but omit those members;
+# api_reference and the submodule sections remain the canonical targets.
+for package_rst in sorted(DOCS.glob("pyFDN.*.rst")):
+    package = package_rst.stem  # e.g. "pyFDN.graphicEQ"
+    text = package_rst.read_text()
+    pattern = rf"(\.\. automodule:: {re.escape(package)}\n(   :[^\n]+\n)+)"
+    match = re.search(pattern, text)
+    if match:
+        block = f".. automodule:: {package}\n   :no-index:\n   :no-members:\n"
+        text = text[: match.start()] + block + text[match.end() :]
+        package_rst.write_text(text)

{pyfdn-0.2.0 → pyfdn-0.3.0}/docs/usage.rst

@@ -32,3 +32,8 @@ public API, independent of the current working directory::
 Use ``pyFDN.available_audio()`` and ``pyFDN.available_fdn_presets()`` to list
 the bundled choices. Attribution and license information for audio is returned
 by ``pyFDN.audio_metadata(name)``.
+
+FDN builds can also be exchanged as readable, versioned JSON files::
+
+    pyFDN.save_fdn_build("reverberator.json", reverberator)
+    restored = pyFDN.load_fdn_build("reverberator.json")

{pyfdn-0.2.0 → pyfdn-0.3.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "pyFDN"
-version = "0.2.0"
+version = "0.3.0"
 description = "Python library for Feedback Delay Networks"
 readme = "README.rst"
 authors = [
@@ -21,7 +21,7 @@ classifiers = [
     "Intended Audience :: Science/Research",
     "Programming Language :: Python :: 3",
     "Programming Language :: Python :: 3.10",
-    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.14",
 ]
 requires-python = ">=3.10"
 license = "MIT"
@@ -41,15 +41,19 @@ dependencies = [
 [project.optional-dependencies]
 examples = [
     "marimo",  # the example notebooks are marimo apps
+    "adac",  # example_fdn_to_faust compiles a FLAMO model to FAUST
     "matplotlib>=3.5.0",  # examples build matplotlib figures
     "plotly>=5.0.0",  # examples build plotly figures
     "multislope>=0.1.1",  # multi-slope decay estimation (DecayFitNet), example only
+    "pyroomacoustics",  # shoebox image-source RIRs for example_reverberation_enhancement
 ]
 test = [
     "marimo",  # deps to run the example notebooks under test
+    "adac",
     "matplotlib>=3.5.0",
     "plotly>=5.0.0",
     "multislope>=0.1.1",
+    "pyroomacoustics",
     "pytest>=7.0.0",  # testing
     "pytest-cov>=4.0.0",  # coverage plugin for pytest
     "coverage>=7.0.0",  # coverage tooling
@@ -79,6 +83,8 @@ docs = [
     "plotly>=5.0.0",
     "matplotlib>=3.5.0",
     "multislope>=0.1.1",  # rendered by the multi-slope example notebook
+    "pyroomacoustics",  # rendered by the reverberation-enhancement notebook
+    "adac",  # example_fdn_to_faust is rendered into the docs
 ]
 
 [project.urls]
@@ -97,7 +103,7 @@ include = ["pyFDN*"]
     "licenses/*.txt",
     "audio/metadata.json",
     "audio/*/*.wav",
-    "presets/colorless_FDN/*.mat",
+    "presets/colorless_FDN/*.json",
 ]
 
 # Bump My Version
@@ -107,7 +113,7 @@ include = ["pyFDN*"]
 # triggers on. Usage: bump-my-version bump {major|minor|patch}
 
 [tool.bumpversion]
-current_version = "0.2.0"
+current_version = "0.3.0"
 allow_dirty = false
 commit = true
 message = "Bump version: {current_version} → {new_version}"

{pyfdn-0.2.0 → pyfdn-0.3.0}/src/pyFDN/__init__.py

@@ -3,13 +3,9 @@
 from importlib import import_module
 
 __author__ = "Facundo Franchino"
-__version__ = "0.2.0"
+__version__ = "0.3.0"
 
 __all__ = [
-    # dsp
-    "FeedbackDelay",
-    "FIRMatrixFilter",
-    "SOSFilterBank",
     # acoustics
     "absorption_filters",
     "echo_density",
@@ -44,6 +40,10 @@ __all__ = [
     "paper_reference",
     "available_fdn_presets",
     "load_fdn_preset",
+    "fdn_build_from_dict",
+    "fdn_build_to_dict",
+    "load_fdn_build",
+    "save_fdn_build",
     # matrix generators
     "allpass_in_fdn",
     "anderson_matrix",
@@ -159,6 +159,8 @@ __all__ = [
     "flamo_nodes_flat",
     "plot_flamo_graph",
     "extract_build",
+    # time-domain graph engine
+    "td",
     # SDN (scattering delay network)
     "SDN",
     # allpass FDN
@@ -299,11 +301,12 @@ from .auxiliary.utils import (
     skew,
     sq_to_db,
 )
-
-# dsp components
-from .dsp.dfilt_matrix import FIRMatrixFilter
-from .dsp.feedback_delay import FeedbackDelay
-from .dsp.sos_filter_bank import SOSFilterBank
+from .build_io import (
+    fdn_build_from_dict,
+    fdn_build_to_dict,
+    load_fdn_build,
+    save_fdn_build,
+)
 from .generate.allpass_FDN import allpass_completion
 from .generate.allpass_FDN.allpass_completion import (
     apply_diagonal_similarity,
@@ -399,3 +402,6 @@ from .translate.pr_to_impz import pr_to_impz
 
 # Expose allpass submodule for pyFDN.allpass.is_uniallpass etc.
 allpass = import_module(".auxiliary.allpass", __name__)
+
+# Time-domain graph engine (pyFDN.td operators and connectors).
+from . import td  # noqa: E402

{pyfdn-0.2.0 → pyfdn-0.3.0}/src/pyFDN/auxiliary/plot.py

@@ -546,10 +546,10 @@ def _db_per_sample_traces(
     import plotly.graph_objects as go
     from scipy.signal import sosfreqz
 
-    from pyFDN.dsp.sos_filter_bank import SOSFilterBank
+    from pyFDN.td.operators import SOSBank
 
     N = delays_arr.size
-    sos_bank = SOSFilterBank(sos, N).sos  # (N, n_sections, 6)
+    sos_bank = SOSBank(sos).sos  # (N, n_sections, 6)
     traces = []
     for i in range(N):
         w, h = sosfreqz(sos_bank[i], worN=nfft)
@@ -590,7 +590,7 @@ def plot_db_per_sample(
     ----------
     sos : array-like
         Per-delay-line SOS bank, same layout as
-        :class:`pyFDN.dsp.SOSFilterBank`: ``(n_sections, 6, N)``.
+        :class:`pyFDN.td.SOSBank`: ``(n_sections, 6, N)``.
     delays : array-like
         Delay lengths in samples, shape (N,).
     fs : float, optional
@@ -667,7 +667,7 @@ def plot_fdn_parameter(
         Feedback matrix, input gains, output gains, direct gains.
     attenuation_sos : array-like, optional
         Per-delay-line SOS attenuation bank, same layout as
-        :class:`pyFDN.dsp.SOSFilterBank`: ``(n_sections, 6, N)``.
+        :class:`pyFDN.td.SOSBank`: ``(n_sections, 6, N)``.
     post_eq_sos : array-like, optional
         Post EQ as an SOS cascade in scipy format, shape ``(n_sections, 6)``
         (or ``(6,)`` for one section) for a single output, or