visortpy 1.2.0

Visualize sorting algorithms with pure Python syntax / 用纯Python语法可视化排序算法

visortpy

Visualize sorting algorithms with pure Python syntax.

用纯 Python 语法可视化排序算法。

Author / 作者: pronoobe

---

Features / 特性

• Write sorting algorithms in plain Python — no visualization code needed
• 用原生 Python 写排序算法，无需任何可视化代码
• Auto-records every comparison, read, write, and swap
• 自动记录每次比较、读取、写入和交换操作
• Generates GIF / MP4 animations with color-coded highlights
• 生成带颜色高亮的 GIF / MP4 动画
• Optional "final sweep" animation (bars turn green left-to-right)
• 可选的"最终扫描"动画（柱状图从左到右依次变绿）
• Independent X/Y axis visibility control
• 独立控制 X/Y 坐标轴显示
• Multi-process parallel rendering with progress bar
• 多进程并行渲染，带进度条显示
• Modular renderer architecture — easy to extend
• 模块化渲染器架构，易于扩展

Installation / 安装

pip install visortpy

生成 MP4 视频需要系统安装 ffmpeg：

# macOS
brew install ffmpeg

# Ubuntu / Debian
sudo apt install ffmpeg

# Windows (scoop)
scoop install ffmpeg

# Windows (choco)
choco install ffmpeg

如果只生成 GIF，则不需要 ffmpeg。

Quick Start / 快速开始

Bubble Sort / 冒泡排序

from visortpy import VisualArray, create_video

arr = VisualArray([64, 34, 25, 12, 22, 11, 90])

for i in range(len(arr)):
    for j in range(len(arr) - i - 1):
        if arr[j] > arr[j + 1]:
            arr.swap(j, j + 1)

create_video(arr.history, output="bubble_sort.gif", fps=4)

Selection Sort / 选择排序

arr = VisualArray([29, 10, 14, 37, 13])

for i in range(len(arr)):
    min_idx = i
    for j in range(i + 1, len(arr)):
        if arr[j] < arr[min_idx]:
            min_idx = j
    if min_idx != i:
        arr.swap(i, min_idx)

create_video(arr.history, output="selection_sort.gif", fps=4, style="dark")

Quick Sort / 快速排序

from visortpy import VisualArray, create_video

def quicksort(arr, low, high):
    if low < high:
        pivot = arr[high]
        i = low - 1
        for j in range(low, high):
            if arr[j] <= pivot:
                i += 1
                arr.swap(i, j)
        arr.swap(i + 1, high)
        quicksort(arr, low, i)
        quicksort(arr, i + 2, high)

data = VisualArray([38, 27, 43, 3, 9, 82, 10])
quicksort(data, 0, len(data) - 1)
create_video(data.history, output="quick_sort.gif", fps=6)

Final Sweep Animation / 最终扫描动画

Add final_sweep=True to show a left-to-right green sweep after sorting completes.

排序完成后，加上 final_sweep=True 可以显示从左到右逐个变绿的动画。

create_video(arr.history, output="sorted.gif", fps=8, final_sweep=True)

Configuration / 配置项

Parameter / 参数	Default / 默认值	Description / 说明
output	"output.mp4"	Output path (.mp4, .gif) / 输出路径
fps	4	Frames per second / 帧率
style	"default"	Preset style: "default", "dark", "sound" / 预设风格
bar_color	"#4a90d9"	Default bar color / 默认柱状图颜色
highlight_compare	"#e74c3c"	Compare highlight (red) / 比较高亮色
highlight_swap	"#2ecc71"	Swap highlight (green) / 交换高亮色
show_axes	True	Show/hide both axes / 显示或隐藏所有坐标轴
show_xaxis	follows show_axes	Show/hide X axis (indices) / 显示或隐藏 X 轴
show_yaxis	follows show_axes	Show/hide Y axis (values) / 显示或隐藏 Y 轴
final_sweep	False	Enable final green sweep / 启用最终扫描动画
sweep_color	"#2ecc71"	Sweep bar color / 扫描动画颜色
num_workers	1	Parallel render processes / 并行渲染进程数
show_progress	True	Show tqdm progress bar / 显示进度条

Axis Control / 坐标轴控制

# Hide X axis only / 只隐藏 X 轴
create_video(arr.history, output="no_x.gif", show_xaxis=False)

# Hide Y axis only / 只隐藏 Y 轴
create_video(arr.history, output="no_y.gif", show_yaxis=False)

# Hide both (same as show_axes=False) / 全部隐藏
create_video(arr.history, output="clean.gif", show_axes=False)

Parallel Rendering / 并行渲染

Use num_workers to speed up rendering with multiple processes. A tqdm progress bar is shown by default.

使用 num_workers 开启多进程并行渲染，加速生成。默认显示 tqdm 进度条。

create_video(arr.history, output="fast.mp4", num_workers=4)

# Disable progress bar / 关闭进度条
create_video(arr.history, output="fast.mp4", num_workers=4, show_progress=False)

Architecture / 架构

VisualArray  ──records──>  history (List[OperationRecord])  ──renders──>  GIF/MP4
   算法操作         记录为         操作历史序列                  渲染为       动画文件

The core design decouples algorithms from rendering. VisualArray behaves like a normal Python list — your algorithm code stays clean and testable.

核心设计将算法与渲染解耦。VisualArray 的行为与普通 Python 列表一致，算法代码保持简洁可测试。

License / 许可

MIT