ComfyUI Node: H3 Scene Color Stats (alpha)

H3 Scene Color Stats (alpha):

The H3SceneColorStats node is an experimental tool designed to extract robust color statistics from a batch of image frames, specifically focusing on center-weighted luma and saturation percentiles. This node is part of the H3 Delta Color Carry system and is intended to be used with images from the H3 Tail Context. By analyzing the color characteristics of a scene, it provides a JSON string output that encapsulates these statistics, which can be used for further color correction or analysis tasks. The primary goal of this node is to offer a detailed understanding of the color dynamics within a scene, enabling more precise color adjustments and enhancements in subsequent processing stages.

H3 Scene Color Stats (alpha) Input Parameters:

images

The images parameter is a required input that accepts a batch of image frames. This parameter is crucial as it provides the raw data from which the node will extract color statistics. The images should be representative of the scene you wish to analyze, as the node will compute luma and saturation percentiles based on these frames. There are no specific minimum or maximum values for this parameter, but the quality and relevance of the input images will directly impact the accuracy and usefulness of the resulting statistics.

H3 Scene Color Stats (alpha) Output Parameters:

stats

The stats output is a JSON string that contains the computed scene color statistics. This output includes detailed information about the luma and saturation percentiles of the input images, providing insights into the color distribution and balance within the scene. These statistics are essential for tasks that require precise color correction or matching, as they allow you to understand and adjust the color characteristics of your images effectively.

H3 Scene Color Stats (alpha) Usage Tips:

• Ensure that the input images are of high quality and accurately represent the scene you wish to analyze, as this will improve the reliability of the color statistics generated by the node.
• Use the JSON output to inform color correction processes, allowing for more targeted adjustments based on the specific luma and saturation characteristics of your scene.

H3 Scene Color Stats (alpha) Common Errors and Solutions:

ValueError: `` has no compatible scene-color statistics

• Explanation: This error occurs when the input value does not contain valid scene-color statistics or the version is incompatible.
• Solution: Ensure that the input JSON string is correctly formatted and includes the required version information. Verify that the input data adheres to the expected schema.

ValueError: `` scene-color statistics are malformed

• Explanation: This error indicates that the luma or saturation percentiles in the input data are not correctly structured.
• Solution: Check the input JSON string to ensure it contains three valid luma and saturation percentile values. Correct any discrepancies in the data format.

ValueError: `` scene-color statistics are not finite

• Explanation: This error suggests that some of the percentile values in the input data are not finite numbers.
• Solution: Inspect the input data for any non-finite values (e.g., NaN or infinity) and replace them with valid numerical values.