Save 4 hours! We auto-setup your workflow! Free!

Drop your workflow.json — we handle every dependency, custom node, and model. Just open the link and run.

Auto-Setup Workflow Json (Free) Now!
ComfyUI > Nodes > OpenKatana > OpenKatana · Analyze energy

ComfyUI Node: OpenKatana · Analyze energy

Class Name

OpenKatana_analyze_energy

Category
OpenKatana/Tools
Author
rk0neki (Account age: 235days)
Extension
OpenKatana
Latest Updated
2026-11-05
Github Stars
0.05K

How to Install OpenKatana

Install this extension via the ComfyUI Manager by searching for OpenKatana
  • 1. Click the Manager button in the main menu
  • 2. Select Custom Nodes Manager button
  • 3. Enter OpenKatana in the search bar
After installation, click the Restart button to restart ComfyUI. Then, manually refresh your browser to clear the cache and access the updated list of nodes.

Visit ComfyUI Online for ready-to-use ComfyUI environment

  • Free trial available
  • 16GB VRAM to 80GB VRAM GPU machines
  • 400+ preloaded models/nodes
  • Freedom to upload custom models/nodes
  • 200+ ready-to-run workflows
  • 100% private workspace with up to 200GB storage
  • Dedicated Support

Run ComfyUI Online

OpenKatana · Analyze energy Description

Analyzes video frame changes to measure visual energy, motion, pacing, and potential cuts.

OpenKatana · Analyze energy:

OpenKatana_analyze_energy helps you understand the visual intensity and editing rhythm of video footage by measuring changes between frames rather than relying only on subjective impressions. It identifies candidate cuts, flashes, shakes, pans, and impact-like events, and measures characteristics such as movement, jitter, and the proportion of footage with camera motion. These measurements help you distinguish a calm sequence from a rapidly changing, high-energy edit and locate moments worth inspecting more closely. The underlying analysis also supports a reference-comparison workflow, which can help you assess visual pacing against another clip. Its findings are measured candidates, not guaranteed editorial decisions: a fast camera movement can resemble a cut, so you should review the surrounding frames before recreating an event. This is an analysis tool, not a tool that automatically edits or reproduces the detected effects.

OpenKatana · Analyze energy Input Parameters:

project_id

A required STRING identifying the OpenKatana project associated with the analysis request. The node passes this value through its argument-preparation process so that the tool call has project context. Use the identifier for the project you intend to work with, rather than a descriptive project title unless that title is itself the actual identifier. The supplied interface does not specify a default value, available options, minimum or maximum length, or identifier format; it also does not show the project-validation rules.

arguments

A required STRING carrying the tool arguments that are prepared and passed to the underlying analysis call. The callable signature identifies the analysis settings as source, an obligatory media-source string; reference, an optional reference string with a default of None; start, a floating-point start position with a default of 0; duration, an optional floating-point analysis length with a default of None; canvas_w, an integer analysis-canvas width with a default of 1080; and floor, a floating-point setting with a default of 0.6 that also appears in the underlying reference-check function. These are fields within the argument payload, not additional node input sockets. A JSON-formatted example is {"source":"/path/to/video.mp4","start":0,"duration":10,"canvas_w":1080}. The measurement functions use the start and duration settings to select the analysis window; the returned rate measurements identify the window length in seconds. The precise comparison formula for floor and the treatment of an omitted duration are not shown, so do not assume that floor is a detection-confidence percentage or that an omitted duration guarantees a particular analysis length. The node interface does not expose a default string, minimum or maximum length, or fixed choices for arguments, and the supplied callable signatures do not declare numeric bounds for these payload settings.

after

An optional STRING accepted by the node, with a default of None in the execution method. The supplied method does not read this value or pass it to the analysis argument builder or tool invocation, so no direct effect on the energy measurements is demonstrated in this code. It should not be treated as a time offset, a source path, or an analysis setting. If your surrounding workflow uses this socket for sequencing, follow that workflow’s conventions; its sequencing behavior is not established by the provided implementation. No minimum or maximum length or supported choices are specified.

OpenKatana · Analyze energy Output Parameters:

result_json

A STRING containing the serialized response from the tool invocation. The underlying API returns a dictionary extended with analysis_path, pointing to an energy.json report; preview_images, containing the preview-image information collected by the API; and limits, warning that detected events are candidates and that fast camera movement can look like a cut. The measurement data shown in the context includes source and analysis-window information, an analysis-canvas width, and a rates group containing frame rate, analyzed seconds, cuts per second, flashes per second, a shake-rate measure, average jitter and movement in pixels, a motion measure, and measured-frame and distinct-frame shares. It also includes counts of white and black flashes, a camera-moving share, event collections for cuts, flashes, shakes, pans, and hits, and an energy curve named energy_0_5s. These values help you compare overall pacing and find candidate moments for closer inspection; pixel-based values should be interpreted alongside the analysis-canvas width, and the generic motion measure should not be read as a percentage. A share represents a proportion rather than an event count. The supplied code does not show the complete response wrapper, reference-comparison result structure, preview-image encoding, or every event’s internal fields, so inspect the returned JSON before building downstream field extraction. This output is a text response, not a ComfyUI image socket or an edited video.

