neuromorphic-polito · ben9809 · Apr 14, 2026 · Apr 14, 2026 · Apr 14, 2026 · Apr 14, 2026
diff --git a/README.md b/README.md
@@ -28,8 +28,8 @@ Here is a simple example to get started:
 
 ```python
 import numpy as np
-from spikify.filtering import FilterBank
-from spikify.encoding.rate import poisson
+from spikify.filters import FilterBank
+from spikify.encoders.rate import poisson
 
 # Generate a sinusoidal signal
 time = np.linspace(0, 4 * np.pi, 200)

diff --git a/README_PYPI.md b/README_PYPI.md
@@ -26,8 +26,8 @@ Here is a simple example to get started:
 
 ```python
 import numpy as np
-from spikify.filtering import FilterBank
-from spikify.encoding.rate import poisson
+from spikify.filters import FilterBank
+from spikify.encoders.rate import poisson
 
 # Generate a sinusoidal signal
 time = np.linspace(0, 4 * np.pi, 200)

diff --git a/animation.py b/animation.py
@@ -1,7 +1,7 @@
 import numpy as np
 import matplotlib.pyplot as plt
 import imageio.v2 as imageio
-from spikify.encoding.rate import poisson
+from spikify.encoders.rate import poisson
 import os
 
 # Set style for better visualization

diff --git a/codecov.yml b/codecov.yml
@@ -26,32 +26,32 @@ component_management:
     - component_id: temporal_encoding_deconvolution_algorithms
       name: TempEncDeconAlgo
       paths:
-        - "spikify/encoding/temporal/deconvolution/**"
-        - "tests/encoding/temporal/deconvolution/**"
+        - "spikify/encoders/temporal/deconvolution/**"
+        - "tests/encoders/temporal/deconvolution/**"
     - component_id: temporal_encoding_global_referenced_algorithms
       name: TempEncGlobAlgo
       paths:
-        - "spikify/encoding/temporal/global_referenced/**"
-        - "tests/encoding/temporal/global_referenced/**"
+        - "spikify/encoders/temporal/global_referenced/**"
+        - "tests/encoders/temporal/global_referenced/**"
     - component_id: temporal_encoding_contrast_algorithms
       name: TempEncContAlgo
       paths:
-        - "spikify/encoding/temporal/contrast/**"
-        - "tests/encoding/temporal/contrast/**"
+        - "spikify/encoders/temporal/contrast/**"
+        - "tests/encoders/temporal/contrast/**"
     - component_id: temporal_encoding_latency_algorithms
       name: TempEncLatAlgo
       paths:
-        - "spikify/encoding/temporal/latency/**"
-        - "tests/encoding/temporal/latency/**"
+        - "spikify/encoders/temporal/latency/**"
+        - "tests/encoders/temporal/latency/**"
     - component_id: temporal_encoding_rate_algorithms
       name: TempEncRateAlgo
       paths:
-        - "spikify/encoding/rate/**"
-        - "tests/encoding/rate/**"
+        - "spikify/encoders/rate/**"
+        - "tests/encoders/rate/**"
 
-    - component_id: filtering
-      name: Filtering
+    - component_id: filters
+      name: Filters
       paths:
-        - "spikify/filtering/**"
-        - "tests/filtering/**"
+        - "spikify/filters/**"
+        - "tests/filters/**"
 
diff --git a/docs/api/python/encoding/index.rst → docs/api/python/encoders/index.rst b/docs/api/python/encoding/index.rst → docs/api/python/encoders/index.rst
@@ -1,9 +1,9 @@
 .. _encoding:
 
-:octicon:`file-directory;0.9em;sd-mr-1 fill-primary` encoding
+:octicon:`file-directory;0.9em;sd-mr-1 fill-primary` encoders
 =============================================================
 
