This is a reference implementation for IEEE P2020 flicker IQF metrics. The code is currently in beta testing - feel free to download, use and provide feedback.
A full description of the P2020 flicker IQFs is available in the IEEE P2020 pre-release (https://www.techstreet.com/ieee/standards/ieee-p2020?gateway_code=ieee&vendor_id=6765&product_id=2505612)
The IQFs calculated by this code are:
- Flicker modulation index (FMI)
- Flicker detection index (FDI)
- Modulation mitigation probability (MMP)
Use pip install -r requirements.txt to install the necessary dependencies.
The code has been tested on Python 3.8.
Once the dependencies are installed, flicker IQFs can be calculated as follows:
Define ROIs. For the sample videos, an Image Engineering DTS target is used, but the code can easily be adapted to work with any target. Use the sample script "def_rois_demo.py" to manually define measurement ROIs. The selected ROI locations are stored to a .pkl file
Calculate P2020 metrics
- FMI, FDI, MMP all calculated
- Saturation warning is included
- Save to csv file
- Save output figures
To Do:
- Read in target luminance file and plot results vs luminance
- Code reviews, etc