firconv

library0.0.3pypypi✓ verified 82d ago

Python library for real-time convolution, primarily for auralization. Current version 0.0.3, early development with infrequent releases.

data

pip install firconv

github ↗package ↗

INSTALL

IMPORT

SIG · FIRCONV

firconv

datapythonv0.0.3

harness data pending

Install & Compatibility

Where this runs

No compatibility data collected yet for this library.

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

FIRconv

✓ from FIRconv import FIRconv

✗ from firconv import FIRconv

Crossfader

✓ from FIRconv import Crossfader

FIRfilter

✓ from FIRconv import FIRfilter

Basic usage: create FIRconv instance with an impulse response and process audio blocks.

from firconv import FIRconv import numpy as np # Create a simple impulse response (e.g., 1024 samples) ir = np.random.randn(1024).astype(np.float32) # Initialize FIRconv with the IR conv = FIRconv(ir) # Process a block of audio input_signal = np.random.randn(4096).astype(np.float32) output = conv.process(input_signal) # For real-time streaming, use process() repeatedly

Debug

Known issues

breakingThe API may change drastically before 1.0. No backward compatibility guarantees.

fix

Pin version and review release notes before upgrading.

affects: 0.x

gotchaAudio data must be float32 numpy arrays. Other types (int16, float64) cause silent errors or crashes.

fix

Ensure input arrays are dtype=np.float32.

affects: all

gotchaImpulse response length must be a power of two or at least aligned with block size. Non-power-of-two IRs may produce artifacts.

fix

Pad IR to a power of two if necessary.

affects: all

Upgrade

Version history

0.0.3latest on PyPI · released Jun 25, 2023

Audit

Dependencies

numpyrequiredConvolution operations rely on numpy arrays

sounddevicerequiredReal-time audio playback/capture

Agent activity

2 hits · last 30 days

node

Resources

githubhttps://github.com/davircarvalho/FIRconv ↗

packagehttps://pypi.org/project/firconv/ ↗