-The ``encoding`` folder within the spikify library contains the essential components for converting raw data into spike trains, a fundamental step in spiking neural networks. This section is organized to reflect the primary structure of the encoding algorithms included in the library:
+The ``encoders`` module within the spikify library contains the essential components for converting raw data into spike trains, a fundamental step in spiking neural networks. This section is organized to reflect the primary structure of the encoding algorithms included in the library:
 
 - **Rate Coding**: Contains algorithms that convert the intensity of input signals into spike frequency.
 - **Temporal Coding**: Encloses algorithms that encode data based on the precise timing of spikes.

diff --git a/...api/python/encoding/rate_coding/index.rst → ...api/python/encoders/rate_coding/index.rst b/...api/python/encoding/rate_coding/index.rst → ...api/python/encoders/rate_coding/index.rst
diff --git a/...i/python/encoding/rate_coding/poisson.rst → ...i/python/encoders/rate_coding/poisson.rst b/...i/python/encoding/rate_coding/poisson.rst → ...i/python/encoders/rate_coding/poisson.rst
@@ -2,7 +2,7 @@
 
 .. title:: Poisson Algorithm
 
-.. automodule:: spikify.encoding.rate.poisson_algorithm
+.. automodule:: spikify.encoders.rate.poisson_algorithm
    :members: poisson
    :undoc-members:
    :show-inheritance:
diff --git a/...coding/temporal_coding/contrast/index.rst → ...coders/temporal_coding/contrast/index.rst b/...coding/temporal_coding/contrast/index.rst → ...coders/temporal_coding/contrast/index.rst
diff --git a/...emporal_coding/contrast/moving_window.rst → ...emporal_coding/contrast/moving_window.rst b/...emporal_coding/contrast/moving_window.rst → ...emporal_coding/contrast/moving_window.rst
@@ -2,7 +2,7 @@
 
 .. title:: Moving Window
 
-.. automodule:: spikify.encoding.temporal.contrast.moving_window_algorithm
+.. automodule:: spikify.encoders.temporal.contrast.moving_window_algorithm
    :members: moving_window
    :undoc-members:
    :show-inheritance:

diff --git a/...temporal_coding/contrast/step_forward.rst → ...temporal_coding/contrast/step_forward.rst b/...temporal_coding/contrast/step_forward.rst → ...temporal_coding/contrast/step_forward.rst
@@ -2,7 +2,7 @@
 
 .. title:: Step Forward
 
-.. automodule:: spikify.encoding.temporal.contrast.step_forward_algorithm
+.. automodule:: spikify.encoders.temporal.contrast.step_forward_algorithm
    :members: step_forward
    :undoc-members:
    :show-inheritance:
diff --git a/...poral_coding/contrast/threshold_based.rst → ...poral_coding/contrast/threshold_based.rst b/...poral_coding/contrast/threshold_based.rst → ...poral_coding/contrast/threshold_based.rst
@@ -2,7 +2,7 @@
 
 .. title:: Threshold Based Representation
 
-.. automodule:: spikify.encoding.temporal.contrast.threshold_based_algorithm
+.. automodule:: spikify.encoders.temporal.contrast.threshold_based_algorithm
    :members: threshold_based_representation
    :undoc-members:
    :show-inheritance:
diff --git a/...ding/contrast/zero_cross_step_forward.rst → ...ding/contrast/zero_cross_step_forward.rst b/...ding/contrast/zero_cross_step_forward.rst → ...ding/contrast/zero_cross_step_forward.rst
@@ -2,7 +2,7 @@
 
 .. title:: Zero Cross Step Forward
 
-.. automodule:: spikify.encoding.temporal.contrast.zero_cross_step_forward_algorithm
+.. automodule:: spikify.encoders.temporal.contrast.zero_cross_step_forward_algorithm
    :members: tzero_cross_step_forward
    :undoc-members:
    :show-inheritance:
diff --git a/...poral_coding/deconvolution/ben_spiker.rst → ...poral_coding/deconvolution/ben_spiker.rst b/...poral_coding/deconvolution/ben_spiker.rst → ...poral_coding/deconvolution/ben_spiker.rst
@@ -2,7 +2,7 @@
 
 .. title:: Bens Spiker
 
