187 lines
2.6 KiB
Plaintext
187 lines
2.6 KiB
Plaintext
Metadata-Version: 2.4
|
|
Name: spectralforensics
|
|
Version: 0.1.0
|
|
Summary: Explainable spectral forensic analysis
|
|
Author: José Garcia, Patricio Rodrigues, Carlos Grilo, Rolando Miragaia
|
|
Maintainer-email: José Garcia <2023144112@my.ipleiria.pt>
|
|
Requires-Python: >=3.10
|
|
Description-Content-Type: text/markdown
|
|
Requires-Dist: numpy
|
|
Requires-Dist: pillow
|
|
Requires-Dist: pandas
|
|
Requires-Dist: scipy
|
|
Requires-Dist: matplotlib
|
|
|
|
\# 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 |
|
|
|