iris-pse-detection 1.0.0

Python port of EA's IRIS - Photosensitive epilepsy risk detection for video content

IRIS-Py

Python port of IRIS - Electronic Arts' photosensitive epilepsy risk detection library.

IRIS analyzes video content to detect flash patterns that may trigger seizures in people with photosensitive epilepsy, based on guidelines from W3C WCAG and ISO 9241-391.

Installation

pip install iris-py

Or for development:

git clone https://github.com/your-repo/iris_py
cd iris_py
uv sync

Usage

iris video.mp4

Or with Python:

from iris_py import VideoAnalyser, Configuration

config = Configuration()
analyser = VideoAnalyser(config)
result = analyser.analyse_video("video.mp4")
print(result.overall_result)

Features

• Luminance flash detection
• Red saturation flash detection
• Transition tracking with 1-second sliding window
• Extended failure detection (4+ seconds)
• Pattern detection (optional)

Note on Accuracy

Due to floating-point precision differences between C++ and Python/NumPy, results may vary slightly from the original IRIS implementation. These differences are minimal and occur at boundary conditions where values are very close to detection thresholds.

Acknowledgments

This project is a Python port of IRIS by Electronic Arts Inc., originally released under the BSD 3-Clause License.

License

MIT License - see LICENSE for details.