From 0c78e5a104d621a6c1406c181d6a724cd191ac29 Mon Sep 17 00:00:00 2001 From: ob-yalian Date: Wed, 26 Aug 2026 11:54:33 +0800 Subject: [PATCH] docs: document ROS2 timestamp CSV rotation --- docs/en/source/camera_devices/6_benchmark/diagnostic_tools.md | 4 ++++ docs/zh/source/camera_devices/6_benchmark/diagnostic_tools.md | 4 ++++ 2 files changed, 8 insertions(+) diff --git a/docs/en/source/camera_devices/6_benchmark/diagnostic_tools.md b/docs/en/source/camera_devices/6_benchmark/diagnostic_tools.md index 5b8660b7..7d52dd3c 100644 --- a/docs/en/source/camera_devices/6_benchmark/diagnostic_tools.md +++ b/docs/en/source/camera_devices/6_benchmark/diagnostic_tools.md @@ -14,6 +14,10 @@ frame_timestamp_csv_file:=/tmp/frame_timestamp.csv The CSV contains SDK frame index, hardware frame number, sensor timestamp, device/global/system timestamp, steady arrival/publish delta, ROS publish duration, and SDK delay fields. +### CSV Rotation + +Each CSV file contains at most `1,024,575` frame rows plus the header. When the limit is reached, the logger automatically starts the next indexed file, for example `frame_timestamp_1.csv` and `frame_timestamp_2.csv`. + ### Field Description The current CSV contains two groups of fields with the same structure, prefixed by `color_` and `depth_`, for example `color_sdk_frame_index` and `depth_sdk_frame_index`. The two groups have identical definitions and differ only in data source. diff --git a/docs/zh/source/camera_devices/6_benchmark/diagnostic_tools.md b/docs/zh/source/camera_devices/6_benchmark/diagnostic_tools.md index 72958fd3..6080518c 100644 --- a/docs/zh/source/camera_devices/6_benchmark/diagnostic_tools.md +++ b/docs/zh/source/camera_devices/6_benchmark/diagnostic_tools.md @@ -14,6 +14,10 @@ frame_timestamp_csv_file:=/tmp/frame_timestamp.csv CSV 中包含 SDK frame index、hardware frame number、sensor timestamp、device/global/system timestamp、steady arrival/publish delta、ROS 发布耗时以及 SDK delay 等字段。 +### CSV 分片 + +每个 CSV 文件最多保存 `1,024,575` 行帧数据和 1 行表头。达到上限后，日志器会自动写入下一个带序号的文件，例如 `frame_timestamp_1.csv`、`frame_timestamp_2.csv`。 + ### 字段说明 当前 CSV 中包含两组同构字段，分别以 `color_` 和 `depth_` 为前缀，例如 `color_sdk_frame_index` 和 `depth_sdk_frame_index`。两组字段定义完全一致，仅数据来源不同。