This repository contains scripts for automating analysis of QCTools reports.
-
qct-parse.py
Finds frames that exceed thresholds for QCTool tag(s). Detect color bars with the-bdoption. -
makeqctoolsreport.py
Generates a QCTools.xml.gzreport for a given input video file.
Run a single tag against a supplied value or multiple tags using a config file (qct-parse_[#]bit_config.txt).
| Argument | Description |
|---|---|
-h, --help |
Show this help message and exit |
-i, --input |
Path to the input qctools.xml.gz or qctools.mkv file |
-t, --tagname |
The tag name you want to test (e.g., SATMAX); see table of tag names below for list |
-o, --over |
Threshold overage number |
-u, --under |
Threshold under number |
-p, --profile |
Compare frame data against tag values from config.txt. Use -p default for QCTools default values |
-buff, --buffSize |
Circular buffer size. If even, defaults to the next odd number (default: 11) |
-te, --thumbExport |
Enable/disable thumbnail export (default: off) |
-ted, --thumbExportDelay |
Minimum frames between exported thumbnails (default: 9000) |
-tep, --thumbExportPath |
Path to thumbnail export. Uses input base-path if omitted |
-ds, --durationStart |
Start analysis from this time (seconds, equivalent to ffmpeg -ss) |
-de, --durationEnd |
End analysis after this time (seconds, equivalent to ffmpeg -t) |
-bd, --barsDetection |
Enable/disable bar detection (default: off) |
-be, --barsEvaluation |
Use peak values from color bars as 'profile' if bars are detected |
-pr, --print |
Print over/under frame data to console (default: off) |
-q, --quiet |
Suppress ffmpeg output in console (default: off) |
| Tag category | Tag names |
|---|---|
| YUV values | YMIN,YLOW,YAVG,YHIGH,YMAXUMIN,ULOW,UAVG,UHIGH,UMAXVMIN,VLOW,VAVG,VHIGH,VMAX |
| YUV values (difference) | YDIF,UDIF,VDIF |
| Saturation values | SATMIN,SATLOW,SATAVG,SATHIGH,SATMAX |
| Hue values | HUEMED,HUEAVG |
| Temporal outliers | TOUT |
| Vertical line repetitions | VREP |
| Broadcast range | BRNG |
| Mean square error fields | mse_y,mse_u,mse_v,mse_avg |
| Peak signal to noise ratio fields | psnr_y,psnr_u,psnr_v,psnr_avg |
python qct-parse.py -t SATMAX -o 235 -t YMIN -u 16 -i /path/to/report.mkv.qctools.xml.gzpython qct-parse.py -bd -p default -i /path/to/report.mkv.qctools.mkvpython qct-parse.py -p default -te -tep /path/to/export/folder -i /path/to/report.mkv.qctools.xml.gzpython qct-parse.py -bd -be -i /path/to/report.mkv.qctools.xml.gzqct-parse.py will work with the following QCTools report formats:
qctools.xml.gz
qctools.mkv
If the qctools.xml.gz report is in an MKV attachment, the qctools.xml.gz report file will be extracted and saved as a separate file.
Both 8-bit and 10-bit values are supported. The bit depth will be detected automatically, and does not need to be specified.
If you wish to edit the profiles stored in the config.txt files, please note that there is a separate config.txt for 8-bit and 10-bit values.
In order to export thumbnails, the QCTools report must be in the same directory as the video file it is describing, and must have the same file name as the report (excluding the qctools.xml.gz).
A log file is created with the same name as the input file but with a '.log' extension.
For example: some_video_file.mkv.qctools.xml.gz.log
Log files contain every instance of values over the specified threshold. For example:
2024-10-03 17:02:35,737 SATMAX is over 181.02 with a value of 698.0 at duration 00:00:16.4500
A Python port of Morgan’s makeqctoolsreport.as, this script generates QCTools .xml.gz reports from input video files.
python makeqctoolsreport.py /path/to/input.mxfEnsure Python 3.x.x is installed.
Requires FFmpeg.
Additionally, install the lxml library:
pip install lxmlFor more information on lxml usage, check out the lxml documentation.