Label3D is a GUI for the manual labeling of 3D keypoints in multiple cameras. Forked and improve from diegoaldarondo/Label3D.
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
- Simultaneous viewing of any number of camera views
- Multiview triangulation of 3D keypoints
- Point-and-click and draggable gestures to label keypoints
- Zooming, panning, and other default Matlab gestures
- 进入Matlab,打开 Label3DImageManager.
>> Label3DImageManager
- “打开文件夹”,例如本项目提供的测试数据: “testdata/”, 包含图片和 mat 文件。等待半分钟数据载入。载入新文件夹,请重启软件,以防错误。
- “载入和保存标注文件”,文件名为 “anno.mat”
- 常用快捷键
快捷键 | 功能 |
---|---|
t |
2D -> 3D。(需要至少2个视角的2D点,推荐3-5个视角) |
TAB |
下一个关键点 |
f |
等于 t 加 → |
x |
删除当前一个3D关键点 |
u |
删除当前所有3D关键点 |
p |
是否显示 3D 模型图(默认开启) |
z |
放大(Zoom) |
← → |
前一张,后一张图片 |
如果“快捷键”没有反应,可能是1 . “开启了功能区”没有关闭。2. 要切换到“英文输入法”
- 操作错误提示,可见黑框中
原始代码 (diegoaldarondo) | 本项目改进 | |
---|---|---|
代码大小 | 冗余 300Mb | 精简后为 11 Mb |
依赖关系 | 额外下载 | 已整合 |
安装方式 | 手动 | 自动 |
多相机矫正文件 | 未指明 | 通过xx.calibpkl.mat 提供 |
输入标注数据 | 导入多路视频文件 | 导入图片文件夹,每张图片包含多路视角 |
代码入口 | >> Label3D | >> Label3DImageManager |
更改关键点名称、颜色、顺序 | 分散在许多文件 | 只用修改 Label3DImageManager.m |