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

173 lines
2.2 KiB
Markdown

\# 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
```bash
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
```python
{
\  "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
```python
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 |