Skip to content

About

No description, website, or topics provided.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Latest commit

 

History

1 Commit

Folders and files

Repository files navigation

Streaming COLMAP: ALIKED + LightGlue

将原 pycolmap 单文件验证程序重构为可部署 C++ 流式工程。

设计目标

  • 核心 pipeline 不依赖输入源。
  • 部署时通过 config/config.yaml 或命令行选择输入,不改 C++。
  • 内置支持:
    • 图片目录(测试/回放)
    • 视频文件
    • USB/V4L2 摄像头
    • RTSP/HTTP/其他 OpenCV URI
    • GStreamer pipeline
  • 统一处理链:去畸变 -> ALIKED -> DB -> LightGlue -> 两视图几何 -> DB。
  • Quadratic sequential offsets 默认 [1,2,4,8,16,32]。
  • 历史特征缓存有固定上限,不随运行时间增长。
  • 对外提供 StreamingPipeline::ProcessFrame(),以后接 ROS/厂商 SDK 时无需修改算法模块。

目录

include/streaming_colmap/
  core/       配置和帧数据类型
  io/         输入流接口、目录源、OpenCV实时源、输入源工厂
  vision/     标定和去畸变
  colmap/     ALIKED提取器、LightGlue匹配器、几何验证、数据库
  pipeline/   流式调度、缓存、统计
src/
config/
scripts/

编译

./scripts/build.sh

如果 COLMAP 安装目录无法自动找到:

./scripts/build.sh -Dcolmap_DIR=/usr/local/share/colmap

部署运行

只需要准备好 calib_front.json 并修改 config/config.yaml 中的输出路径。

1. 目录回放

./scripts/run_directory.sh /path/to/images

2. USB/V4L2 摄像头

./scripts/run_camera.sh 0

也可以在 YAML 中设置:

source:
  type: "camera"
  camera_id: 0
  backend: "v4l2"
  width: 2560
  height: 1440
  fps: 10.0

3. RTSP

./scripts/run_rtsp.sh 'rtsp://user:pass@192.168.1.10/stream'

4. GStreamer

在配置中:

source:
  type: "gstreamer"
  uri: "nvarguscamerasrc ! ... ! appsink drop=1 sync=false"

程序入口保持不变:

./build/streaming_colmap --config config/config.yaml

关于“无需修改代码”

只要实地设备能通过 V4L2、RTSP、视频 URI 或 GStreamer 输出图像流,部署时只改配置/启动参数,不需要改算法代码。

如果某台工业相机只能使用厂商私有 SDK,那么任何程序都必须有一层 SDK 适配。该工程已把这层边界固定为 IFrameSource 或直接调用 StreamingPipeline::ProcessFrame(FramePacket);ALIKED、LightGlue、去畸变、几何验证和数据库代码仍然无需修改。

Mapper

程序写出的 database.db 和 images_undistorted/ 可继续给 COLMAP mapper 使用:

colmap mapper \
  --database_path /path/to/database.db \
  --image_path /path/to/images_undistorted \
  --output_path /path/to/sparse \
  --Mapper.ba_refine_focal_length 0 \
  --Mapper.ba_refine_principal_point 0 \
  --Mapper.ba_refine_extra_params 0 \
  --Mapper.ba_global_frames_ratio 1.2 \
  --Mapper.ba_global_points_ratio 1.2 \
  --Mapper.ba_use_gpu 1 \
  --Mapper.ba_gpu_index 0

实时流延迟控制

camera / uri / gstreamer 默认启用独立采集线程。采集线程和 ALIKED/LightGlue 处理线程之间使用有界队列:

source:
  async_capture: 1
  queue_size: 2
  drop_oldest: 1
  buffer_size: 1

当处理速度低于相机 FPS 时,默认丢弃队列中最旧的待处理帧,优先处理最新画面,避免延迟不断累积。对于 video 文件回放,程序自动使用同步读取,因此不会因为异步队列而跳过视频帧。

RTSP/USB 相机读取失败时可自动重连:

source:
  reconnect_on_failure: 1
  reconnect_delay_ms: 500
  max_reconnect_attempts: -1

-1 表示持续尝试重连。

正常停止

程序处理 SIGINT 和 SIGTERM。本地运行可直接:

Ctrl+C

作为 systemd 服务运行时,systemctl stop 发送的终止信号也会触发正常收尾:停止采集线程、关闭 COLMAP 数据库并输出最终统计。

About

No description, website, or topics provided.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages