aifourier 0.1.0__tar.gz

aifourier-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Jovan-AIcoder
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

aifourier-0.1.0/PKG-INFO

@@ -0,0 +1,17 @@
+Metadata-Version: 2.4
+Name: aifourier
+Version: 0.1.0
+Summary: AI-based Fourier Analysis using sinusoidal neural networks
+Author: Jovan
+Requires-Python: >=3.8
+License-File: LICENSE
+Requires-Dist: numpy
+Requires-Dist: pandas
+Requires-Dist: matplotlib
+Requires-Dist: tensorflow
+Requires-Dist: librosa
+Dynamic: author
+Dynamic: license-file
+Dynamic: requires-dist
+Dynamic: requires-python
+Dynamic: summary

aifourier-0.1.0/README.md

@@ -0,0 +1,143 @@
+# AI-Based Fourier Analysis (aifourier)
+
+> *“Machines can learn Fourier analysis.”*
+
+A Python library that approximates Fourier decomposition using a sinusoidal neural network.
+
+Instead of explicitly computing Fourier integrals, this library **learns** the frequency components of a signal through optimization.
+
+---
+
+## ✨ Features
+
+* 🔊 Analyze audio signals (`.wav`, `.mp3`, `.flac`, `.ogg`)
+* 🧠 Neural network with sinusoidal activation
+* 📊 Extract:
+
+  * Angular frequency
+  * Phase shift
+  * Amplitude
+* ⚡ Simple one-line API
+* 📁 Output as Pandas DataFrame
+
+---
+
+## 📦 Installation
+
+```bash
+pip install aifourier
+```
+
+---
+
+## 🚀 Usage
+
+```python
+import aifourier as aif
+
+df = aif.analyze("audio.mp3", max_modes=128, epochs=300)
+
+print(df.head())
+```
+
+---
+
+## 📊 Output
+
+The result is a DataFrame containing:
+
+| Column      | Description                        |
+| ----------- | ---------------------------------- |
+| Frequencies | Learned angular frequencies (ω)    |
+| Phase shift | Phase of each component            |
+| Amplitudes  | Contribution strength of each mode |
+
+---
+
+## 🧠 How It Works
+
+The signal is approximated as:
+
+y(t) ≈ Σ Aᵢ sin(ωᵢ t + φᵢ)
+
+Where:
+
+* Aᵢ = amplitude
+* ωᵢ = frequency
+* φᵢ = phase
+
+These parameters are learned by a neural network instead of computed analytically.
+
+---
+
+## ⚙️ Parameters
+
+```python
+aif.analyze(audio_path, max_modes=128, epochs=64)
+```
+
+* `audio_path` : Path to audio file
+* `max_modes`  : Number of sinusoidal components
+* `epochs`     : Training iterations (higher = better approximation)
+
+---
+
+## 📁 Example
+
+See the `examples/` folder for a complete demo:
+
+```bash
+cd examples
+python example.py
+```
+
+This will:
+
+* Analyze `bird.mp3`
+* Generate frequency components
+* Save results
+* Plot the spectrum
+
+---
+
+## ⚖️ Comparison with FFT
+
+| Method    | Approach                    |
+| --------- | --------------------------- |
+| FFT       | Analytical, deterministic   |
+| aifourier | Learning-based, approximate |
+
+This project explores whether neural networks can **discover Fourier structure from data**.
+
+---
+
+## 🚧 Limitations
+
+* Approximation quality depends on training
+* Slower than FFT
+* Results may vary between runs
+
+---
+
+## 💡 Future Ideas
+
+* Signal reconstruction from learned parameters
+* FFT comparison mode
+* Real-time signal analysis (oscilloscope / radio)
+* Complex-valued extensions
+
+---
+
+## 👤 Author
+
+Jovan
+
+---
+
+## 📜 License
+
+MIT License
+
+---
+
+> *“What Fourier derives analytically, neural networks can approximate through learning.”*

aifourier-0.1.0/aifourier/__init__.py

@@ -0,0 +1,3 @@
+from .analyzer import analyze
+
+__all__ = ["analyze"]

aifourier-0.1.0/aifourier/analyzer.py

