You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
56 lines
2.1 KiB
56 lines
2.1 KiB
# rs-data-collect Tool
|
|
|
|
## Goal
|
|
|
|
This tool is designed to help collect statistics about various streams. For full data capture, you can use [recorder](../recorder/) or [realsense-viewer](../realsense-viewer).
|
|
|
|
## Description
|
|
Given a configuration file the tool will configure the first Realsense device recognized to the desired streams and wait for either set number of frames or a timeout.
|
|
The tool uses `best-effort` to satisfy the maximum of the user-requested profiles. Configuration that are either not supported or ill-formatted will be reported.
|
|
The tools is designed as a low-latency profiler with zero frames drops, and therefore utilizes the Librealsense low-level sensor API with callbacks.
|
|
For each frame, timestamp, frame-number, time of arrival, stream profile, index and timestamp domain will be recorded into the output log. For the tracking-supported devices (D435i/T260) the motion data is recorded as well
|
|
**The tool does not record the content of video frames**
|
|
|
|
|
|
## Command Line Parameters
|
|
|
|
|Flag |Description |Default|
|
|
|---|---|---|
|
|
|`-c <filename>`|Load stream configuration from <filename>||
|
|
|`-m X`|Stop the test after receiving at least X frames|100|
|
|
|`-t X`|Stop the test after X seconds|10|
|
|
|`-f <filename>`|Save results into <filename>||
|
|
|
|
For example:
|
|
`rs-data-collect -c ./data_collect.cfg -f ./log.csv -t 60 -m 1000`
|
|
will apply streaming configuration from `./data_collect.cfg`to, then stream and collect the data for 60 seconds or 1000 frames (whatever comes first).
|
|
The resulted data will be saved into `./log.csv` file.
|
|
|
|
### Config File Format
|
|
```
|
|
STREAM1,WIDTH1,HEIGHT1,FPS1,FORMAT1,STREAM_INDEX1
|
|
STREAM2,WIDTH2,HEIGHT2,FPS2,FORMAT2,STREAM_INDEX1
|
|
...
|
|
```
|
|
Practical examples:
|
|
D415/D435
|
|
```
|
|
DEPTH,640,480,30,Z16,0
|
|
INFRARED,640,480,30,Y8,1
|
|
INFRARED,640,480,30,Y8,2
|
|
COLOR,640,480,30,RGB8,0
|
|
```
|
|
|
|
D435i
|
|
```
|
|
#Video streams
|
|
DEPTH,640,480,30,Z16,0
|
|
INFRARED,640,480,30,Y8,1
|
|
INFRARED,640,480,30,Y8,2
|
|
COLOR,640,480,30,RGB8,0
|
|
#Lines starting with non-alpha character (#@!...) will be skipped
|
|
# IMU streams will produce data in m/sec^2 & rad/sec
|
|
ACCEL,1,1,63,MOTION_XYZ32F
|
|
GYRO,1,1,200,MOTION_XYZ32F
|
|
```
|