ComfyUI Node: Coordinate Plotter

Coordinate Plotter:

CoordinatePlotter is a versatile node designed for visualizing coordinates on images or blank canvases within the ComfyUI environment. Its primary function is to plot specified points on an image, which can be particularly useful for tasks such as object tracking, annotation, or any application requiring visual representation of spatial data. The node allows you to input coordinates in a JSON format and offers flexibility in terms of the shape, size, and color of the plotted points. Whether you are working with existing images or creating new visualizations from scratch, CoordinatePlotter provides a straightforward and efficient way to overlay coordinate data, enhancing your ability to analyze and interpret spatial information.

Coordinate Plotter Input Parameters:

positive_points

This parameter accepts a JSON string representing the coordinates of positive points to be plotted. Each point should be defined with x and y values, such as [{"x": 63, "y": 782}]. These points are typically used to indicate areas of interest or focus within the image. The default value is an empty string, meaning no points will be plotted unless specified.

negative_points

Similar to positive_points, this parameter takes a JSON string for negative points, which might represent areas to avoid or exclude. The format is the same, with x and y values, like [{"x": 100, "y": 200}]. The default is an empty string, indicating no negative points unless provided.

bbox

This parameter defines a bounding box, which can be specified either as (x_min, y_min, x_max, y_max) or (x, y, width, height). It is compatible with outputs from the KJNodes Points Editor and is used to delineate a specific area within the image. The bounding box helps in focusing the plotting within a defined region.

input_mask

A binary mask used for object initialization, this parameter helps in defining the areas of the image where plotting should occur. It is particularly useful in scenarios where only certain parts of the image are relevant for visualization.

tracking_direction

This parameter specifies the direction of tracking from the annotation frame, with options including forward, backward, and bidirectional. The default is forward, which means the tracking will proceed in the forward direction from the initial frame.

annotation_frame_idx

An integer parameter that indicates the frame index where the initial prompt is applied. It has a default value of 0 and a minimum value of 0, ensuring that the annotation starts from a valid frame index.

object_id

This integer parameter assigns a unique ID for multi-object tracking, allowing you to differentiate between multiple objects being tracked simultaneously. The default value is 1, with a minimum value of 1, ensuring each object has a distinct identifier.

Coordinate Plotter Output Parameters:

output

The output of the CoordinatePlotter node is a tensor representing the image with the plotted coordinates. This output is crucial for visual analysis, as it provides a visual representation of the spatial data overlaid on the image. The tensor format ensures compatibility with further processing or visualization steps within the ComfyUI framework.

Coordinate Plotter Usage Tips:

• Ensure your coordinate inputs are correctly formatted as JSON strings to avoid parsing errors.
• Use the bbox parameter to focus plotting within a specific region, which can help in reducing visual clutter and enhancing analysis.
• Experiment with different point_shape, point_size, and point_color settings to achieve the desired visual effect and clarity for your plotted points.

Coordinate Plotter Common Errors and Solutions:

Invalid JSON coordinates

• Explanation: This error occurs when the coordinates input is not a valid JSON string.
• Solution: Double-check the format of your coordinates input to ensure it is a properly formatted JSON string, such as [{"x": 63, "y": 782}].

Coordinate plotting failed

• Explanation: This error is raised when there is a failure in the plotting process, possibly due to invalid input parameters or internal processing issues.
• Solution: Review all input parameters for correctness, ensuring that coordinates are valid and within the image bounds. Check for any additional error messages that might provide more context on the issue.

Could not extract coordinates from bbox

• Explanation: This error indicates that the bounding box input could not be parsed into valid coordinates.
• Solution: Verify that the bbox parameter is correctly formatted as either (x_min, y_min, x_max, y_max) or (x, y, width, height). Ensure that all values are numeric and within expected ranges.