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
Requires-Dist: scikit-image

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

{

\&#x20;   "filename": "image.jpg",

\&#x20;   "spectral\\\_entropy": 2.31,

\&#x20;   "anisotropy": 0.021,

\&#x20;   "dominant\\\_frequency": 12.7,

\&#x20;   "energy\\\_density": 58210.3,

\&#x20;   "high\\\_frequency\\\_ratio": 0.000091,

\&#x20;   "mean\\\_energy": 58210.3

}

```



\---



\### Extract Features from an Entire Folder



```python

from spectralforensics import extract\\\_features\\\_from\\\_folder



df = extract\\\_features\\\_from\\\_folder(

\&#x20;   folder\\\_path="dataset",

\&#x20;   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 |

