naver/kapture: kapture is a file format as well as a set of tools for manipulati ...

原作者: [db:作者] 来自: 网络收藏邀请

开源软件名称（OpenSource Name）：

naver/kapture

开源软件地址(OpenSource Url)：

https://github.com/naver/kapture

开源编程语言(OpenSource Language)：

Python 99.9%

开源软件介绍(OpenSource Introduction)：

Table of Contents

1. Overview
2. Specifications
3. Example File Structure
4. Software
5. kapture support in other packages
- Local Features
- Global Features
6. Datasets
7. kapture-localization
8. Tutorial
9. Contributing
10. License
11. Contact Us

1. Overview

Kapture is a pivot file format, based on text and binary files, used to describe SfM (Structure From Motion) and more generally sensor-acquired data.

It can be used to store sensor parameters and raw sensor data:

cameras
images
lidar and other sensor data

As well as computed data:

2d features
3d reconstruction

Finally, many popular datasets can directly be downloaded using the convenient downloader!

2. Specifications

The format specification is detailed in the kapture format specifications document.

3. Example File Structure

This is an example file structure of a dataset in the kapture format.

my_dataset                 # Dataset root path
├─ sensors/                # Sensor data root path
│  ├─ sensors.txt          # list of all sensors with their specifications (e.g. camera intrinsics)
│  ├─ rigs.txt             # geometric relationship between sensors (optional)
│  ├─ trajectories.txt     # extrinsics (timestamp, sensor, pose)
│  ├─ records_camera.txt   # all records of type 'camera' (timestamp, sensor and path to image)
│  ├─ records_SENSOR_TYPE.txt # all records of type SENSOR_TYPE (other sensors, eg: 'magnetic', 'pressure'...)
│  └─ records_data/            # image and lidar data path
│     ├─ map/cam_01/00001.jpg  # image path used in records_camera.txt (example)
│     ├─ map/cam_01/00002.jpg
│     ├─ map/lidar_01/0001.pcd # lidar data path used in records_lidar.txt
│     ├─ query/query001.jpg    # image path used in records_camera.txt
│     ├─ ...
└─ reconstruction/
   ├─ keypoints/                       # 2D keypoints files
   │  ├─ r2d2_WASF-N8_20k              # identify the type of keypoints
   │  │  ├─ keypoints.txt              # type of keypoint (shape and dtype)
   │  │  ├─ map/cam_01/00001.jpg.kpt   # keypoints for corresponding image (example)
   │  │  ├─ query/query001.jpg.kpt     # keypoints for corresponding image (example)
   │  │  ├─ ...
   │  ├─ d2_tf                         # identify the type of keypoints
   │  │  ├─ keypoints.txt              # type of keypoint (shape and dtype)
   │  │  ├─ keypoints.tar              # instead of regular files, you can use an archive
   │  │  │  ├─ map/cam_01/00001.jpg.kpt   # keypoints for corresponding image (example)
   │  │  │  ├─ query/query001.jpg.kpt     # keypoints for corresponding image (example)
   │  │  │  ├─ ...
   │  ├─ ...
   ├─ descriptors/                     # keypoint descriptors files
   │  ├─ r2d2_WASF-N8_20k              # identify the type of descriptors
   │  │  ├─ descriptors.txt            # type of descriptor (keypoints type, shape and dtype)
   │  │  ├─ map/cam_01/00001.jpg.desc  # descriptors for corresponding image (example)
   │  │  ├─ query/query001.jpg.desc    # descriptors for corresponding image (example)
   │  │  ├─ ...
   │  ├─ d2_tf                         # identify the type of descriptors
   │  │  ├─ descriptors.txt            # type of descriptor
   │  │  ├─ descriptors.tar            # instead of regular files, you can use an archive
   │  │  │  ├─ map/cam_01/00001.jpg.desc  # descriptors for corresponding image (example)
   │  │  │  ├─ query/query001.jpg.desc    # descriptors for corresponding image (example)
   │  │  │  ├─ ...
   │  ├─ ...
   ├─ points3d.txt                  # 3D points of the reconstruction
   ├─ observations.txt              # 2D/3D points corespondences
   ├─ matches/                      # matches files.
   │  ├─ r2d2_WASF-N8_20k           # identify the type of keypoints that are matched
   │  │  ├─ map/cam_01/00001.jpg.overlapping/cam_01/00002.jpg.matches # example
   │  │  ├─  ...
   │  ├─ d2_tf                      # identify the type of keypoints that are matched
   │  │  ├─ matches.tar             # instead of regular files, you can use an archive
   │  │  │  ├─ map/cam_01/00001.jpg.overlapping/cam_01/00002.jpg.matches # example
   │  │  │  ├─  ...
   │  ├─ ...
   └─ global_features/                 # global feature files
      ├─ AP-GeM-LM18                   # identify the type of global_features
      │  ├─ global_features.txt        # type of global feature
      │  ├─ map/cam_01/00001.jpg.gfeat # example of global feature for corresponding image
      │  ├─ query/query001.jpg.gfeat   # example of global feature for corresponding image
      │  └─ ...
      ├─ DELG                          # identify the type of global_features
      │  ├─ global_features.txt        # type of global feature
      │  ├─ global_features.tar        # instead of regular files, you can use an archive
      │  │  ├─ map/cam_01/00001.jpg.gfeat # example of global feature for corresponding image
      │  │  ├─ query/query001.jpg.gfeat   # example of global feature for corresponding image
      │  │  └─ ...
      ├─ ...

