🎨 Visualization gallery

A tour of what SimBA can render — plotting outputs and the video/image processing tools. Each tile links to the code that produces it, where you’ll find the full API, options and a playable demo.

Plotting

Blob plotter

Plot the results of animal tracking based on blob.

Blob visualizer

Visualize blob tracking data by overlaying geometric shapes and body part markers on video frames.

Circular feature plotter

Create visualization of base angular features overlay on video.

Cue light visualizer

Visualize SimBA computed cue-light ON and OFF states and the aggregate statistics of ON and OFF states.

Data plotter

Tabular data visualization of animal movement and distances in the current frame and their aggregate statistics.

Directing other animals visualizer

Create videos visualizing when animals direct their gaze toward body parts of other animals (single-threaded).

Directing ROI visualizer

Visualize when animals are directing towards ROIs.

Distance plotter

Visualize frame-wise body-part distances as line plots using single-core processing.

Frame mergerer FFmpeg

Merge separate visualizations of classifications, descriptive statistics etc., into single video mosaic.

Gantt creator

Create classifier Gantt charts using single-process execution.

Gantt plotly

Generates a Gantt chart using Plotly to visualize bout events over time.

Geometry plotter

A class for creating overlay geometry visualization videos based on provided geometries and video name.

Heat mapper classifier

Create heatmaps representing the locations of the classified behavior.

Heatmapper location

Create heatmaps representing the location where animals spend time.

Interactive probability grapher

Launch interactive GUI for inspecting classifier probabilities with synchronized video playback.

Light dark box plotter

Generate annotated videos visualizing behavior episodes in a light/dark box setup.

Path plotter

Create “path plots” videos and/or images detailing the movement paths of individual animals in SimBA.

Plot sklearn results

Plot classification results overlays on videos.

Pose plotter

Create pose-estimation visualizations from data within a SimBA project folder using multiprocessing.

Quick path plot

Create a simple path plot image for a single or several pose-estimation files.

RO ifeature visualizer

Visualizing features that depend on the relationships between the location of the animals and user-defined ROIs.

ROI plot

Visualize the ROI data (number of entries/exits, time-spent in ROIs) using multiprocessing for improved performance.

ROI plotter

Visualize the ROI data (number of entries/exits, time-spent in ROIs etc).

SHAP explanations

Calculate aggregate (binned) SHAP value statistics where individual bins represent reaulated features.

Skeleton video creator

Create pose-estimation videos rendered on a solid RGB background from SimBA CSV data.

Spontaneous alternations plotter

Create plots representing delayed-alternation computations overlayed on video.

Treshold plot creator

Create classifier-probability line plots using single-process execution.

Validate model one video

Create classifier validation video for a single input video using multiprocessing for improved performance.

YOLO model comparator

Compare two or more YOLO models side-by-side on a set of test videos.

YOLO pose visualizer

Visualizes YOLO-based keypoint pose estimation data on video frames and creates an annotated output video.

YOLO visualizer

Visualize YOLO bounding-box inference results on a source video.

Video & image tools

Batch video to greyscale

Convert a directory of video file to greyscale mp4 format.

Brightness contrast UI

Create a user interface using OpenCV to explore and change the brightness and contrast of a video.

Change playback speed

Change the playback speed of a video file.

Change single video fps

Change the fps of a single video file.

CLAHE enhance video

Convert a single video file to clahe-enhanced greyscale.avi file.

Convert to avi

Convert a directory containing videos, or a single video, to AVI format using passed quality and codec.

Convert to mp4

Convert a directory containing videos, or a single video, to MP4 format using passed quality and codec.

Convert to webm

Convert a directory containing videos, or a single video, to WEBM format using passed quality and codec.

Convert to webp

Convert the file type of all image files within a directory to WEBP format of passed quality.

Create average frame

Create an image representing the average frame of a segment in a video or an entire video.

Crop multiple videos circles

Crop multiple videos based on circular regions of interest (ROIs) selected by the user.

Crop single video

Crop a single video using ~simba.video_processors.roi_selector.ROISelector interface.

Crop single video circle

Crop a video based on circular regions of interest (ROIs) selected by the user.

Crop single video polygon

Crop a video based on polygonal regions of interest (ROIs) selected by the user.

Crossfade two videos

Cross-fade two videos.

Egocentric video rotator

Perform egocentric rotation of a video using CPU multiprocessing.

Flip videos

Flip a video or directory of videos horizontally, vertically, or both, and save them to the specified directory.

Get video slic

Apply SLIC superpixel segmentation to all frames of a video and save the output as a new video.

Horizontal video concatenator

Concatenates multiple videos horizontally.

Interactive CLAHE UI

Create a user interface using OpenCV to explore and set appropriate CLAHE settings tile size and clip limit.

Mixed mosaic concatenator

Create a mixed mosaic video by concatenating multiple input videos in a mosaic layout of various sizes.

Mosaic concatenator

Concatenates multiple videos into a mosaic layout.

Multi cropper

Crop each video of a specific file format (e.g., mp4) in a directory into N smaller cropped videos.

Reverse videos

Reverses one or more video files located at the specified path and saves the reversed videos in the specified directory.

ROI blurbox

Blurs either the selected or unselected portion of a user-specified region-of-interest according to the passed blur level.

ROI selector

A class for selecting and reflecting Regions of Interest (ROI) in an image.

ROI selector circle

Class for selecting a circular region of interest (ROI) within an image or video frame.

ROI selector polygon

Class for selecting a polygonal region of interest (ROI) within an image or video frame.

Rotate video

Rotate a video or a directory of videos by a specified number of degrees.

Superimpose elapsed time

Superimposes elapsed time on the given video file(s) and saves the modified video(s).

Superimpose frame count

Superimpose frame count on a video file.

Superimpose freetext

Superimposes passed text on the given video file(s) and saves the modified video(s).

Superimpose overlay video

Inset a video overlay on a second video with specified size, opacity, and location.

Superimpose video names

Superimposes the video name on the given video file(s) and saves the modified video(s).

Superimpose video progressbar

Overlay a progress bar on a directory of videos or a single video.

Vertical video concatenator

Concatenates multiple videos vertically.

Video background subtraction

Subtract the background from a video.

Video concatenator

Concatenate two videos to a single video either horizontally or vertically

Video rotator

GUI Tool for rotating video.

Video to BW

Convert video to black and white using passed threshold.

Video to greyscale

Convert a video file to greyscale mp4 format.

Watermark video

Watermark a video file or a directory of video files with specified watermark size, opacity, and location.