Skip to main content

ROS Point Cloud Recorder and Exporter

Project description

ROS PointCloud Recorder

一个简单的Python库,用于录制ROS点云话题并导出为PCD文件。

Github地址:https://github.com/Knighthood2001/ros-pointcloud-recorder

依赖

重点说明:安装这个项目包的时候,我没有指定需要安装pcl-rosrosbag,但是你在使用的时候,是需要有这个包的,因为这两个包,一般都是通过apt install ros-<ros版本>-pcl-rosapt install ros-<ros版本>-rosbag安装的,所以你需要先安装这两个包。

  • ROS (必须安装rosbagpcl_ros),因此你需要先安装ROS环境,才能使用ros-pointcloud-recorder。
  • Python 3.6+

安装

pip install ros-pointcloud-recorder

快速开始

from ros_pointcloud_recorder import PointCloudRecorder
# 创建录制器
recorder = PointCloudRecorder(
    topics=['/points_raw1', '/points_raw2'],
    output_dir='./data',
    recording_duration=2.0
)

# 执行录制并导出
pcd_paths = recorder.record_and_export()

print("导出完成:")
for topic, path in pcd_paths.items():
    print(f"{topic} -> {path}")

高级功能

  • 自定义导出路径
  • 单独控制录制和导出流程
  • 自定义日志配置
  • 保留中间bag文件

详细用法请参考示例代码

设计要点

  1. 模块化设计:将功能分解为可独立调用的方法
  2. 灵活性:支持自定义路径、录制时长等参数
  3. 健壮性:完善的错误处理和日志记录
  4. 易用性:提供简单的一键录制导出方法
  5. 可扩展性:设计良好的API便于未来扩展功能

通过这种封装,用户只需简单的几行代码就可以实现点云录制功能,同时保留了高级用户需要的灵活性。

更新日志

  • v0.1.0 (2025-06-10)
    • 初始发布,提供基本的点云录制和导出功能
  • v0.1.1 (2025-06-10)
    • 修改了README.md
  • v0.1.2 (2025-06-10)
    • 修改了requirements.txt
  • v0.1.2 (2025-06-10)
    • 修改了README.md
    • 修改了setup.py

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

ros-pointcloud-recorder-0.1.3.tar.gz (4.7 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

ros_pointcloud_recorder-0.1.3-py3-none-any.whl (5.1 kB view details)

Uploaded Python 3

File details

Details for the file ros-pointcloud-recorder-0.1.3.tar.gz.

File metadata

  • Download URL: ros-pointcloud-recorder-0.1.3.tar.gz
  • Upload date:
  • Size: 4.7 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.8.10

File hashes

Hashes for ros-pointcloud-recorder-0.1.3.tar.gz
Algorithm Hash digest
SHA256 17ab8034769d472af82fa190acb76577ff3cbb16ae384c79a8391914cd4a494b
MD5 92f0739152a62672bbcfb12f4edd4773
BLAKE2b-256 664f26ccaa15d270fa2bdd6ce69a84ce6fe4592fe761a5ac2fa5dd999a3350bc

See more details on using hashes here.

File details

Details for the file ros_pointcloud_recorder-0.1.3-py3-none-any.whl.

File metadata

File hashes

Hashes for ros_pointcloud_recorder-0.1.3-py3-none-any.whl
Algorithm Hash digest
SHA256 5acadcc407084013f2fef1ca0352e05e9d6a316408fb1d0248e52dad9a8124d4
MD5 3692af215e6920961c24914b4f3b5e2c
BLAKE2b-256 b4774754f464f79d17abcddd7e3f520ffaa81f1520af6167ba61690b66df05f4

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page