Arbitrary Charts

Arbitrary Charts Video Analysis

Current Documentation
View previous documentation
View legacy documentation
All documentation versions

Analyses & OutputINI settingsChart Definition Files – Chart Definition Utility  – Video Analysis

 

Overview

Starting in 23.1, Arbitrary Charts video analysis is supported in Imatest Master. Supported video files can be loaded into the Arbitrary Charts module to perform batch processing of individual frames or analysis of a single, signal averaged image. For batch processing of individual frames, a video analysis results JSON file containing auto exposure measurements will be output. A sample video and chart definition file can be downloaded from the Imatest Charts repository on GitHub.

Workflow

1. Load a video into Imatest Master then choose Arbitrary Charts analysis.

2. For auto exposure analysis, choose Read individual frame(s) for comprehensive analysis then specify the beginning and end points for analysis with the Mark In and Mark Out buttons. Click Yes, Continue to return to the Arbitrary Charts window. The first frame corresponding to the video “In Point” will be displayed in the Arbitrary Charts analysis window.

3. Load in the chart definition JSON then verify that Perform Video Analysis is enabled in the Video Analysis section of the Arbitrary Charts analysis window. It is recommended to check the Use the same ROI for every frame? option when analyzing a video of a static scene to reduce the computational runtime.

4. Click Run Analysis and confirm the chart alignment by clicking Continue on the Automatic Alignment Confirmation window. The Imatest Analysis Progress window will provide updates on the analysis. In addition to the individual frame results or batch results, a VideoAnalysis JSON containing auto exposure results can also be found in the last output folder.

Video Analysis Results

Auto Exposure

 

 

Field Name Units Format Description
Patch_Index 1 x num_patches, integer List of gray scale patches used for auto exposure analysis. Gray scale patches are defined as ColorPatchFeatures with reference L*a*b* values within 5 ΔC of [50, 0, 0]. The indices listed are consistent with the provided chart definition file.
Frame_Times_seconds seconds 1 x num_frames, double Time in seconds of each frame analyzed.
Scene_Change_Onset_seconds seconds 1 x num_patches, double Time of initial scene change in seconds, determined from measured L* values for each patch.
Scene_Change_Time_seconds seconds 1 x num_patches, double Duration of initial scene change in seconds measured as 10-90% rise time or 90-10% fall time.
Scene_Change_Rise_or_fall 1 x num_patches, string “10-90% Rise Time” or “90-10% Fall Time” to indicate whether initial scene change was an increase in L* or decrease in L*.
Convergence_Time_Onset_seconds seconds 1 x num_patches, double Time in seconds at which convergence occurs. Convergence is defined as the first frame of the first window which all L* measurements fall within ± 5% of the mean(L*) across that window. The window size is equal to 1/3 of a second (num_frames = 1/3 * video_fps), bounded by a minimum value of 10 frames and maximum value of 50 frames.
Convergence_Time_seconds seconds 1 x num_patches, double Time in seconds between scene change onset and convergence onset.
Convergence_Target 1 x num_patches, logical Indicates whether the convergent L* value falls within ± 10% of the reference L* value.
Convergence_Stability Perceptual Lightness 1 x num_patches, double Standard deviation of L* after convergence is achieved.
VCX_version 1×1, string VCX-Forum specification version.
Patch_Index_VCX 1×1, integer Index of gray scale patch with a reference L*a*b* value closest to [66.89, -0.75, -0.6], which corresponds to patch 21 of the X-Rite ColorChecker Classic. The index is consistent with the provided chart definition file.
Scene_Change_Onset_VCX_seconds seconds 1×1, double Time of initial scene change in seconds, as determined by the VCX convergence test algorithm.
Convergence_Time_Onset_VCX_seconds seconds 1×1, double Time of convergence in seconds, as determined by the VCX convergence test algorithm.
Convergence_Time_VCX_seconds seconds 1×1, double Time in seconds between scene change onset and convergence onset.
Convergence_Target_VCX 1×1, logical Indicates whether the convergent L* falls within [65, 69].
Convergence_Stability Perceptual Lightness 1×1, double Standard deviation of L* after convergence is achieved.