4. Software

The kapture format is provided with a Python library, as well as several conversion tools.

Install

pip install kapture

or see installation for more detailed instructions.

Using docker

Build the docker image:

# build the docker image : if you have already cloned the repository
docker build . -t kapture/kapture
# OR build the docker image directly from github
docker build git://github.com/naver/kapture -t kapture/kapture
# run unit tests
docker run -it --rm kapture/kapture python3 -m unittest discover -s /opt/src/kapture/tests

If you want to process your own data, you can bind directories between the host and the container using --volume or --mount option (See the docker documentation). The following example mounts /path/to/dataset/ from the host to /dataset inside the docker.

docker run -it \
    --rm \ # Automatically remove the container when it exits \
    --volume /path/to/dataset/:/dataset:ro \ #read only
    kapture/kapture

kapture Python library

See the tutorial for some examples using the kapture Python library.

kapture tools

In this repository, you will find a set of conversion tools to or from kapture format. Import results to kapture format, and conversely, export converts kapture data to other formats. Depending of the format, some data might not be converted, either because the other format does not support it (—) or because its was not implemented (⨉). Here is a table summarizing the conversion capabilities:

Table 1. conversion capabilities

Format	← →	cam	rig	img	trj	gps	kpt	dsc	gft	p3D	obs	mch
colmap	import	✓	✓	✓	✓	⨉	✓	✓	—	✓	✓	(✓)
colmap	export	✓	✓	✓	✓	⨉	✓	✓	—	✓	✓	(✓)
openmvg	import	✓	—	✓	✓	⨉	✓	✓	—	✓	✓	(✓)
openmvg	export	✓	—	✓	✓	⨉	(✓)	(✓)	—	✓	✓	(✓)
OpenSfM	import	✓	⨉	✓	✓	✓	✓	✓	—	✓	⨉	✓
OpenSfM	export	✓	⨉	✓	✓	⨉	✓	—	✓	—	⨉	✓
bundler	import	✓	—	✓	✓	—	✓	—	—	✓	✓	—
image_folder	import	—	—	✓	—	—	—	—	—	—	—	—
image_list	import	✓	—	✓	—	—	—	—	—	—	—	—
nvm	import	✓	—	✓	✓	—	✓	—	—	✓	✓	—
IDL_dataset_cvpr17	import	✓	—	✓	✓	—	—	—	—	—	—	—
RobotCar_Seasons	import	✓	✓	✓	✓	—	✓	—	—	✓	✓	—
ROSbag cameras+trajectory	import	(✓)	(✓)	✓	✓	⨉	—	—	—	—	—	—
SILDa	import	✓	✓	✓	✓	—	—	—	—	—	—	—
virtual_gallery	import	✓	✓	✓	✓	—	—	—	—	—	—	—

