pyFDN

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 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 noncommercial use.

Highlights

Matrix polynomial helpers for evaluating, differentiating, and convolving FIR/IIR blocks.
Loop analysis utilities including pole boundary estimation and curve bounding checks.
Acoustic absorption design tools that translate RT targets into one-pole loop filters.
Echo density (Abel & Huang 2006) for analysing reverberation and mixing time.
Random orthogonal matrix generation to prototype energy-preserving feedback networks.

Installation

Install the current release from PyPI:

pip install pyFDN

For local development, create a virtual environment and install the package in editable mode together with the optional tooling:

python -m venv .venv
source .venv/bin/activate
pip install -e .

Quick start

All main functions are accessible directly from the top-level pyFDN namespace:

import numpy as np
import pyFDN

fs = 48_000
delays = np.array([331, 347, 359, 373], dtype=int)

# energy-preserving feedback matrix
feedback = pyFDN.random_orthogonal(len(delays))

# one-pole absorption filters targeting RT of 1.2 s at DC and 0.9 s at Nyquist
absorption = pyFDN.one_pole_absorption(1.2, 0.9, delays, fs)

# convert delay state-space to standard state-space (A_ss, b, c, d)
A_ss, b, c, d = pyFDN.dss_to_ss(delays, feedback)

Alternatively, import specific functions directly:

from pyFDN import random_orthogonal, one_pole_absorption, lin_to_db

feedback = random_orthogonal(4)
absorption = one_pole_absorption(1.2, 0.9, [100, 150, 200, 250], 48_000)

Development

Run the test suite (the configuration mirrors CI and emits coverage details):

tox -e py311

Or, inside an activated virtual environment:

pytest --cov=src/pyFDN --cov-report=term-missing

For linting and packaging helpers see Makefile (make lint/make docs) and tox.ini for multi-environment testing.

Helpful links

Development Status
- 3 - Alpha
Intended Audience
- Science/Research
Programming Language

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

pyfdn-0.4.0.tar.gz (7.0 MB view details)

Uploaded Aug 23, 2026 Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

The dropdown lists show the available interpreters, ABIs, and platforms. Enable javascript to be able to filter the list of wheel files.

pyfdn-0.4.0-py3-none-any.whl (3.1 MB view details)

Uploaded Aug 23, 2026 Python 3

File details

Details for the file pyfdn-0.4.0.tar.gz.

File metadata

Download URL: pyfdn-0.4.0.tar.gz
Upload date: Aug 23, 2026
Size: 7.0 MB
Tags: Source
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for pyfdn-0.4.0.tar.gz
Algorithm	Hash digest
SHA256	`bbd75f40bc578bda6bd2ccb89ee0eacd32a01f3cb0ff1cb46beacb9a11c07990`
MD5	`5a3c2be26c6b75989fee27126b9726e4`
BLAKE2b-256	`0bf49dd5e733d1641aef94c1167962eeb1ec497c95655dd0e9c763575cf3d325`

See more details on using hashes here.

Provenance

The following attestation bundles were made for pyfdn-0.4.0.tar.gz:

Publisher: release.yml on artificial-audio/pyFDN

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Statement:
- Statement type: https://in-toto.io/Statement/v1
- Predicate type: https://docs.pypi.org/attestations/publish/v1
- Subject name: pyfdn-0.4.0.tar.gz
- Subject digest: bbd75f40bc578bda6bd2ccb89ee0eacd32a01f3cb0ff1cb46beacb9a11c07990
- Sigstore transparency entry: 2569687120
- Sigstore integration time: Aug 23, 2026
Source repository:
- Permalink: artificial-audio/pyFDN@bb7d6abd34c891d67172ed47e369a7e42345533c
- Branch / Tag: refs/tags/v0.4.0
- Owner: https://github.com/artificial-audio
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: release.yml@bb7d6abd34c891d67172ed47e369a7e42345533c
- Trigger Event: push