Files
spectralforensics/README.md
T
2026-07-22 20:04:52 +01:00

2.2 KiB

# 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 |