✓: supported, (✓) partially supported, ⨉: not implemented, —: not supported by format.
cam: handle camera parameters, eg. intrisics
rig: handle rig structure.
img: handle the path to images.
trj: handle trajectories, eg. poses.
kpt: handle image keypoints locations.
dsc: handle image keypoints descriptors.
gft: handle global image feature descriptors.
p3D: handle 3D point clouds.
obs: handle observations, ie. 3D-points / 2D keypoints correspondences.
mch: handle keypoints matches.

5. kapture support in other packages

Local Features

R2D2 local features can be directly generated in kapture format. See here
D2-Net features can also be extracted in kapture format. See instructions here.

Global Features

AP-GeM global feature extractor in kapture format: here

6. Datasets

The kapture package provides conversion tools for several data formats and datasets used in the domain. But it also provides a tool to download datasets already converted to kapture. See the kapture tutorial for instructions to use the dataset downloader.

Here is a list of datasets you can directly download in kapture format with the downloader tool:

Datasets for the Long Term Visual Localization benchmark:
- NAVER LABS localization datasets
- Aachen Day Night v1.1
- Extended CMU-Seasons
- RobotCar Seasons v2
- InLoc (without images)
- SILDa Weather and Time of Day
- RIO10
- ETH-Microsoft
Virtual Gallery dataset

7. kapture-localization

Checkout kapture-localization, our toolbox which contains implementations for various localization related algorithms.

mapping and localization pipelines with custom features
mapping and localization pipelines with SIFT and vocabulary tree matching (default colmap pipeline)
image retrieval benchmark (global sfm, local sfm, pose approximation)

8. Tutorial

See the kapture tutorial for a short introduction to:

conversion tools
using kapture in your code
dataset download

9. Contributing

There are many ways to contribute to the kapture project:

provide feedback and suggestions of improvements
submit bug reports in the project bug tracker
provide a dataset in kapture format that we can add to the downloader tool
implement a feature or bug-fix for an outstanding issue
add support of kapture format in other software packages (e.g. SfM pipelines…), thus adding support for more datasets
provide scripts to create data in kapture format (e.g. local/global feature extraction)
propose a new feature and implement it

If you wish to contribute, please refer to the CONTRIBUTING page.

10. License

Software license is detailed in the LICENSE file.

11. Contact Us

You can contact us through GitHub, or at kapture at naverlabs + com

鲜花

握手

雷人

路过

鸡蛋

该文章已有0人参与评论

请发表评论

全部评论

专题导读

More+

