Skip to content

Labeling GUI for multi-camera tracking

Notifications You must be signed in to change notification settings

chenxinfeng4/Label3D

 
 

Repository files navigation

Label3D

Label3D is a GUI for the manual labeling of 3D keypoints in multiple cameras. Forked and improve from diegoaldarondo/Label3D.

img

Installation

Requires Matlab 2019b, Matlab 2020a, or Matlab 2020b To install Label3D, use:

git clone --depth=1 https://github.com/chenxinfeng4/Label3D.git Label3D

Open the Label3D folder, and run setup.bat. This will append the code path into matlab path manager.

Now, you will see the label3D GUI popping out.

>> Label3DImageManager

Features

  1. Simultaneous viewing of any number of camera views
  2. Multiview triangulation of 3D keypoints
  3. Point-and-click and draggable gestures to label keypoints
  4. Zooming, panning, and other default Matlab gestures

使用方法

  1. 进入Matlab,打开 Label3DImageManager.
>> Label3DImageManager

img

  1. “打开文件夹”,例如本项目提供的测试数据: “testdata/”, 包含图片和 mat 文件。等待半分钟数据载入。载入新文件夹,请重启软件,以防错误。

img

  1. “载入和保存标注文件”,文件名为 “anno.mat”

img

img

  1. 常用快捷键
快捷键 功能
t 2D -> 3D。(需要至少2个视角的2D点,推荐3-5个视角)
TAB 下一个关键点
f 等于 t
x 删除当前一个3D关键点
u 删除当前所有3D关键点
p 是否显示 3D 模型图(默认开启)
z 放大(Zoom)
前一张,后一张图片

如果“快捷键”没有反应,可能是1 . “开启了功能区”没有关闭。2. 要切换到“英文输入法”

img

  1. 操作错误提示,可见黑框中

img

代码改进(对比原始 diegoaldarondo 代码)

原始代码 (diegoaldarondo) 本项目改进
代码大小 冗余 300Mb 精简后为 11 Mb
依赖关系 额外下载 已整合
安装方式 手动 自动
多相机矫正文件 未指明 通过xx.calibpkl.mat提供
输入标注数据 导入多路视频文件 导入图片文件夹,每张图片包含多路视角
代码入口 >> Label3D >> Label3DImageManager
更改关键点名称、颜色、顺序 分散在许多文件 只用修改 Label3DImageManager.m

代码参考自 https://github.com/diegoaldarondo/Label3D

About

Labeling GUI for multi-camera tracking

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • MATLAB 99.9%
  • Batchfile 0.1%