ch-sa/labelCloud

🎯 labelCloud: Công cụ gán nhãn hộp bao bọc 3D nhanẹ nhưng mạnh mẽ

Công cụ Python mã nguồn mở để gán nhãn hộp bao bọc 3D (3D bounding boxes) trên đám mây điểm (point clouds), hỗ trợ nhiều định dạng nhập/xuất và cả phân đoạn ngữ nghĩa.

labelCloud là một công cụ nhẹ (lightweight) được viết bằng Python, thiết kế để gán nhãn các hộp bao bọc 3D trong dữ liệu đám mây điểm. Dự án hỗ trợ hai phương pháp chính: picking (chọn vị trí) và spanning (kéo thả theo từng trục), đồng thời cung cấp nhiều phím tắt và tùy chọn chỉnh sửa để điều chỉnh vị trí, kích thước và góc quay của hộp.

✨ Điểm nổi bật

• Hai chế độ gán nhãn: Picking (chọn góc trên-trước) và Spanning (chọn 4 đỉnh để xác định dài-rộng-cao).
• Hỗ trợ xoay 6 DoF: Tùy chọn vô hiệu hóa xoay x/y mặc định, hoặc bật xoay tự do quanh 3 trục khi tắt z-Rotation Only Mode.
• Phân đoạn ngữ nghĩa dựa trên hộp bao bọc: Gán nhãn cho tất cả điểm trong hộp bằng cách nhấn Assign, lưu kết quả dưới dạng file .bin với kiểu np.int8.
• Đa dạng định dạng nhập: Hỗ trợ *.pcd, *.ply, *.pts, *.xyzrgb (có màu) và *.xyz, *.xyzn, *.bin (KITTI).
• Đa dạng định dạng xuất: Hỗ trợ centroid_rel, centroid_abs, vertices, kitti, kitti_untransformed.
• Tùy biến dễ dàng: Có thể tạo exporter riêng bằng cách kế thừa lớp BaseLabelFormat.
• Cấu hình linh hoạt: Điều chỉnh qua config.ini hoặc giao diện cài đặt.
• Cài đặt nhanh: Hỗ trợ cài qua pip hoặc chạy trực tiếp từ nguồn.

💡 Vì sao đáng chú ý

Khác với các công cụ nặng hoặc phức tạp, labelCloud tập trung vào trải nghiệm người dùng mượt mà khi gán nhãn hộp 3D trên đám mây điểm. Sự kết hợp giữa hai chế độ picking/spanning và hỗ trợ xoay 6 DoF giúp tăng tốc quy trình gán nhãn chính xác. Ngoài ra, khả năng xuất ra nhiều định dạng chuẩn như KITTI giúp dễ dàng tích hợp vào các pipeline học máy và nhận dạng đối tượng 3D.

#3DLabeling #PointCloud #ComputerVision #OpenSource #TiniX