spectralforensics
This commit is contained in:
@@ -1,8 +1,8 @@
|
||||
SpectralForensics
|
||||
\# SpectralForensics
|
||||
|
||||
|
||||
|
||||
SpectralForensics is an open-source Python library for image forensic analysis using Fast Fourier Transform (FFT) and frequency-domain feature extraction.
|
||||
SpectralForensics is an open-source Python library for image forensic analysis using \*\*Fast Fourier Transform (FFT)\*\* and frequency-domain feature extraction.
|
||||
|
||||
|
||||
|
||||
@@ -10,7 +10,7 @@ The library was designed to support research in digital image forensics, synthet
|
||||
|
||||
|
||||
|
||||
Features
|
||||
\## Features
|
||||
|
||||
|
||||
|
||||
@@ -18,17 +18,17 @@ SpectralForensics extracts a set of interpretable spectral descriptors from imag
|
||||
|
||||
|
||||
|
||||
Spectral Entropy
|
||||
\- Spectral Entropy
|
||||
|
||||
Anisotropy
|
||||
\- Anisotropy
|
||||
|
||||
Dominant Frequency
|
||||
\- Dominant Frequency
|
||||
|
||||
Energy Density
|
||||
\- Energy Density
|
||||
|
||||
High Frequency Ratio
|
||||
\- High Frequency Ratio
|
||||
|
||||
Mean Spectral Energy
|
||||
\- Mean Spectral Energy
|
||||
|
||||
|
||||
|
||||
@@ -36,105 +36,115 @@ These descriptors can be used for:
|
||||
|
||||
|
||||
|
||||
AI-generated image detection
|
||||
\- AI-generated image detection
|
||||
|
||||
Deepfake forensics
|
||||
\- Deepfake forensics
|
||||
|
||||
Diffusion model fingerprinting
|
||||
\- Diffusion model fingerprinting
|
||||
|
||||
Frequency-domain analysis
|
||||
\- Frequency-domain analysis
|
||||
|
||||
Explainable machine learning pipelines
|
||||
\- Explainable machine learning pipelines
|
||||
|
||||
Installation
|
||||
|
||||
Local installation
|
||||
|
||||
\## Installation
|
||||
|
||||
|
||||
|
||||
\### Local installation
|
||||
|
||||
|
||||
|
||||
```bash
|
||||
|
||||
py -m pip install -e .
|
||||
|
||||
Future PyPI installation
|
||||
|
||||
|
||||
|
||||
|
||||
\\### Future PyPI installation
|
||||
|
||||
|
||||
|
||||
pip install spectralforensics
|
||||
|
||||
Supported Image Formats
|
||||
|
||||
|
||||
|
||||
The library currently supports:
|
||||
|
||||
\\## Quick Start
|
||||
|
||||
|
||||
|
||||
JPG
|
||||
|
||||
JPEG
|
||||
|
||||
PNG
|
||||
|
||||
BMP
|
||||
|
||||
TIFF
|
||||
|
||||
WEBP
|
||||
\\### Extract Features from a Single Image
|
||||
|
||||
|
||||
|
||||
Additional formats can easily be added.
|
||||
```python
|
||||
|
||||
from spectralforensics import extract\\\_spectral\\\_features
|
||||
|
||||
|
||||
|
||||
Quick Start
|
||||
|
||||
Extract features from a single image
|
||||
|
||||
from spectralforensics import extract\_spectral\_features
|
||||
|
||||
|
||||
|
||||
features = extract\_spectral\_features(
|
||||
|
||||
  "image.jpg"
|
||||
|
||||
)
|
||||
features = extract\\\_spectral\\\_features("image.jpg")
|
||||
|
||||
|
||||
|
||||
print(features)
|
||||
|
||||
```
|
||||
|
||||
|
||||
Example output:
|
||||
|
||||
\### Example Output
|
||||
|
||||
|
||||
|
||||
```python
|
||||
|
||||
{
|
||||
|
||||
  "filename": "image.jpg",
|
||||
\  "filename": "image.jpg",
|
||||
|
||||
  "spectral\_entropy": 2.31,
|
||||
\  "spectral\\\_entropy": 2.31,
|
||||
|
||||
  "anisotropy": 0.021,
|
||||
\  "anisotropy": 0.021,
|
||||
|
||||
  "dominant\_frequency": 12.7,
|
||||
\  "dominant\\\_frequency": 12.7,
|
||||
|
||||
  "energy\_density": 58210.3,
|
||||
\  "energy\\\_density": 58210.3,
|
||||
|
||||
  "high\_frequency\_ratio": 0.000091,
|
||||
\  "high\\\_frequency\\\_ratio": 0.000091,
|
||||
|
||||
  "mean\_energy": 58210.3
|
||||
\  "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"
|
||||
|
||||
\### 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"
|
||||
|
||||
)
|
||||
|
||||
@@ -142,151 +152,21 @@ df = extract\_features\_from\_folder(
|
||||
|
||||
print(df.head())
|
||||
|
||||
```
|
||||
|
||||
|
||||
Example output:
|
||||
|
||||
\### 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
|
||||
| filename | spectral\_entropy | anisotropy | dominant\_frequency | energy\_density | high\_frequency\_ratio |
|
||||
|
||||
dalle\_001.png 2.50 0.034 16.0 68150 0.000177
|
||||
|-----------|----------------|------------|-------------------|----------------|---------------------|
|
||||
|
||||
flux\_001.jpg 2.51 0.019 6.0 61004 0.000064
|
||||
| real\_001.jpg | 1.21 | 0.012 | 11.0 | 91327 | 0.000037 |
|
||||
|
||||
Spectral Features
|
||||
| dalle\_001.png | 2.50 | 0.034 | 16.0 | 68150 | 0.000177 |
|
||||
|
||||
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
|
||||
| flux\_001.jpg | 2.51 | 0.019 | 6.0 | 61004 | 0.000064 |
|
||||
|
||||
|
||||
Reference in New Issue
Block a user