OpenKatana · Analyze energy Usage Tips:

  • Begin with a short, known section of footage by supplying start and duration inside arguments. For example, {"source":"/path/to/video.mp4","start":20,"duration":8} targets an eight-second window beginning at 20 seconds, making it easier to compare the measurements with what you see.
  • Keep the payload settings inside arguments. The only exposed node inputs are project_id, arguments, and after; settings such as source and canvas_w are not separate sockets on this node.
  • Use valid JSON syntax when constructing a JSON argument payload: put property names and string values in double quotes, leave numeric values unquoted, and use null rather than Python’s None when explicitly expressing an absent optional value.
  • Keep canvas_w consistent when comparing clips, particularly when reviewing jitter_px and move_px. These are pixel-based measurements, and the measurement report includes the canvas width as part of its analysis context.
  • Use a reference payload field when you need a reference-based comparison, but begin with the default floor of 0.6 unless you have verified the comparison logic. The excerpts do not establish how changing this value affects the comparison outcome.
  • Review the preview information and frames around each reported event before using it as an editing instruction. The API explicitly cautions that a fast camera move can be mistaken for a cut.
  • Check measured_share and distinct_frame_share alongside motion and event rates. These provide context about the frames represented in the measurement, helping you avoid interpreting a single rate without considering the underlying footage.
  • Do not interpret this node as a beat or BPM analyzer. Although audio-analysis code appears in the supplied context, the shown energy-analysis return data does not establish that this node includes audio beats, tempo, or loudness.

OpenKatana · Analyze energy Common Errors and Solutions:

unexpected inputs: ...

  • Explanation: This is the explicit error format shown in the node’s execution code. It occurs when execution receives extra named fields that are not declared in the tool’s typed input definitions.
  • Solution: Use only the exposed sockets project_id, arguments, and after. Put analysis settings inside the argument payload instead of adding arbitrary named inputs through scripts or modified workflows.

Invalid argument payload — exact error text not shown

  • Explanation: The node prepares and converts arguments before calling the tool. A malformed payload can prevent this preparation from succeeding, although the supplied code does not show the parser’s exact error messages.
  • Solution: If you are supplying JSON, check for missing quotation marks, trailing commas, and invalid values such as Python’s None. Start with a minimal payload such as {"source":"/path/to/video.mp4"}, then add settings one at a time.

Missing source argument — exact error text not shown

  • Explanation: The underlying analyze_energy signature requires source and provides no default for it. A payload without this field does not supply the media source needed for analysis.
  • Solution: Include a source string in arguments that identifies the footage you want to analyze. Do not assume that selecting a project automatically selects a source clip.

Invalid argument type — exact error text not shown

  • Explanation: The callable declares strings for source and reference, floating-point values for start, duration, and floor, and an integer for canvas_w. Incompatible values may fail during argument conversion or later processing; the exact validation behavior is not included.
  • Solution: Supply numeric settings as numbers, not descriptive text. For example, use "duration":10 rather than "duration":"ten seconds", and use an integer such as 1080 for canvas_w. Omit optional settings when you do not need to override them.

Source or reference media cannot be accessed — exact error text not shown

  • Explanation: Analysis requires readable media. An incorrect path, unavailable file, or access restriction can prevent processing, but the supplied excerpts do not specify the resulting error message or all supported source formats.
  • Solution: Confirm that the media exists and is accessible from the environment running OpenKatana, not just from your own computer. If a reference is supplied, check its accessibility separately.

Empty or unsuitable analysis window — exact error text not shown

  • Explanation: A start position beyond the available footage or a duration that leaves no usable frames can prevent meaningful measurement. The implementation excerpt does not show validation rules for these cases.
  • Solution: Verify the clip’s length and choose a start position within it. Use a positive duration that fits within the remaining footage, or omit the optional duration while checking how your installation handles it.

Detected cuts do not match visible edits

  • Explanation: This is an interpretation issue rather than necessarily an execution error. The API’s returned warning states: “Measured candidates: inspect the frames around each event before reproducing it; a fast camera move can read as a cut.”
  • Solution: Inspect the frames before and after each candidate event. Treat the event list as a guide for review, not as a definitive edit list, especially in footage with rapid pans, strong shake, or flashes.

result_json does not connect as an image output

  • Explanation: The node returns one STRING socket. Any preview_images information is contained in the serialized response and is not exposed as a native image output.
  • Solution: Inspect or parse result_json first. If you need to display a preview or load the saved analysis, use downstream tools appropriate to the actual paths or data present in the response.

OpenKatana · Analyze energy Related Nodes

Go back to the extension to check out more related nodes.
OpenKatana
RunComfy
Copyright 2025 RunComfy. All Rights Reserved.

RunComfy is the premier ComfyUI platform, offering ComfyUI online environment and services, along with ComfyUI workflows featuring stunning visuals. RunComfy also provides AI Models, enabling artists to harness the latest AI tools to create incredible art.

OpenKatana · Analyze energy