2026-06-16 17:42:14 +00:00
2026-06-16 18:38:08 +01:00
2026-06-16 18:38:08 +01:00
2026-06-16 18:38:08 +01:00
2026-06-16 17:42:14 +00:00

SpectralForensics

SpectralForensics is an open-source Python library for image forensic analysis using Fast Fourier Transform (FFT) and frequency-domain feature extraction.

The library was designed to support research in digital image forensics, synthetic media detection, diffusion model analysis, and explainable artificial intelligence (XAI).

Features

SpectralForensics extracts a set of interpretable spectral descriptors from images:

  • Spectral Entropy
  • Anisotropy
  • Dominant Frequency
  • Energy Density
  • High Frequency Ratio
  • Mean Spectral Energy

These descriptors can be used for:

  • AI-generated image detection
  • Deepfake forensics
  • Diffusion model fingerprinting
  • Frequency-domain analysis
  • Explainable machine learning pipelines

Installation

Local installation

py -m pip install -e .


### Future PyPI installation

pip install spectralforensics


## Quick Start

### Extract Features from a Single Image

```python
from spectralforensics import extract_spectral_features

features = extract_spectral_features("image.jpg")

print(features)

Example Output

{
    "filename": "image.jpg",
    "spectral_entropy": 2.31,
    "anisotropy": 0.021,
    "dominant_frequency": 12.7,
    "energy_density": 58210.3,
    "high_frequency_ratio": 0.000091,
    "mean_energy": 58210.3
}

Extract Features from an Entire Folder

from spectralforensics import extract_features_from_folder

df = extract_features_from_folder(
    folder_path="dataset",
    output_csv="results.csv"
)

print(df.head())

Example Output

filename spectral_entropy anisotropy dominant_frequency energy_density high_frequency_ratio
real_001.jpg 1.21 0.012 11.0 91327 0.000037
dalle_001.png 2.50 0.034 16.0 68150 0.000177
flux_001.jpg 2.51 0.019 6.0 61004 0.000064
S
Description
No description provided
Readme 1.5 MiB
Languages
Python 100%