iris-pse-detection 1.1.0

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

IRIS-PSE-Detection

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-pse-detection

Or for development:

git clone https://github.com/tokoroten/iris-pse-detection
cd iris-pse-detection
uv sync

Usage

iris video.mp4

Or with Python:

from iris_pse_detection 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.