Package: agh-vqis
agh-vqisA Python package computing a set of image quality indicators (IQIs) for a given input video.Following IQIs are included in the package:A set of 15 Video Quality Indicators (VQIs) developed by the team from AGH. See the following website for more information:https://qoe.agh.edu.pl/indicators/.Our Python reimplementation of the Colourfulness IQI. Seethispaper for more information regarding this IQI.Blur Amount IQI. Seepackage's Python Package Index web pagefor more information.UGC IQI (User-generated content).Authors: Jakub Nawała <jakub.nawala@agh.edu.pl>, Filip Korus <fkorus@student.agh.edu.pl>Requirementsffmpeg - version >= 4.4.2Python - version >= 3.9Installationpipinstallagh_vqisUsageSingle multimedia file:fromagh_vqisimportprocess_single_mm_file,VQIsfrompathlibimportPathif__name__=='__main__':process_single_mm_file(Path('/path/to/single/video.mp4'))Folder with multimedia files:fromagh_vqisimportprocess_folder_w_mm_files,VQIsfrompathlibimportPathif__name__=='__main__':process_folder_w_mm_files(Path('/path/to/multimedia/folder/'))Options parameter - in eitherprocess_single_mm_fileandprocess_folder_w_mm_filesfunction options could be provided as an optional argument. It is being passed to function as a dictionary like below.process_single_mm_file(Path('/path/to/single/video.mp4'),options={VQIs.contrast:False,# disable contrast indicatorVQIs.colourfulness:False,# disable colourfulness indicator})How to disable/enable indicators to count? Every indicator isenabled by default exceptblue_amountdue to long computing time. To disable one of following indicators(blockiness, SA, letterbox, pillarbox, blockloss, blur, TA, blackout, freezing, exposure, contrast, interlace, noise, slice, flickering, colourfulness, ugc)passVQIs.indicator_name:Falseto options dictionary. Whereas toenableblur_amountindicator passTruevalue.agh-vqis package could be used from command line interface as well. For example:python3-magh_vqis/path/to/single/movie.mp4# will run VQIS for single fileorpython3-magh_vqis/path/to/multimedia/folder/# will run VQIS for folderWhereas this command will display help:$python3-magh_vqis-hSupported multimedia files:mp4,y4m,mov,mkv,avi,ts,webm,jpg,jpeg,png,gif,bmp.First row of the output CSV file contains header with image quality indicators (IQIs) names, whereas each row below the header represents single video frame from the input video file. Each column provides a numerical result as returned by a given IQI when applied to the respective frame.Cast chosen indicators for different resolutions (experimental). For example: to cast Blur to 1440p and Blockiness to 2160p you should pass two additional lines inoptionsdictionary like below.fromagh_vqisimportprocess_single_mm_file,CastVQI,DestResolutionfrompathlibimportPathif__name__=='__main__':process_single_mm_file(Path('/path/to/single/video.mp4'),options={CastVQI.blur:DestResolution.p1440,CastVQI.blockiness:DestResolution.p2160})Available casts (with percentage of correctness)Blockiness:source resolutiondestination resolutioncorrectness1080p1440p99.80%1080p2160p99.72%1440p2160p99.68%2160p1440p99.81%Blur:source resolutiondestination resolutioncorrectness240p360p93.91%240p480p87.78%360p240p94.28%360p480p98.08%360p720p92.51%480p240p87.68%480p360p98.05%480p720p97.35%720p360p92.69%720p480p97.31%720p1080p80.95%1080p1440p99.12%1080p2160p93.41%1440p1080p99.07%1440p2160p96.24%2160p1080p93.59%2160p1440p96.39%Exposure(bri):source resolutiondestination resolutioncorrectness240p360p97.75%240p480p94.89%240p720p89.71%360p240p97.77%360p480p98.68%360p720p94.83%360p1080p80.37%480p240p94.82%480p360p98.68%480p720p97.80%480p1080p82.90%480p1440p80.40%720p240p89.32%720p360p94.87%720p480p97.85%720p1080p86.99%720p1440p84.66%720p2160p82.34%1080p360p80.71%1080p480p83.41%1080p720p86.88%1080p1440p98.78%1080p2160p96.91%1440p480p80.90%1440p720p84.85%1440p1080p98.83%1440p2160p99.05%2160p720p82.89%2160p1080p96.93%2160p1440p98.98%Contrast:source resolutiondestination resolutioncorrectness240p360p99.83%240p480p99.69%240p720p99.55%240p1080p87.94%240p1440p87.94%240p2160p87.91%360p240p99.85%360p480p99.97%360p720p99.93%360p1080p88.36%360p1440p88.34%360p2160p88.36%480p240p99.73%480p360p99.97%480p720p99.98%480p1080p88.61%480p1440p88.67%480p2160p88.67%720p240p99.61%720p360p99.93%720p480p99.98%720p1080p88.45%720p1440p88.46%720p2160p88.46%1080p240p87.12%1080p360p87.71%1080p480p87.82%1080p720p87.91%1080p1440p99.99%1080p2160p99.99%1440p240p87.13%1440p360p87.72%1440p480p87.85%1440p720p87.92%1440p1080p99.99%1440p2160p100.0%2160p240p87.11%2160p360p87.72%2160p480p87.85%2160p720p87.91%2160p1080p99.99%2160p1440p100.0%Interlace:source resolutiondestination resolutioncorrectness240p360p86.93%360p240p87.19%360p480p88.32%480p360p87.22%480p720p90.80%720p480p91.21%720p1080p82.65%1080p1440p81.35%Noise:source resolutiondestination resolutioncorrectness240p360p88.85%360p240p88.08%360p480p86.33%480p360p85.94%480p720p88.71%720p480p88.12%1080p1440p94.84%1080p2160p80.34%1440p1080p92.28%1440p2160p87.24%2160p1440p88.54%LicenseTheagh-vqisPython package is provided via theEvaluation License Agreement.