PyHikRobot 通过 MVS SDK 为海康机器人工业相机提供零拷贝 Python 绑定,支持 NumPy 视图、跨平台运行及完善的错误处理层次。

Stars

6

7 天增长

暂无数据

Fork 数

0

开放 Issue

0

开源协议

Apache-2.0

最近更新

2026-07-27

AI 仓库情报摘要
FR-AI / ANALYSIS

为什么值得关注

其 API 刻意设计了缓冲区生命周期管理,通过自动释放帧并在访问过期视图时抛出异常,防止常见的使用后错误,同时通过零拷贝视图保持高性能。

适合谁使用

  • 需要将海康机器人相机集成到机器视觉应用中的 Python 开发者
  • 从事实时相机控制与流处理的工业自动化工程师
  • 在 Python 中使用 GigE 或 USB 视觉相机的研究人员与爱好者

典型使用场景

  • 无需数据拷贝即可捕获并实时处理视频帧(NumPy 视图)
  • 通过命名属性或 GenICam 节点图配置相机参数(曝光、增益、像素格式)
  • 调整 GigE 传输设置(包大小、重传)以确保稳定流传输
  • 利用特定异常类优雅地处理相机错误(网络问题、缓冲区耗尽、访问冲突)

项目优势

  • 零拷贝 NumPy 视图避免不必要的内存复制,适用于高吞吐帧处理
  • 显式的帧释放机制(`.copy()` 或 `frames_raw()`)防止缓冲区重用导致的潜在错误
  • 跨平台支持(Linux x86_64/aarch64/armv7l, Windows x64)及延迟 SDK 加载
  • 丰富的错误层次结构,包含 20 多种特定异常类型,未翻译的错误码也会携带状态和名称

使用前须知

  • Alpha 阶段:公共 API 可能变化,动作命令和 CUDA 层尚未实现
  • 需要额外安装海康机器人 MVS SDK(不随包提供),受限于厂商许可
  • 缓冲区生命周期规则需仔细编码:保留的 NumPy 视图可能静默返回过时的像素数据

README 快速开始

Quick start

项目描述

Thin, zero-copy Python bindings for Hikrobot machine-vision cameras (MVS SDK). NumPy views without the copy, cross-platform loader, sane errors.

相关仓库与替代方案

根据分类、Topic 和编程语言匹配的相似项目。

lopopolo
精选
lopopolo GitHub avatar

harness-engineering

Harness Engineering is a methodology for improving coding agent outputs by carefully crafting the environment around them—providing curated context, tools, and executable constraints that encode an organization’s nonfunctional requirements and cumulative lessons.

AI 与机器学习AI 智能体
2,390
slvDev
精选
slvDev GitHub avatar

esp32-ai

A 28.9 million parameter language model runs on an $8 ESP32-S3 microcontroller entirely on-device, generating simple stories at about 9.5 tokens per second.

AI 与机器学习大语言模型
1,960
littledivy
精选
littledivy GitHub avatar

mimic

mimic captures traffic from any iOS or web app and automatically generates a Python client library that lets you call the app's API like a regular library.

AI 与机器学习
1,482