10-27 六六分期app的软件客服如何联系？(六六分期

11-06 可心卡盟:win10系统火狐flash插件崩溃怎么

11-06 亲亲特价:怎么删除回收站图标

11-06 济南大学虚拟社区:鲁大师节能降温的具体办

11-06 xlueops.exe:无线网络安装向导

11-06 女斗合众国:win7系统cf与主机连接不稳定怎

11-06 0xc000022-[cf烟雾头]cf怎么调烟雾头

11-06 qizideyouhuo:应用程序无法正常启动0xc0000

11-06 ipz-185:win7系统vcf文件怎么打开

11-06 傻哥蹦迪:win10系统s4怎么打开usb调试

11-06 八神浩树gtaste:回收站清空了怎么恢复

11-06 妖尾之黑色守护:win10系统电脑没有1440x900

11-06 校园至尊魔王小说:win7系统浏览网页时字体

11-06 女斗合众国:win10系统访问共享文件夹提示请

11-06 tokyo hot n0654:恢复win7系统默认字体一招

11-06 雨酷仙境:设置win7系统转移临时文件夹腾出

11-06 阿穆纳伊之杖:win7系统开始菜单在右边还原

11-06 tunespotting:win10系统火狐flash插件总是

11-06 甘尔葛分析师：计谋网站seo关键词暴涨有什

11-06 蔡贵霖: 计谋网站seo关键词暴涨有什么秘密

11-06 博益网首页:ao3网页版进入不了解决方法

11-06 漏斗子专栏: 网站数据分析小白易懂精华篇

11-06 见证双虹怎么做:win7系统开启telnet命令的

11-06 颾狐蝶蜋:系统资源不足无法完成请求的服务

11-06 国光中学校歌:提交网站到alexa查询详细步骤

11-06 西安有情天:静态网页和动态网页的区别

11-06 红木雅尚斋:外部链接构造对网站的好处

11-06 前官礼遇：防止域名劫持–增强域安全性的10

11-06 密传二转答案: 中文分词算法有哪些

11-06 金泉家园邮编:百度快照劫持的表现及应对方

vasgaowei/TS-CAM: Codes for TS-CAM: Token Semantic Coupled Attention Map for Wea ...发布时间：2022-08-16

ColumbiaDVMM/CDC: CDC: Convolutional-De-Convolutional Networks for Precise Tempo ...发布时间：2022-08-16

剪的笔顺,诠释剪的笔画,认识剪的部首

1 六六分期app的软件客服如何联系？(六六分期

六六分期app的软件客服如何联系？不知道吗？加qq群【895510560】即可！标题：六六分期

阅读：18917|2023-10-27

2 可心卡盟:win10系统火狐flash插件崩溃怎么

今天小编告诉大家如何处理win10系统火狐flash插件总是崩溃的问题，可能很多用户都不知

阅读：9902|2022-11-06

3 亲亲特价:怎么删除回收站图标

今天小编告诉大家如何对win10系统删除桌面回收站图标进行设置，可能很多用户都不知道

阅读：8296|2022-11-06

4 济南大学虚拟社区:鲁大师节能降温的具体办

今天小编告诉大家如何对win10系统电脑设置节能降温的设置方法，想必大家都遇到过需要

阅读：8656|2022-11-06

5 xlueops.exe:无线网络安装向导

我们在使用xp系统的过程中,经常需要对xp系统无线网络安装向导设置进行设置，可能很多

阅读：8588|2022-11-06

6 女斗合众国:win7系统cf与主机连接不稳定怎

今天小编告诉大家如何处理win7系统玩cf老是与主机连接不稳定的问题，可能很多用户都不

阅读：9596|2022-11-06

7 0xc000022-[cf烟雾头]cf怎么调烟雾头

电脑对日常生活的重要性小编就不多说了，可是一旦碰到win7系统设置cf烟雾头的问题，很

阅读：8581|2022-11-06

8 qizideyouhuo:应用程序无法正常启动0xc0000

我们在日常使用电脑的时候，有的小伙伴们可能在打开应用的时候会遇见提示应用程序无法

阅读：7970|2022-11-06

9 ipz-185:win7系统vcf文件怎么打开

今天小编告诉大家如何对win7系统打开vcf文件进行设置，可能很多用户都不知道怎么对win

阅读：8589|2022-11-06

10 傻哥蹦迪:win10系统s4怎么打开usb调试

今天小编告诉大家如何对win10系统s4开启USB调试模式进行设置，可能很多用户都不知道怎

阅读：7509|2022-11-06

客服电话

电子邮件

naver/kapture: kapture is a file format as well as a set of tools for manipulati ...

开源软件名称（OpenSource Name）：

开源软件地址(OpenSource Url)：

开源编程语言(OpenSource Language)：

开源软件介绍(OpenSource Introduction)：

1. Overview

2. Specifications

3. Example File Structure

4. Software

Install

Using docker

kapture Python library

kapture tools

5. kapture support in other packages

Local Features

Global Features

6. Datasets

7. kapture-localization

8. Tutorial

9. Contributing

10. License

11. Contact Us

请发表评论

全部评论

上一篇：

下一篇：

bradtraversy/iweather: Ionic 3 mobile we

joaomh/curso-de-matlab

断牙刷新位置时间（断牙属性及刷新位置介绍

rugk/mastodon-simplified-federation: Sim

delphi资源文件制作及使用详解

剪的笔顺,诠释剪的笔画,认识剪的部首

六六分期app的软件客服如何联系？(六六分期

florent37/ViewAnimator: A fluent Android

florent37/Shrine-MaterialDesign2: implem

CVE-2020-36276

SimpleSoftwareIO/simple-sms: Send and re

关于我们

产品与服务

解决方案

139-2527-9053