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 18:38:08 +01:00
2026-06-16 18:38:08 +01: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

Supported Image Formats

The library currently supports:

JPG

JPEG

PNG

BMP

TIFF

WEBP

Additional formats can easily be added.

Quick Start

Extract features from a single image

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

Spectral Features

Spectral Entropy

Measures the randomness of the spectral energy distribution.

Higher values generally indicate a more dispersed frequency distribution.

Anisotropy

Measures directional imbalance of spectral energy.

Can reveal artificial directional patterns introduced by generative models.

Dominant Frequency

Represents the strongest non-DC frequency component in the Fourier spectrum.

Energy Density

Measures the amount of spectral energy normalized by image size.

High Frequency Ratio

Measures the proportion of energy located in high-frequency regions.

Useful for detecting residual artefacts and synthetic textures.

Scientific Background

Diffusion-based generative models such as:

Stable Diffusion

FLUX

DALL·E

Midjourney

generate images through iterative denoising processes.

Although visually realistic, these models may introduce latent frequency-domain artefacts that remain detectable through Fourier analysis.

SpectralForensics aims to provide an explainable framework for investigating these spectral fingerprints and supporting synthetic media detection research.

Research Applications

Potential applications include:

Digital Image Forensics

Deepfake Detection

AI-Generated Content Verification

Synthetic Media Analysis

Explainable AI (XAI)

Frequency-Domain Machine Learning

Cybersecurity Research

Roadmap

Future planned features:

Radial Distribution Analysis

Spectral Heatmaps

Average FFT Fingerprints

Statistical Validation (t-test, ANOVA, Mann–Whitney)

Random Forest Classification

SVM Classification

XGBoost Classification

Diffusion Model Attribution

Batch Processing Pipelines

S

S
Description
No description provided
Readme 1.5 MiB
Languages
Python 100%