@@ -0,0 +1,45 @@
+import os
+import pandas as pd
+import librosa
+import numpy as np
+from tensorflow import keras
+from tensorflow import math
+def analyze(audio_path,max_modes=128,epochs=64):
+    # error handling
+    if not isinstance(audio_path, str):
+        raise ValueError('Audio path must be a string.')
+    if not isinstance(max_modes, int) or max_modes <= 0:
+        raise ValueError('Max modes must be a positive integer.')
+    if not isinstance(epochs, int) or epochs <= 0:
+        raise ValueError('Epochs must be a positive integer.')
+    try:
+        if not os.path.isfile(audio_path):
+            raise ValueError("Audio file not found.")
+    except Exception as e:
+        raise ValueError(f'Error accessing audio file: {e}')
+    if not audio_path.endswith(('.wav', '.mp3', '.flac', '.ogg')):
+        raise ValueError('Unsupported audio format. Supported formats are: .wav, .mp3, .flac, .ogg')
+    # audio sampling
+    print('Sampling the audio signal...')
+    a, b = librosa.load(audio_path, mono=True)
+    duration = librosa.get_duration(y=a, sr=b)
+    time = np.linspace(0, duration, len(a))
+    df = pd.DataFrame({'time': time,'amplitude': a})
+    t = df['time'] * 1000000 # convert to microseconds
+    y = df['amplitude']
+    print('Audio signal sampled successfully.')
+    # analyze the audio signal
+    model = keras.Sequential([
+        keras.layers.Dense(max_modes, activation=math.sin, input_shape=(1,)),
+        keras.layers.Dense(1,use_bias=False)
+    ])
+    model.compile(optimizer='adam', loss='mean_squared_error')
+    print('Analyzing the audio signal...')
+    model.fit(t.values.reshape(-1, 1), y.values, epochs=epochs)
+    weights, biases = model.layers[0].get_weights()
+    amplitudes = model.layers[1].get_weights()[0]
+    weights_flat = weights[0]
+    df_freq = pd.DataFrame({'Frequencies': weights_flat,'Phase shift': biases,'Amplitudes': amplitudes.flatten()})
+    df_freq.index = [f'Frequency_{i}' for i in range(len(biases))]
+    print('Audio signal analyzed successfully.')
+    return df_freq

aifourier-0.1.0/aifourier.egg-info/PKG-INFO

@@ -0,0 +1,17 @@
+Metadata-Version: 2.4
+Name: aifourier
+Version: 0.1.0
+Summary: AI-based Fourier Analysis using sinusoidal neural networks
+Author: Jovan
+Requires-Python: >=3.8
+License-File: LICENSE
+Requires-Dist: numpy
+Requires-Dist: pandas
+Requires-Dist: matplotlib
+Requires-Dist: tensorflow
+Requires-Dist: librosa
+Dynamic: author
+Dynamic: license-file
+Dynamic: requires-dist
+Dynamic: requires-python
+Dynamic: summary

aifourier-0.1.0/aifourier.egg-info/SOURCES.txt

@@ -0,0 +1,11 @@
+LICENSE
+README.md
+pyproject.toml
+setup.py
+aifourier/__init__.py
+aifourier/analyzer.py
+aifourier.egg-info/PKG-INFO
+aifourier.egg-info/SOURCES.txt
+aifourier.egg-info/dependency_links.txt
+aifourier.egg-info/requires.txt
+aifourier.egg-info/top_level.txt

aifourier-0.1.0/aifourier.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

aifourier-0.1.0/aifourier.egg-info/requires.txt

@@ -0,0 +1,5 @@
+numpy
+pandas
+matplotlib
+tensorflow
+librosa

aifourier-0.1.0/aifourier.egg-info/top_level.txt

@@ -0,0 +1 @@
+aifourier

aifourier-0.1.0/pyproject.toml

@@ -0,0 +1,3 @@
+[build-system]
+requires = ["setuptools", "wheel"]
+build-backend = "setuptools.build_meta"

aifourier-0.1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

aifourier-0.1.0/setup.py

@@ -0,0 +1,17 @@
+from setuptools import setup, find_packages
+
+setup(
+    name="aifourier",
+    version="0.1.0",
+    description="AI-based Fourier Analysis using sinusoidal neural networks",
+    author="Jovan",
+    packages=find_packages(),
+    install_requires=[
+        "numpy",
+        "pandas",
+        "matplotlib",
+        "tensorflow",
+        "librosa"
+    ],
+    python_requires=">=3.8",
+)