-.. automodule:: spikify.encoding.temporal.deconvolution.bens_spiker_algorithm
+.. automodule:: spikify.encoders.temporal.deconvolution.bens_spiker_algorithm
    :members: bens_spiker
    :undoc-members:
    :show-inheritance:
diff --git a/...ral_coding/deconvolution/hough_spiker.rst → ...ral_coding/deconvolution/hough_spiker.rst b/...ral_coding/deconvolution/hough_spiker.rst → ...ral_coding/deconvolution/hough_spiker.rst
@@ -2,7 +2,7 @@
 
 .. title:: Hough Spiker
 
-.. automodule:: spikify.encoding.temporal.deconvolution.hough_spiker_algorithm
+.. automodule:: spikify.encoders.temporal.deconvolution.hough_spiker_algorithm
    :members: hough_spiker
    :undoc-members:
    :show-inheritance:
diff --git a/...g/temporal_coding/deconvolution/index.rst → ...s/temporal_coding/deconvolution/index.rst b/...g/temporal_coding/deconvolution/index.rst → ...s/temporal_coding/deconvolution/index.rst
diff --git a/...g/deconvolution/modified_hough_spiker.rst → ...g/deconvolution/modified_hough_spiker.rst b/...g/deconvolution/modified_hough_spiker.rst → ...g/deconvolution/modified_hough_spiker.rst
@@ -2,7 +2,7 @@
 
 .. title:: Modified Hough Spiker
 
-.. automodule:: spikify.encoding.temporal.deconvolution.modified_hough_spiker_algorithm
+.. automodule:: spikify.encoders.temporal.deconvolution.modified_hough_spiker_algorithm
    :members: modified_hough_spiker
    :undoc-members:
    :show-inheritance:
diff --git a/...mporal_coding/global_referenced/index.rst → ...mporal_coding/global_referenced/index.rst b/...mporal_coding/global_referenced/index.rst → ...mporal_coding/global_referenced/index.rst
diff --git a/...ding/global_referenced/phase_encoding.rst → ...ding/global_referenced/phase_encoding.rst b/...ding/global_referenced/phase_encoding.rst → ...ding/global_referenced/phase_encoding.rst
@@ -2,7 +2,7 @@
 
 .. title:: Phase Encoding
 
-.. automodule:: spikify.encoding.temporal.global_referenced.phase_encoding_algorithm
+.. automodule:: spikify.encoders.temporal.global_referenced.phase_encoding_algorithm
    :members: phase_encoding
    :undoc-members:
    :show-inheritance:
diff --git a/...global_referenced/time_to_first_spike.rst → ...global_referenced/time_to_first_spike.rst b/...global_referenced/time_to_first_spike.rst → ...global_referenced/time_to_first_spike.rst
@@ -2,7 +2,7 @@
 
 .. title:: Time to First Spike
 
-.. automodule:: spikify.encoding.temporal.global_referenced.time_to_first_spike_algorithm
+.. automodule:: spikify.encoders.temporal.global_referenced.time_to_first_spike_algorithm
    :members: time_to_first_spike
    :undoc-members:
    :show-inheritance:
diff --git a/...python/encoding/temporal_coding/index.rst → ...python/encoders/temporal_coding/index.rst b/...python/encoding/temporal_coding/index.rst → ...python/encoders/temporal_coding/index.rst
diff --git a/.../temporal_coding/latency/burst_coding.rst → .../temporal_coding/latency/burst_coding.rst b/.../temporal_coding/latency/burst_coding.rst → .../temporal_coding/latency/burst_coding.rst
@@ -2,7 +2,7 @@
 
 .. title:: Burst Coding
 
-.. automodule:: spikify.encoding.temporal.latency.burst_coding_algorithm
+.. automodule:: spikify.encoders.temporal.latency.burst_coding_algorithm
    :members: burst_coding
    :undoc-members:
    :show-inheritance:
diff --git a/...ncoding/temporal_coding/latency/index.rst → ...ncoders/temporal_coding/latency/index.rst b/...ncoding/temporal_coding/latency/index.rst → ...ncoders/temporal_coding/latency/index.rst
diff --git a/docs/api/python/filtering/index.rst b/docs/api/python/filtering/index.rst
diff --git a/docs/api/python/filtering/filterbank.rst → docs/api/python/filters/filterbank.rst b/docs/api/python/filtering/filterbank.rst → docs/api/python/filters/filterbank.rst
@@ -2,7 +2,7 @@
 
 .. title:: FilterBank
 
-.. autoclass:: spikify.filtering.filterbank.FilterBank
+.. autoclass:: spikify.filters.filterbank.FilterBank
    :members: 
    :undoc-members:
    :show-inheritance:
diff --git a/docs/api/python/filters/index.rst b/docs/api/python/filters/index.rst
@@ -0,0 +1,12 @@
+.. _filtering:
+
+:octicon:`file-directory;0.9em;sd-mr-1 fill-primary` filters
+=================================================================
+
+The ``filters`` module in the **spikify** library is designed to provide advanced filtering techniques inspired by biological systems. These filters enhance the quality of spike trains by pre-processing the raw data before encoding.
+
+
+.. toctree::
+   :maxdepth: 1
+
+   filterbank
diff --git a/docs/api/python/index.rst b/docs/api/python/index.rst
@@ -19,5 +19,5 @@ Below, you will find links to the specific modules within the Python API:
 .. toctree::
    :maxdepth: 1
 
-   filtering/index
-   encoding/index
+   filters/index
+   encoders/index
diff --git a/docs/index.rst b/docs/index.rst
@@ -142,8 +142,8 @@ Contents
    :caption: Fundamentals
    :maxdepth: 1
 
-   spikify/filtering/index
-   spikify/encoding/index
+   spikify/filters/index
+   spikify/encoders/index
 
 .. toctree::
    :caption: Development

diff --git a/docs/installation.rst b/docs/installation.rst
@@ -54,7 +54,7 @@ It's recommended to install spikify in a virtual environment to avoid conflicts
 
    python -m venv spikify-env
    source spikify-env/bin/activate  # On Windows use `spikify-env\Scripts\activate`
-   pip install spikify
+   pip install innuce-spikify
 
 Getting code from source
 ------------------------

