Device Repository Tool
An easy way to keep RGBD devices' data unified.
Device Repository Tool was designed in order to collect and unify RGBD devices data in an easy matter into one human-readable JSON file called device_repository.json . For every device that was added using Device Repository Tool, an entry is being created containing data such as, camera intrinsic matrix (for color and depth sensors), color-depth sensors relative pose (usually called extrinsic camera matrix), name (specified by user at the time of insertion) and more.
Having a handful of RGBD devices makes their management troublesome. Usually RGBD sensors provide some camera info through their API (intrinsic and extrinsic matrices), making the presence of the device necessary in order to access these data. When working offline with pre-captured files, this information may be required for some tasks(such as creating a pointcloud from a depth map, process that requires the camera intrinsic matrix) finding and connecting the corresponding devices is at least troublesome. To deal with problems like above, Device Repository Tool creates a file containing all devices a user want which can be used at every other application wanted.
Device Repository Tool is a single executable, which is executed from Windows command line in a very simple manner. Supported functionalities are:
Device repository creator.
Usage: device_repository.exe [OPTIONS]
Options:
-h,--help Print this help message and exit
-a,--add TEXT Excludes: -r,--rename
Add a device into the device repository.
-r,--rename TEXT ... Excludes: -d,--delete
Rename a device.
-d,--delete TEXT Excludes: -l,--list
Deletes a device from the repository
-l,--list List all devices in device repository.
-p,--path TEXT=. Directory where to store "device_repository.json" file.
-
Adding a device to the repository. In order to add a device to the repository, one just need to connect one device (otherwise an error will be logged) to the computer and run the command
device_repository.exe --add device_name
Note: If "device_repository.json" does not exist in the path specified (defaulted to the local directory), it with create one in the local directory. If device_name already exists, the error with be logged to the console.
-
Renaming a device in the repository. In order to change the name of the device simply execute
device_repository.exe --rename old_name new_name
-
Deleting a device from the repository.
To delete a device from the device repository, execute
device_repository.exe --delete device_name
-
Listing all devices in the repository.
In order to peek into the file from the console to determine which devices are already added, execute
device_repository.exe --list