diff --git a/docs/spikify/encoding/index.rst → docs/spikify/encoders/index.rst b/docs/spikify/encoding/index.rst → docs/spikify/encoders/index.rst
diff --git a/docs/spikify/encoding/rate/index.rst → docs/spikify/encoders/rate/index.rst b/docs/spikify/encoding/rate/index.rst → docs/spikify/encoders/rate/index.rst
diff --git a/docs/spikify/encoding/rate/poisson_rate.rst → docs/spikify/encoders/rate/poisson_rate.rst b/docs/spikify/encoding/rate/poisson_rate.rst → docs/spikify/encoders/rate/poisson_rate.rst
diff --git a/...kify/encoding/temporal/contrast/index.rst → ...kify/encoders/temporal/contrast/index.rst b/...kify/encoding/temporal/contrast/index.rst → ...kify/encoders/temporal/contrast/index.rst
diff --git a/...oding/temporal/contrast/moving_window.rst → ...oders/temporal/contrast/moving_window.rst b/...oding/temporal/contrast/moving_window.rst → ...oders/temporal/contrast/moving_window.rst
diff --git a/...coding/temporal/contrast/step_forward.rst → ...coders/temporal/contrast/step_forward.rst b/...coding/temporal/contrast/step_forward.rst → ...coders/temporal/contrast/step_forward.rst
diff --git a/...ing/temporal/contrast/threshold_based.rst → ...ers/temporal/contrast/threshold_based.rst b/...ing/temporal/contrast/threshold_based.rst → ...ers/temporal/contrast/threshold_based.rst
diff --git a/...oral/contrast/zero_cross_step_forward.rst → ...oral/contrast/zero_cross_step_forward.rst b/...oral/contrast/zero_cross_step_forward.rst → ...oral/contrast/zero_cross_step_forward.rst
diff --git a/...ing/temporal/deconvolution/ben_spiker.rst → ...ers/temporal/deconvolution/ben_spiker.rst b/...ing/temporal/deconvolution/ben_spiker.rst → ...ers/temporal/deconvolution/ben_spiker.rst
diff --git a/...g/temporal/deconvolution/hough_spiker.rst → ...s/temporal/deconvolution/hough_spiker.rst b/...g/temporal/deconvolution/hough_spiker.rst → ...s/temporal/deconvolution/hough_spiker.rst
diff --git a/...encoding/temporal/deconvolution/index.rst → ...encoders/temporal/deconvolution/index.rst b/...encoding/temporal/deconvolution/index.rst → ...encoders/temporal/deconvolution/index.rst
diff --git a/...l/deconvolution/modified_hough_spiker.rst → ...l/deconvolution/modified_hough_spiker.rst b/...l/deconvolution/modified_hough_spiker.rst → ...l/deconvolution/modified_hough_spiker.rst
diff --git a/...ding/temporal/global_referenced/index.rst → ...ders/temporal/global_referenced/index.rst b/...ding/temporal/global_referenced/index.rst → ...ders/temporal/global_referenced/index.rst
diff --git a/...oral/global_referenced/phase_encoding.rst → ...oral/global_referenced/phase_encoding.rst b/...oral/global_referenced/phase_encoding.rst → ...oral/global_referenced/phase_encoding.rst
diff --git a/...global_referenced/time_to_first_spike.rst → ...global_referenced/time_to_first_spike.rst b/...global_referenced/time_to_first_spike.rst → ...global_referenced/time_to_first_spike.rst
diff --git a/docs/spikify/encoding/temporal/index.rst → docs/spikify/encoders/temporal/index.rst b/docs/spikify/encoding/temporal/index.rst → docs/spikify/encoders/temporal/index.rst
diff --git a/...ncoding/temporal/latency/burst_coding.rst → ...ncoders/temporal/latency/burst_coding.rst b/...ncoding/temporal/latency/burst_coding.rst → ...ncoders/temporal/latency/burst_coding.rst
diff --git a/...ikify/encoding/temporal/latency/index.rst → ...ikify/encoders/temporal/latency/index.rst b/...ikify/encoding/temporal/latency/index.rst → ...ikify/encoders/temporal/latency/index.rst
diff --git a/docs/spikify/filtering/index.rst b/docs/spikify/filtering/index.rst
diff --git a/docs/spikify/filters/index.rst b/docs/spikify/filters/index.rst
@@ -0,0 +1,18 @@
+.. _filtering_desc:
+
+Filtering
+=========
+
+Preprocessing tools for conditioning time-varying signals before spike encoding.
+Frequency decomposition techniques inspired by biological sensory systems break down input signals into multiple frequency channels to improve spike train quality and encoding performance.
+
+Filter Types
+------------
+
+- **Gammatone**: Bandpass filterbank approximating the frequency selectivity of the basilar membrane. Suitable for audio and speech signals where cochlear-like decomposition is required.
+- **Butterworth**: IIR filterbank with a maximally flat passband response. Suitable for general-purpose signal conditioning and noise attenuation prior to encoding.
+
+Each filter can be configured with parameters such as center frequency, bandwidth, and order. All filters are
+implemented as filter banks, decomposing the input signal into multiple frequency channels simultaneously.
+
+For implementation details and usage examples, refer to the :ref:`FilterBank <filterbank_class>` documentation.
diff --git a/docs/tutorial.rst b/docs/tutorial.rst
@@ -24,7 +24,7 @@ Before encoding, you may want to filter the signal to focus on specific frequenc
 
 .. code-block:: python
 
-   from spikify.filtering import FilterBank
+   from spikify.filters import FilterBank
 
    filter = FilterBank(fs=50, channels=5, f_min=0.5, f_max=5, order=4, filter_type='butterworth')
 
@@ -39,7 +39,7 @@ Now, let's encode the sinusoidal signal into spikes using the `poisson` method.
 
 .. code-block:: python
 
-   from spikify.encoding.rate import poisson
+   from spikify.encoders.rate import poisson
 
    # Set parameters for encoding
    np.random.seed(0)  # For reproducibility

diff --git a/examples/wisdm/encode.py b/examples/wisdm/encode.py
@@ -1,15 +1,15 @@
 from pathlib import Path
 import numpy as np
-from spikify.encoding.rate import poisson_rate
-from spikify.encoding.temporal.latency import burst_encoding
-from spikify.encoding.temporal.contrast import (
+from spikify.encoders.rate import poisson_rate
+from spikify.encoders.temporal.latency import burst_encoding
+from spikify.encoders.temporal.contrast import (
     moving_window,
     step_forward,
     threshold_based_representation,
     zero_cross_step_forward,
 )
-from spikify.encoding.temporal.global_referenced import phase_encoding, time_to_first_spike
-from spikify.encoding.temporal.deconvolution import bens_spiker, hough_spiker, modified_hough_spiker
+from spikify.encoders.temporal.global_referenced import phase_encoding, time_to_first_spike
+from spikify.encoders.temporal.deconvolution import bens_spiker, hough_spiker, modified_hough_spiker
 from datasets import load_dataset
 
 REPO_ID = "neuromorphic-polito/siddha"

diff --git a/spikify/encoders/__init__.py b/spikify/encoders/__init__.py
@@ -0,0 +1 @@
+"""Encoders package."""
diff --git a/spikify/encoding/rate/__init__.py → spikify/encoders/rate/__init__.py b/spikify/encoding/rate/__init__.py → spikify/encoders/rate/__init__.py
diff --git a/spikify/encoding/rate/poisson_algorithm.py → spikify/encoders/rate/poisson_algorithm.py b/spikify/encoding/rate/poisson_algorithm.py → spikify/encoders/rate/poisson_algorithm.py
@@ -31,7 +31,7 @@ def poisson(signal: np.ndarray, interval_length: int, seed: int = 0) -> np.ndarr
     .. code-block:: python
 
             import numpy as np
-            from spikify.encoding.rate import poisson
+            from spikify.encoders.rate import poisson
             signal = np.array([0.2, 0.5, 0.8, 1.0])
             np.random.seed(0)
             interval_length = 2
@@ -41,7 +41,7 @@ def poisson(signal: np.ndarray, interval_length: int, seed: int = 0) -> np.ndarr
         :hide:
 
         >>> import numpy as np
-        >>> from spikify.encoding.rate import poisson
+        >>> from spikify.encoders.rate import poisson
         >>> # Example with numpy array
         >>> signal = np.array([0.2, 0.5, 0.8, 1.0])
         >>> interval_length = 2

diff --git a/spikify/encoding/temporal/__init__.py → spikify/encoders/temporal/__init__.py b/spikify/encoding/temporal/__init__.py → spikify/encoders/temporal/__init__.py
diff --git a/...fy/encoding/temporal/contrast/__init__.py → ...fy/encoders/temporal/contrast/__init__.py b/...fy/encoding/temporal/contrast/__init__.py → ...fy/encoders/temporal/contrast/__init__.py
diff --git a/...poral/contrast/moving_window_algorithm.py → ...poral/contrast/moving_window_algorithm.py b/...poral/contrast/moving_window_algorithm.py → ...poral/contrast/moving_window_algorithm.py
@@ -25,7 +25,7 @@ def moving_window(
     .. code-block:: python
 
         import numpy as np
-        from spikify.encoding.temporal.contrast import moving_window
+        from spikify.encoders.temporal.contrast import moving_window
         signal = np.array([0.1, 0.3, 0.2, 0.5, 0.8, 1.0])
         window_length = 3
         threshold = 0.2
@@ -36,7 +36,7 @@ def moving_window(
         :hide:
 
         >>> import numpy as np
-        >>> from spikify.encoding.temporal.contrast import moving_window
+        >>> from spikify.encoders.temporal.contrast import moving_window
         >>> signal = np.array([0.1, 0.3, 0.2, 0.5, 0.8, 1.0])
         >>> window_length = 3
         >>> threshold = 0.2