Package symbol

ouster_ros package from ouster-ros repo

ouster_ros ouster_sensor_msgs

ROS Distro
humble

Package Summary

Tags No category tags.
Version 0.13.14
License BSD
Build type AMENT_CMAKE
Use RECOMMENDED

Repository Summary

Description Official ROS drivers for Ouster sensors (OS0, OS1, OS2, OSDome)
Checkout URI https://github.com/ouster-lidar/ouster-ros.git
VCS Type git
VCS Version humble-devel
Last Updated 2025-09-23
Dev Status DEVELOPED
Released RELEASED
Tags point-cloud ros lidar pcl pointcloud ros2 ros-melodic ouster ros-noetic ros2-foxy ros-drivers ros2-rolling ros2-humble ros2-iron ros2-jazzy
Contributing Help Wanted (-)
Good First Issues (-)
Pull Requests to Review (-)

Package Description

Ouster ROS2 driver

Additional Links

No additional links.

Maintainers

  • ouster developers

Authors

No additional authors.
README
No README found. See repository README.
CHANGELOG

Changelog for package ouster_ros

0.13.14 (2025-09-22)

  • Add ouster-sdk directly

  • Drop whole archive linkage (#489)

  • fix-rolling build (#483)

  • Correct pointcloud.is_dense flag (#473)

  • Port the pointcloud mask feature to ROS2 (#462)

    • Port the pointcloud mask feature to ROS2
    • Base Image fixed
    • Update README and exclude iron from the build
  • [ROS2] Expose the vertical beam reduction param (#444)

    • Expose the vertical beam reduction value + rename arg + Better handling of deprecated topic names
  • ROS-317: Fix simulation in replay mode (#440)

    • Use node clock to properly populate the timestamp in replay modes
    • Update changelog and package number
  • Implement a padding-free version of pcl::PointXYZI (#439)

  • Add a new storage param to record.launch.xml (#437)

    • Add storage param to record
  • [ros2] Fix install directories (#433)

    • Cmakelists: Fix install directories
    • Bump package.xml patch version

    * Update changelog ---------Co-authored-by: Michael Wiznitzer <<mwiznitzer@neyarobotics.com>>

  • Port the changes to ROS2 (#430)

    • Port the changes to ROS2
    • Update sensor.*.launch
  • SW-6906: publish sensor telemetry in ouster ros (#422)

    • Port changes from ROS1 to ROS2
    • Mention TLM as an option in yaml configs
  • Enable auto start on replay node (#421)

  • ROS-389 [rolling/humble/iron/jazzy]: replay-improvments-and-fixes (#393) Remap metadata topic + Support loop capability in pcap replay + Add play_delay & play_rate for replay Added a launch file parameter pub_static_tf to disable sensor transforms broadcast ---------Co-authored-by: Guillaume Doisy <<guillaume@dexory.com>>

  • ROS-350[HUMBLE/IRON/JAZZY]: 't' timestamp field content is not plausible (#387) Align timestamps based on staggered/destaggered option

  • HOTFIX/ROS-382: os_driver fails when raw option is enabled (#384)

    • Fix os_driver fails when RAW option is enabled
    • Replace lifecycle_publisher with regular publisher for the os_pcap
  • HOTFIX/ROS-376-initialize-the-sensor-with-launch-config-params (#380)

    • Invoke parse_config_from_ros_parameters on node init
    • Fix a typo + Add a note regarding the recommendation
  • [HUMBLEJAZZY] Port ROS-363 to ROS2 (#369)

    • Port ROS-363 to ROS2
    • Turn off OSF
    • Update package version and CHANGELOG.rst + up the default max range to 10000.0 meters
  • ROS-368[HUMBLEJAZZY]: Unable to use the replay mode due to unknown substitution arg (#370)

    • Fix replay unknown substitution arg
    • Fix the definition of _loop variable
    • Move remap verb to the node
  • ROS-119: ouster-ros driver automatic reconnection [HUMBLE/IRON/JAZZY] (#362)

    • Port sensor reconnection logic to ROS 2
    • Add Jazzy to the build!
    • Update README and checkout
    • Add a note about not being able to properly handle invalid configuration

File truncated at 100 lines see the full file

Launch files

  • launch/record.composite.launch.xml
      • storage [default: sqlite3]
      • ouster_ns [default: ouster]
      • sensor_hostname
      • udp_dest [default: ]
      • lidar_port [default: 0]
      • imu_port [default: 0]
      • udp_profile_lidar [default: ]
      • lidar_mode [default: ]
      • timestamp_mode [default: ]
      • ptp_utc_tai_offset [default: -37.0]
      • metadata [default: ]
      • bag_file [default: ]
      • viz [default: true]
      • rviz_config [default: $(find-pkg-share ouster_ros)/config/viz-reliable.rviz]
      • sensor_frame [default: os_sensor]
      • lidar_frame [default: os_lidar]
      • imu_frame [default: os_imu]
      • point_cloud_frame [default: ]
      • pub_static_tf [default: true]
      • use_system_default_qos [default: true]
      • proc_mask [default: IMG|PCL|IMU|SCAN|TLM]
      • scan_ring [default: 0]
      • point_type [default: original]
      • organized [default: true]
      • destagger [default: true]
      • min_range [default: 0.0]
      • max_range [default: 100000.0]
      • azimuth_window_start [default: 0]
      • azimuth_window_end [default: 360000]
      • persist_config [default: false]
      • attempt_reconnect [default: false]
      • dormant_period_between_reconnects [default: 1.0]
      • max_failed_reconnect_attempts [default: 2147483647]
      • auto_start [default: true]
      • min_scan_valid_columns_ratio [default: 0.0]
      • v_reduction [default: 1]
      • mask_path [default: ]
  • launch/record.launch.xml
      • storage [default: sqlite3]
      • ouster_ns [default: ouster]
      • sensor_hostname
      • udp_dest [default: ]
      • lidar_port [default: 0]
      • imu_port [default: 0]
      • udp_profile_lidar [default: ]
      • lidar_mode [default: ]
      • timestamp_mode [default: ]
      • ptp_utc_tai_offset [default: -37.0]
      • metadata [default: ]
      • bag_file [default: ]
      • viz [default: true]
      • rviz_config [default: $(find-pkg-share ouster_ros)/config/viz-reliable.rviz]
      • sensor_frame [default: os_sensor]
      • lidar_frame [default: os_lidar]
      • imu_frame [default: os_imu]
      • point_cloud_frame [default: ]
      • pub_static_tf [default: true]
      • use_system_default_qos [default: true]
      • proc_mask [default: IMG|PCL|IMU|SCAN|TLM]
      • scan_ring [default: 0]
      • point_type [default: original]
      • organized [default: true]
      • destagger [default: true]
      • min_range [default: 0.0]
      • max_range [default: 100000.0]
      • azimuth_window_start [default: 0]
      • azimuth_window_end [default: 360000]
      • persist_config [default: false]
      • attempt_reconnect [default: false]
      • dormant_period_between_reconnects [default: 1.0]
      • max_failed_reconnect_attempts [default: 2147483647]
      • auto_start [default: true]
      • min_scan_valid_columns_ratio [default: 0.0]
      • v_reduction [default: 1]
      • mask_path [default: ]
  • launch/replay.composite.launch.xml
      • loop [default: false]
      • play_delay [default: 0]
      • play_rate [default: 1.0]
      • ouster_ns [default: ouster]
      • timestamp_mode [default: ]
      • ptp_utc_tai_offset [default: -37.0]
      • metadata [default: ]
      • bag_file
      • viz [default: true]
      • rviz_config [default: $(find-pkg-share ouster_ros)/config/viz-reliable.rviz]
      • sensor_frame [default: os_sensor]
      • lidar_frame [default: os_lidar]
      • imu_frame [default: os_imu]
      • point_cloud_frame [default: ]
      • pub_static_tf [default: true]
      • use_system_default_qos [default: true]
      • proc_mask [default: IMG|PCL|IMU|SCAN]
      • scan_ring [default: 0]
      • point_type [default: original]
      • organized [default: true]
      • destagger [default: true]
      • min_range [default: 0.0]
      • max_range [default: 100000.0]
      • min_scan_valid_columns_ratio [default: 0.0]
      • v_reduction [default: 1]
      • mask_path [default: ]
  • launch/replay.launch.xml
      • loop [default: false]
      • play_delay [default: 0]
      • play_rate [default: 1.0]
      • ouster_ns [default: ouster]
      • timestamp_mode [default: ]
      • ptp_utc_tai_offset [default: -37.0]
      • metadata [default: ]
      • bag_file
      • viz [default: true]
      • rviz_config [default: $(find-pkg-share ouster_ros)/config/viz-reliable.rviz]
      • sensor_frame [default: os_sensor]
      • lidar_frame [default: os_lidar]
      • imu_frame [default: os_imu]
      • point_cloud_frame [default: ]
      • pub_static_tf [default: true]
      • use_system_default_qos [default: true]
      • proc_mask [default: IMG|PCL|IMU|SCAN]
      • scan_ring [default: 0]
      • point_type [default: original]
      • organized [default: true]
      • destagger [default: true]
      • min_range [default: 0.0]
      • max_range [default: 100000.0]
      • min_scan_valid_columns_ratio [default: 0.0]
      • v_reduction [default: 1]
      • mask_path [default: ]
  • launch/replay_pcap.launch.xml
      • loop [default: false]
      • play_delay [default: 0]
      • progress_update_freq [default: 1.0]
      • ouster_ns [default: ouster]
      • timestamp_mode [default: TIME_FROM_INTERNAL_OSC]
      • ptp_utc_tai_offset [default: -37.0]
      • metadata
      • pcap_file
      • viz [default: true]
      • rviz_config [default: $(find-pkg-share ouster_ros)/config/viz-reliable.rviz]
      • sensor_frame [default: os_sensor]
      • lidar_frame [default: os_lidar]
      • imu_frame [default: os_imu]
      • point_cloud_frame [default: ]
      • pub_static_tf [default: true]
      • use_system_default_qos [default: true]
      • proc_mask [default: IMG|PCL|IMU|SCAN]
      • scan_ring [default: 0]
      • point_type [default: original]
      • organized [default: true]
      • destagger [default: true]
      • min_range [default: 0.0]
      • max_range [default: 10000.0]
      • min_scan_valid_columns_ratio [default: 0.0]
      • v_reduction [default: 1]
      • mask_path [default: ]
  • launch/rviz.launch.xml
      • ouster_ns [default: ouster]
      • rviz_config [default: $(find-pkg-share ouster_ros)/config/viz.rviz]
  • launch/sensor.composite.launch.xml
      • ouster_ns [default: ouster]
      • sensor_hostname
      • udp_dest [default: ]
      • lidar_port [default: 0]
      • imu_port [default: 0]
      • udp_profile_lidar [default: ]
      • lidar_mode [default: ]
      • timestamp_mode [default: ]
      • ptp_utc_tai_offset [default: -37.0]
      • metadata [default: ]
      • viz [default: true]
      • rviz_config [default: $(find-pkg-share ouster_ros)/config/viz.rviz]
      • sensor_frame [default: os_sensor]
      • lidar_frame [default: os_lidar]
      • imu_frame [default: os_imu]
      • point_cloud_frame [default: ]
      • pub_static_tf [default: true]
      • use_system_default_qos [default: false]
      • proc_mask [default: IMG|PCL|IMU|SCAN|TLM]
      • scan_ring [default: 0]
      • point_type [default: original]
      • azimuth_window_start [default: 0]
      • azimuth_window_end [default: 360000]
      • persist_config [default: false]
      • attempt_reconnect [default: false]
      • dormant_period_between_reconnects [default: 1.0]
      • max_failed_reconnect_attempts [default: 2147483647]
      • auto_start [default: true]
      • organized [default: true]
      • destagger [default: true]
      • min_range [default: 0.0]
      • max_range [default: 10000.0]
      • min_scan_valid_columns_ratio [default: 0.0]
      • v_reduction [default: 1]
      • mask_path [default: ]
  • launch/sensor.independent.launch.xml
      • ouster_ns [default: ouster]
      • sensor_hostname
      • udp_dest [default: ]
      • lidar_port [default: 0]
      • imu_port [default: 0]
      • udp_profile_lidar [default: ]
      • lidar_mode [default: ]
      • timestamp_mode [default: ]
      • ptp_utc_tai_offset [default: -37.0]
      • metadata [default: ]
      • viz [default: true]
      • rviz_config [default: $(find-pkg-share ouster_ros)/config/viz.rviz]
      • sensor_frame [default: os_sensor]
      • lidar_frame [default: os_lidar]
      • imu_frame [default: os_imu]
      • point_cloud_frame [default: ]
      • pub_static_tf [default: true]
      • use_system_default_qos [default: false]
      • proc_mask [default: IMG|PCL|IMU|SCAN]
      • scan_ring [default: 0]
      • point_type [default: original]
      • azimuth_window_start [default: 0]
      • azimuth_window_end [default: 360000]
      • persist_config [default: false]
      • attempt_reconnect [default: false]
      • dormant_period_between_reconnects [default: 1.0]
      • max_failed_reconnect_attempts [default: 2147483647]
      • auto_start [default: true]
      • min_scan_valid_columns_ratio [default: 0.0]
  • launch/sensor.launch.xml
      • ouster_ns [default: ouster]
      • sensor_hostname
      • udp_dest [default: ]
      • lidar_port [default: 0]
      • imu_port [default: 0]
      • udp_profile_lidar [default: ]
      • lidar_mode [default: ]
      • timestamp_mode [default: ]
      • ptp_utc_tai_offset [default: -37.0]
      • metadata [default: ]
      • viz [default: true]
      • rviz_config [default: $(find-pkg-share ouster_ros)/config/viz.rviz]
      • sensor_frame [default: os_sensor]
      • lidar_frame [default: os_lidar]
      • imu_frame [default: os_imu]
      • point_cloud_frame [default: ]
      • pub_static_tf [default: true]
      • use_system_default_qos [default: false]
      • proc_mask [default: IMG|PCL|IMU|SCAN|TLM]
      • scan_ring [default: 0]
      • point_type [default: original]
      • azimuth_window_start [default: 0]
      • azimuth_window_end [default: 360000]
      • persist_config [default: false]
      • attempt_reconnect [default: false]
      • dormant_period_between_reconnects [default: 1.0]
      • max_failed_reconnect_attempts [default: 2147483647]
      • auto_start [default: true]
      • organized [default: true]
      • destagger [default: true]
      • min_range [default: 0.0]
      • max_range [default: 10000.0]
      • min_scan_valid_columns_ratio [default: 0.0]
      • v_reduction [default: 1]
      • mask_path [default: ]
  • launch/sensor_mtp.launch.xml
      • ouster_ns [default: ouster]
      • sensor_hostname
      • udp_dest
      • mtp_dest [default: ]
      • mtp_main [default: false]
      • lidar_port [default: 0]
      • imu_port [default: 0]
      • udp_profile_lidar [default: ]
      • lidar_mode [default: ]
      • timestamp_mode [default: ]
      • ptp_utc_tai_offset [default: -37.0]
      • metadata [default: ]
      • viz [default: true]
      • rviz_config [default: $(find-pkg-share ouster_ros)/config/viz.rviz]
      • sensor_frame [default: os_sensor]
      • lidar_frame [default: os_lidar]
      • imu_frame [default: os_imu]
      • point_cloud_frame [default: ]
      • pub_static_tf [default: true]
      • use_system_default_qos [default: false]
      • proc_mask [default: IMG|PCL|IMU|SCAN|TLM]
      • scan_ring [default: 0]
      • point_type [default: original]
      • azimuth_window_start [default: 0]
      • azimuth_window_end [default: 360000]
      • persist_config [default: false]
      • attempt_reconnect [default: false]
      • dormant_period_between_reconnects [default: 1.0]
      • max_failed_reconnect_attempts [default: 2147483647]
      • auto_start [default: true]

Messages

No message files found.

Services

No service files found

Plugins

No plugins found.

Recent questions tagged ouster_ros at Robotics Stack Exchange

Package symbol

ouster_ros package from ouster-ros repo

ouster_ros ouster_sensor_msgs

ROS Distro
jazzy

Package Summary

Tags No category tags.
Version 0.11.1
License BSD
Build type AMENT_CMAKE
Use RECOMMENDED

Repository Summary

Description Official ROS drivers for Ouster sensors (OS0, OS1, OS2, OSDome)
Checkout URI https://github.com/ouster-lidar/ouster-ros.git
VCS Type git
VCS Version rolling-devel
Last Updated 2023-11-01
Dev Status DEVELOPED
Released RELEASED
Tags point-cloud ros lidar pcl pointcloud ros2 ros-melodic ouster ros-noetic ros2-foxy ros-drivers ros2-rolling ros2-humble ros2-iron ros2-jazzy
Contributing Help Wanted (-)
Good First Issues (-)
Pull Requests to Review (-)

Package Description

Ouster ROS2 driver

Additional Links

No additional links.

Maintainers

  • Ussama Naal
  • ouster developers

Authors

No additional authors.
README
No README found. See repository README.
CHANGELOG

Changelog for package ouster_ros

0.11.1 (2023-11-01)

  • breaking: rename ouster_msgs to ouster_sensor_msgs
  • shutdown the driver when unable to connect to the sensor on startup

0.10.4 (2023-08-31)

  • breaking: publish PCL point clouds destaggered.
  • introduced a new launch file parameter ptp_utc_tai_offset which represent offset in seconds to be applied to all ROS messages the driver generates when TIME_FROM_PTP_1588 timestamp mode is used.
  • fix: destagger columns timestamp when generating destaggered point clouds.
  • Use the local copy of the LICENSE file during install
  • Contributors: Ussama Naal

0.10.3 (2023-08-15)

  • Add per package LICENSE file
  • manifest symbolic links as files
  • Contributors: Ussama Naal

0.10.2 (2023-08-15)

  • SW-5396: publish point cloud in destaggered form (#182)

    • Quick implementtion of cloud destaggering
    • Perform destaggering of point clouds during the copy + add a viz-reliable file + wrap all classes in ouster_ros
    • Update changelog and version
    • Reformat changelog
  • SW-5345: merge-ouster-srvs into ouster-msgs (#176)

    • Merge ouster-srvs into ouster-msgs package + Update dockerfile + Other fixes and code improvements
    • Update launch file name within the dockerfile
    • Update CHANGELOG.txt
    • Update ouster_ros package version to highlight the breadking change due obseleting ouster_srvs
    • Use angle brackets for external headers
    • Remove unused library include
    • Remove unused launch params in sensor_mtp.launch
    • Fix the table of contents
  • SW-5167: follow ups from SW-5167-fix-black-columns-when-recording-under-ros-foxy (#163)

    * Initialize point_cloud_frame with an empty string + and expose point_cloud_frame through launch xml files + Remove unused/duplicate param definitions + Update descriptions

    • Correct the name of the node to be activated for merged node
  • ROS compatibility mode dual returns fix (#156)

    • Separately initialize vector elements
    • Update changelog and package version
    • Properly check for the write_text_to_file success
  • ROS2 compatibility mode (#146)

    • Factoring out Imu and Lidar packets handling

    * Added os_driver which combines os_sensor and os_cloud + Added required launch files + Better abstraction of classes + Simplified threading logic + Added thread safe implemention of ring buffer (not hooked yet)

    • Move down pragma once in the handlers
    • Adding unit tests for the ThreadSafeRingBuffer
    • Add one more case to the unit test of ThreadSafeRingBuffer
    • Quick hook up of the ThreadSafeRingBuffer for os_sensor and os_driver
    • Add an option to select the point_cloud frame
    • Keep transforms in Lidar Frame by default with option to switch
    • Formatting os_sensor and os_driver
    • Provide support for parsing the community driver params file with approprite launch file
    • Factor out tf transforms broadcast
    • Formatting imu and lidar packet handlers
    • Fix build issue
    • Incorporate LaserScan message composition
    • Refactor a bit and add the ability to process and publish point clouds and laser scans
    • Restor os_cloud_node ability to process point clouds
    • Parse proc_mask and hook to launch files and config
    • Add support for the selecting IMU + create topics/subs when their respective flags enabled
    • Reduce sync operations + restore sensor reset/reactivation
    • Add the ability to override current qos settings
    • Add minor note
    • More detailed explanation about the IMG node
    • Rename the file os_sensor_cloud_image_params to os_sensor_cloud_image_params.yaml and update corresponding launch files
    • Expose use_system_default_qos parameter to xml launch file and use proper defaults

File truncated at 100 lines see the full file

Launch files

  • launch/record.launch.xml
      • ouster_ns [default: ouster]
      • sensor_hostname
      • udp_dest [default: ]
      • lidar_port [default: 0]
      • imu_port [default: 0]
      • udp_profile_lidar [default: ]
      • lidar_mode [default: ]
      • timestamp_mode [default: ]
      • ptp_utc_tai_offset [default: -37.0]
      • metadata [default: ]
      • bag_file [default: ]
      • viz [default: true]
      • rviz_config [default: $(find-pkg-share ouster_ros)/config/viz-reliable.rviz]
      • sensor_frame [default: os_sensor]
      • lidar_frame [default: os_lidar]
      • imu_frame [default: os_imu]
      • point_cloud_frame [default: ]
      • use_system_default_qos [default: true]
      • proc_mask [default: IMG|PCL|IMU|SCAN]
      • scan_ring [default: 0]
  • launch/replay.launch.xml
      • ouster_ns [default: ouster]
      • timestamp_mode [default: ]
      • ptp_utc_tai_offset [default: -37.0]
      • metadata [default: ]
      • bag_file
      • viz [default: true]
      • rviz_config [default: $(find-pkg-share ouster_ros)/config/viz-reliable.rviz]
      • sensor_frame [default: os_sensor]
      • lidar_frame [default: os_lidar]
      • imu_frame [default: os_imu]
      • point_cloud_frame [default: ]
      • use_system_default_qos [default: true]
      • proc_mask [default: IMG|PCL|IMU|SCAN]
      • scan_ring [default: 0]
  • launch/rviz.launch.xml
      • ouster_ns [default: ouster]
      • rviz_config [default: $(find-pkg-share ouster_ros)/config/viz.rviz]
  • launch/sensor.independent.launch.xml
      • ouster_ns [default: ouster]
      • sensor_hostname
      • udp_dest [default: ]
      • lidar_port [default: 0]
      • imu_port [default: 0]
      • udp_profile_lidar [default: ]
      • lidar_mode [default: ]
      • timestamp_mode [default: ]
      • ptp_utc_tai_offset [default: -37.0]
      • metadata [default: ]
      • viz [default: true]
      • rviz_config [default: $(find-pkg-share ouster_ros)/config/viz.rviz]
      • sensor_frame [default: os_sensor]
      • lidar_frame [default: os_lidar]
      • imu_frame [default: os_imu]
      • point_cloud_frame [default: ]
      • use_system_default_qos [default: false]
      • proc_mask [default: IMG|PCL|IMU|SCAN]
      • scan_ring [default: 0]
  • launch/sensor.launch.xml
      • ouster_ns [default: ouster]
      • sensor_hostname
      • udp_dest [default: ]
      • lidar_port [default: 0]
      • imu_port [default: 0]
      • udp_profile_lidar [default: ]
      • lidar_mode [default: ]
      • timestamp_mode [default: ]
      • ptp_utc_tai_offset [default: -37.0]
      • metadata [default: ]
      • viz [default: true]
      • rviz_config [default: $(find-pkg-share ouster_ros)/config/viz.rviz]
      • sensor_frame [default: os_sensor]
      • lidar_frame [default: os_lidar]
      • imu_frame [default: os_imu]
      • point_cloud_frame [default: ]
      • use_system_default_qos [default: false]
      • proc_mask [default: IMG|PCL|IMU|SCAN]
      • scan_ring [default: 0]
  • launch/sensor_mtp.launch.xml
      • ouster_ns [default: ouster]
      • sensor_hostname
      • udp_dest
      • mtp_dest [default: ]
      • mtp_main [default: false]
      • lidar_port [default: 0]
      • imu_port [default: 0]
      • udp_profile_lidar [default: ]
      • lidar_mode [default: ]
      • timestamp_mode [default: ]
      • ptp_utc_tai_offset [default: -37.0]
      • metadata [default: ]
      • viz [default: true]
      • rviz_config [default: $(find-pkg-share ouster_ros)/config/viz.rviz]
      • sensor_frame [default: os_sensor]
      • lidar_frame [default: os_lidar]
      • imu_frame [default: os_imu]
      • point_cloud_frame [default: ]
      • use_system_default_qos [default: false]
      • proc_mask [default: IMG|PCL|IMU|SCAN]
      • scan_ring [default: 0]

Messages

No message files found.

Services

No service files found

Plugins

No plugins found.

Recent questions tagged ouster_ros at Robotics Stack Exchange

Package symbol

ouster_ros package from ouster-ros repo

ouster_ros ouster_sensor_msgs

ROS Distro
kilted

Package Summary

Tags No category tags.
Version 0.11.1
License BSD
Build type AMENT_CMAKE
Use RECOMMENDED

Repository Summary

Description Official ROS drivers for Ouster sensors (OS0, OS1, OS2, OSDome)
Checkout URI https://github.com/ouster-lidar/ouster-ros.git
VCS Type git
VCS Version rolling-devel
Last Updated 2023-11-01
Dev Status DEVELOPED
Released RELEASED
Tags point-cloud ros lidar pcl pointcloud ros2 ros-melodic ouster ros-noetic ros2-foxy ros-drivers ros2-rolling ros2-humble ros2-iron ros2-jazzy
Contributing Help Wanted (-)
Good First Issues (-)
Pull Requests to Review (-)

Package Description

Ouster ROS2 driver

Additional Links

No additional links.

Maintainers

  • Ussama Naal
  • ouster developers

Authors

No additional authors.
README
No README found. See repository README.
CHANGELOG

Changelog for package ouster_ros

0.11.1 (2023-11-01)

  • breaking: rename ouster_msgs to ouster_sensor_msgs
  • shutdown the driver when unable to connect to the sensor on startup

0.10.4 (2023-08-31)

  • breaking: publish PCL point clouds destaggered.
  • introduced a new launch file parameter ptp_utc_tai_offset which represent offset in seconds to be applied to all ROS messages the driver generates when TIME_FROM_PTP_1588 timestamp mode is used.
  • fix: destagger columns timestamp when generating destaggered point clouds.
  • Use the local copy of the LICENSE file during install
  • Contributors: Ussama Naal

0.10.3 (2023-08-15)

  • Add per package LICENSE file
  • manifest symbolic links as files
  • Contributors: Ussama Naal

0.10.2 (2023-08-15)

  • SW-5396: publish point cloud in destaggered form (#182)

    • Quick implementtion of cloud destaggering
    • Perform destaggering of point clouds during the copy + add a viz-reliable file + wrap all classes in ouster_ros
    • Update changelog and version
    • Reformat changelog
  • SW-5345: merge-ouster-srvs into ouster-msgs (#176)

    • Merge ouster-srvs into ouster-msgs package + Update dockerfile + Other fixes and code improvements
    • Update launch file name within the dockerfile
    • Update CHANGELOG.txt
    • Update ouster_ros package version to highlight the breadking change due obseleting ouster_srvs
    • Use angle brackets for external headers
    • Remove unused library include
    • Remove unused launch params in sensor_mtp.launch
    • Fix the table of contents
  • SW-5167: follow ups from SW-5167-fix-black-columns-when-recording-under-ros-foxy (#163)

    * Initialize point_cloud_frame with an empty string + and expose point_cloud_frame through launch xml files + Remove unused/duplicate param definitions + Update descriptions

    • Correct the name of the node to be activated for merged node
  • ROS compatibility mode dual returns fix (#156)

    • Separately initialize vector elements
    • Update changelog and package version
    • Properly check for the write_text_to_file success
  • ROS2 compatibility mode (#146)

    • Factoring out Imu and Lidar packets handling

    * Added os_driver which combines os_sensor and os_cloud + Added required launch files + Better abstraction of classes + Simplified threading logic + Added thread safe implemention of ring buffer (not hooked yet)

    • Move down pragma once in the handlers
    • Adding unit tests for the ThreadSafeRingBuffer
    • Add one more case to the unit test of ThreadSafeRingBuffer
    • Quick hook up of the ThreadSafeRingBuffer for os_sensor and os_driver
    • Add an option to select the point_cloud frame
    • Keep transforms in Lidar Frame by default with option to switch
    • Formatting os_sensor and os_driver
    • Provide support for parsing the community driver params file with approprite launch file
    • Factor out tf transforms broadcast
    • Formatting imu and lidar packet handlers
    • Fix build issue
    • Incorporate LaserScan message composition
    • Refactor a bit and add the ability to process and publish point clouds and laser scans
    • Restor os_cloud_node ability to process point clouds
    • Parse proc_mask and hook to launch files and config
    • Add support for the selecting IMU + create topics/subs when their respective flags enabled
    • Reduce sync operations + restore sensor reset/reactivation
    • Add the ability to override current qos settings
    • Add minor note
    • More detailed explanation about the IMG node
    • Rename the file os_sensor_cloud_image_params to os_sensor_cloud_image_params.yaml and update corresponding launch files
    • Expose use_system_default_qos parameter to xml launch file and use proper defaults

File truncated at 100 lines see the full file

Launch files

  • launch/record.launch.xml
      • ouster_ns [default: ouster]
      • sensor_hostname
      • udp_dest [default: ]
      • lidar_port [default: 0]
      • imu_port [default: 0]
      • udp_profile_lidar [default: ]
      • lidar_mode [default: ]
      • timestamp_mode [default: ]
      • ptp_utc_tai_offset [default: -37.0]
      • metadata [default: ]
      • bag_file [default: ]
      • viz [default: true]
      • rviz_config [default: $(find-pkg-share ouster_ros)/config/viz-reliable.rviz]
      • sensor_frame [default: os_sensor]
      • lidar_frame [default: os_lidar]
      • imu_frame [default: os_imu]
      • point_cloud_frame [default: ]
      • use_system_default_qos [default: true]
      • proc_mask [default: IMG|PCL|IMU|SCAN]
      • scan_ring [default: 0]
  • launch/replay.launch.xml
      • ouster_ns [default: ouster]
      • timestamp_mode [default: ]
      • ptp_utc_tai_offset [default: -37.0]
      • metadata [default: ]
      • bag_file
      • viz [default: true]
      • rviz_config [default: $(find-pkg-share ouster_ros)/config/viz-reliable.rviz]
      • sensor_frame [default: os_sensor]
      • lidar_frame [default: os_lidar]
      • imu_frame [default: os_imu]
      • point_cloud_frame [default: ]
      • use_system_default_qos [default: true]
      • proc_mask [default: IMG|PCL|IMU|SCAN]
      • scan_ring [default: 0]
  • launch/rviz.launch.xml
      • ouster_ns [default: ouster]
      • rviz_config [default: $(find-pkg-share ouster_ros)/config/viz.rviz]
  • launch/sensor.independent.launch.xml
      • ouster_ns [default: ouster]
      • sensor_hostname
      • udp_dest [default: ]
      • lidar_port [default: 0]
      • imu_port [default: 0]
      • udp_profile_lidar [default: ]
      • lidar_mode [default: ]
      • timestamp_mode [default: ]
      • ptp_utc_tai_offset [default: -37.0]
      • metadata [default: ]
      • viz [default: true]
      • rviz_config [default: $(find-pkg-share ouster_ros)/config/viz.rviz]
      • sensor_frame [default: os_sensor]
      • lidar_frame [default: os_lidar]
      • imu_frame [default: os_imu]
      • point_cloud_frame [default: ]
      • use_system_default_qos [default: false]
      • proc_mask [default: IMG|PCL|IMU|SCAN]
      • scan_ring [default: 0]
  • launch/sensor.launch.xml
      • ouster_ns [default: ouster]
      • sensor_hostname
      • udp_dest [default: ]
      • lidar_port [default: 0]
      • imu_port [default: 0]
      • udp_profile_lidar [default: ]
      • lidar_mode [default: ]
      • timestamp_mode [default: ]
      • ptp_utc_tai_offset [default: -37.0]
      • metadata [default: ]
      • viz [default: true]
      • rviz_config [default: $(find-pkg-share ouster_ros)/config/viz.rviz]
      • sensor_frame [default: os_sensor]
      • lidar_frame [default: os_lidar]
      • imu_frame [default: os_imu]
      • point_cloud_frame [default: ]
      • use_system_default_qos [default: false]
      • proc_mask [default: IMG|PCL|IMU|SCAN]
      • scan_ring [default: 0]
  • launch/sensor_mtp.launch.xml
      • ouster_ns [default: ouster]
      • sensor_hostname
      • udp_dest
      • mtp_dest [default: ]
      • mtp_main [default: false]
      • lidar_port [default: 0]
      • imu_port [default: 0]
      • udp_profile_lidar [default: ]
      • lidar_mode [default: ]
      • timestamp_mode [default: ]
      • ptp_utc_tai_offset [default: -37.0]
      • metadata [default: ]
      • viz [default: true]
      • rviz_config [default: $(find-pkg-share ouster_ros)/config/viz.rviz]
      • sensor_frame [default: os_sensor]
      • lidar_frame [default: os_lidar]
      • imu_frame [default: os_imu]
      • point_cloud_frame [default: ]
      • use_system_default_qos [default: false]
      • proc_mask [default: IMG|PCL|IMU|SCAN]
      • scan_ring [default: 0]

Messages

No message files found.

Services

No service files found

Plugins

No plugins found.

Recent questions tagged ouster_ros at Robotics Stack Exchange

Package symbol

ouster_ros package from ouster-ros repo

ouster_ros ouster_sensor_msgs

ROS Distro
rolling

Package Summary

Tags No category tags.
Version 0.11.1
License BSD
Build type AMENT_CMAKE
Use RECOMMENDED

Repository Summary

Description Official ROS drivers for Ouster sensors (OS0, OS1, OS2, OSDome)
Checkout URI https://github.com/ouster-lidar/ouster-ros.git
VCS Type git
VCS Version rolling-devel
Last Updated 2023-11-01
Dev Status DEVELOPED
Released RELEASED
Tags point-cloud ros lidar pcl pointcloud ros2 ros-melodic ouster ros-noetic ros2-foxy ros-drivers ros2-rolling ros2-humble ros2-iron ros2-jazzy
Contributing Help Wanted (-)
Good First Issues (-)
Pull Requests to Review (-)

Package Description

Ouster ROS2 driver

Additional Links

No additional links.

Maintainers

  • Ussama Naal
  • ouster developers

Authors

No additional authors.
README
No README found. See repository README.
CHANGELOG

Changelog for package ouster_ros

0.11.1 (2023-11-01)

  • breaking: rename ouster_msgs to ouster_sensor_msgs
  • shutdown the driver when unable to connect to the sensor on startup

0.10.4 (2023-08-31)

  • breaking: publish PCL point clouds destaggered.
  • introduced a new launch file parameter ptp_utc_tai_offset which represent offset in seconds to be applied to all ROS messages the driver generates when TIME_FROM_PTP_1588 timestamp mode is used.
  • fix: destagger columns timestamp when generating destaggered point clouds.
  • Use the local copy of the LICENSE file during install
  • Contributors: Ussama Naal

0.10.3 (2023-08-15)

  • Add per package LICENSE file
  • manifest symbolic links as files
  • Contributors: Ussama Naal

0.10.2 (2023-08-15)

  • SW-5396: publish point cloud in destaggered form (#182)

    • Quick implementtion of cloud destaggering
    • Perform destaggering of point clouds during the copy + add a viz-reliable file + wrap all classes in ouster_ros
    • Update changelog and version
    • Reformat changelog
  • SW-5345: merge-ouster-srvs into ouster-msgs (#176)

    • Merge ouster-srvs into ouster-msgs package + Update dockerfile + Other fixes and code improvements
    • Update launch file name within the dockerfile
    • Update CHANGELOG.txt
    • Update ouster_ros package version to highlight the breadking change due obseleting ouster_srvs
    • Use angle brackets for external headers
    • Remove unused library include
    • Remove unused launch params in sensor_mtp.launch
    • Fix the table of contents
  • SW-5167: follow ups from SW-5167-fix-black-columns-when-recording-under-ros-foxy (#163)

    * Initialize point_cloud_frame with an empty string + and expose point_cloud_frame through launch xml files + Remove unused/duplicate param definitions + Update descriptions

    • Correct the name of the node to be activated for merged node
  • ROS compatibility mode dual returns fix (#156)

    • Separately initialize vector elements
    • Update changelog and package version
    • Properly check for the write_text_to_file success
  • ROS2 compatibility mode (#146)

    • Factoring out Imu and Lidar packets handling

    * Added os_driver which combines os_sensor and os_cloud + Added required launch files + Better abstraction of classes + Simplified threading logic + Added thread safe implemention of ring buffer (not hooked yet)

    • Move down pragma once in the handlers
    • Adding unit tests for the ThreadSafeRingBuffer
    • Add one more case to the unit test of ThreadSafeRingBuffer
    • Quick hook up of the ThreadSafeRingBuffer for os_sensor and os_driver
    • Add an option to select the point_cloud frame
    • Keep transforms in Lidar Frame by default with option to switch
    • Formatting os_sensor and os_driver
    • Provide support for parsing the community driver params file with approprite launch file
    • Factor out tf transforms broadcast
    • Formatting imu and lidar packet handlers
    • Fix build issue
    • Incorporate LaserScan message composition
    • Refactor a bit and add the ability to process and publish point clouds and laser scans
    • Restor os_cloud_node ability to process point clouds
    • Parse proc_mask and hook to launch files and config
    • Add support for the selecting IMU + create topics/subs when their respective flags enabled
    • Reduce sync operations + restore sensor reset/reactivation
    • Add the ability to override current qos settings
    • Add minor note
    • More detailed explanation about the IMG node
    • Rename the file os_sensor_cloud_image_params to os_sensor_cloud_image_params.yaml and update corresponding launch files
    • Expose use_system_default_qos parameter to xml launch file and use proper defaults

File truncated at 100 lines see the full file

Launch files

  • launch/record.launch.xml
      • ouster_ns [default: ouster]
      • sensor_hostname
      • udp_dest [default: ]
      • lidar_port [default: 0]
      • imu_port [default: 0]
      • udp_profile_lidar [default: ]
      • lidar_mode [default: ]
      • timestamp_mode [default: ]
      • ptp_utc_tai_offset [default: -37.0]
      • metadata [default: ]
      • bag_file [default: ]
      • viz [default: true]
      • rviz_config [default: $(find-pkg-share ouster_ros)/config/viz-reliable.rviz]
      • sensor_frame [default: os_sensor]
      • lidar_frame [default: os_lidar]
      • imu_frame [default: os_imu]
      • point_cloud_frame [default: ]
      • use_system_default_qos [default: true]
      • proc_mask [default: IMG|PCL|IMU|SCAN]
      • scan_ring [default: 0]
  • launch/replay.launch.xml
      • ouster_ns [default: ouster]
      • timestamp_mode [default: ]
      • ptp_utc_tai_offset [default: -37.0]
      • metadata [default: ]
      • bag_file
      • viz [default: true]
      • rviz_config [default: $(find-pkg-share ouster_ros)/config/viz-reliable.rviz]
      • sensor_frame [default: os_sensor]
      • lidar_frame [default: os_lidar]
      • imu_frame [default: os_imu]
      • point_cloud_frame [default: ]
      • use_system_default_qos [default: true]
      • proc_mask [default: IMG|PCL|IMU|SCAN]
      • scan_ring [default: 0]
  • launch/rviz.launch.xml
      • ouster_ns [default: ouster]
      • rviz_config [default: $(find-pkg-share ouster_ros)/config/viz.rviz]
  • launch/sensor.independent.launch.xml
      • ouster_ns [default: ouster]
      • sensor_hostname
      • udp_dest [default: ]
      • lidar_port [default: 0]
      • imu_port [default: 0]
      • udp_profile_lidar [default: ]
      • lidar_mode [default: ]
      • timestamp_mode [default: ]
      • ptp_utc_tai_offset [default: -37.0]
      • metadata [default: ]
      • viz [default: true]
      • rviz_config [default: $(find-pkg-share ouster_ros)/config/viz.rviz]
      • sensor_frame [default: os_sensor]
      • lidar_frame [default: os_lidar]
      • imu_frame [default: os_imu]
      • point_cloud_frame [default: ]
      • use_system_default_qos [default: false]
      • proc_mask [default: IMG|PCL|IMU|SCAN]
      • scan_ring [default: 0]
  • launch/sensor.launch.xml
      • ouster_ns [default: ouster]
      • sensor_hostname
      • udp_dest [default: ]
      • lidar_port [default: 0]
      • imu_port [default: 0]
      • udp_profile_lidar [default: ]
      • lidar_mode [default: ]
      • timestamp_mode [default: ]
      • ptp_utc_tai_offset [default: -37.0]
      • metadata [default: ]
      • viz [default: true]
      • rviz_config [default: $(find-pkg-share ouster_ros)/config/viz.rviz]
      • sensor_frame [default: os_sensor]
      • lidar_frame [default: os_lidar]
      • imu_frame [default: os_imu]
      • point_cloud_frame [default: ]
      • use_system_default_qos [default: false]
      • proc_mask [default: IMG|PCL|IMU|SCAN]
      • scan_ring [default: 0]
  • launch/sensor_mtp.launch.xml
      • ouster_ns [default: ouster]
      • sensor_hostname
      • udp_dest
      • mtp_dest [default: ]
      • mtp_main [default: false]
      • lidar_port [default: 0]
      • imu_port [default: 0]
      • udp_profile_lidar [default: ]
      • lidar_mode [default: ]
      • timestamp_mode [default: ]
      • ptp_utc_tai_offset [default: -37.0]
      • metadata [default: ]
      • viz [default: true]
      • rviz_config [default: $(find-pkg-share ouster_ros)/config/viz.rviz]
      • sensor_frame [default: os_sensor]
      • lidar_frame [default: os_lidar]
      • imu_frame [default: os_imu]
      • point_cloud_frame [default: ]
      • use_system_default_qos [default: false]
      • proc_mask [default: IMG|PCL|IMU|SCAN]
      • scan_ring [default: 0]

Messages

No message files found.

Services

No service files found

Plugins

No plugins found.

Recent questions tagged ouster_ros at Robotics Stack Exchange

No version for distro github showing humble. Known supported distros are highlighted in the buttons above.
Package symbol

ouster_ros package from ouster-ros repo

ouster_ros ouster_sensor_msgs

ROS Distro
humble

Package Summary

Tags No category tags.
Version 0.13.14
License BSD
Build type AMENT_CMAKE
Use RECOMMENDED

Repository Summary

Description Official ROS drivers for Ouster sensors (OS0, OS1, OS2, OSDome)
Checkout URI https://github.com/ouster-lidar/ouster-ros.git
VCS Type git
VCS Version humble-devel
Last Updated 2025-09-23
Dev Status DEVELOPED
Released RELEASED
Tags point-cloud ros lidar pcl pointcloud ros2 ros-melodic ouster ros-noetic ros2-foxy ros-drivers ros2-rolling ros2-humble ros2-iron ros2-jazzy
Contributing Help Wanted (-)
Good First Issues (-)
Pull Requests to Review (-)

Package Description

Ouster ROS2 driver

Additional Links

No additional links.

Maintainers

  • ouster developers

Authors

No additional authors.
README
No README found. See repository README.
CHANGELOG

Changelog for package ouster_ros

0.13.14 (2025-09-22)

  • Add ouster-sdk directly

  • Drop whole archive linkage (#489)

  • fix-rolling build (#483)

  • Correct pointcloud.is_dense flag (#473)

  • Port the pointcloud mask feature to ROS2 (#462)

    • Port the pointcloud mask feature to ROS2
    • Base Image fixed
    • Update README and exclude iron from the build
  • [ROS2] Expose the vertical beam reduction param (#444)

    • Expose the vertical beam reduction value + rename arg + Better handling of deprecated topic names
  • ROS-317: Fix simulation in replay mode (#440)

    • Use node clock to properly populate the timestamp in replay modes
    • Update changelog and package number
  • Implement a padding-free version of pcl::PointXYZI (#439)

  • Add a new storage param to record.launch.xml (#437)

    • Add storage param to record
  • [ros2] Fix install directories (#433)

    • Cmakelists: Fix install directories
    • Bump package.xml patch version

    * Update changelog ---------Co-authored-by: Michael Wiznitzer <<mwiznitzer@neyarobotics.com>>

  • Port the changes to ROS2 (#430)

    • Port the changes to ROS2
    • Update sensor.*.launch
  • SW-6906: publish sensor telemetry in ouster ros (#422)

    • Port changes from ROS1 to ROS2
    • Mention TLM as an option in yaml configs
  • Enable auto start on replay node (#421)

  • ROS-389 [rolling/humble/iron/jazzy]: replay-improvments-and-fixes (#393) Remap metadata topic + Support loop capability in pcap replay + Add play_delay & play_rate for replay Added a launch file parameter pub_static_tf to disable sensor transforms broadcast ---------Co-authored-by: Guillaume Doisy <<guillaume@dexory.com>>

  • ROS-350[HUMBLE/IRON/JAZZY]: 't' timestamp field content is not plausible (#387) Align timestamps based on staggered/destaggered option

  • HOTFIX/ROS-382: os_driver fails when raw option is enabled (#384)

    • Fix os_driver fails when RAW option is enabled
    • Replace lifecycle_publisher with regular publisher for the os_pcap
  • HOTFIX/ROS-376-initialize-the-sensor-with-launch-config-params (#380)

    • Invoke parse_config_from_ros_parameters on node init
    • Fix a typo + Add a note regarding the recommendation
  • [HUMBLEJAZZY] Port ROS-363 to ROS2 (#369)

    • Port ROS-363 to ROS2
    • Turn off OSF
    • Update package version and CHANGELOG.rst + up the default max range to 10000.0 meters
  • ROS-368[HUMBLEJAZZY]: Unable to use the replay mode due to unknown substitution arg (#370)

    • Fix replay unknown substitution arg
    • Fix the definition of _loop variable
    • Move remap verb to the node
  • ROS-119: ouster-ros driver automatic reconnection [HUMBLE/IRON/JAZZY] (#362)

    • Port sensor reconnection logic to ROS 2
    • Add Jazzy to the build!
    • Update README and checkout
    • Add a note about not being able to properly handle invalid configuration

File truncated at 100 lines see the full file

Launch files

  • launch/record.composite.launch.xml
      • storage [default: sqlite3]
      • ouster_ns [default: ouster]
      • sensor_hostname
      • udp_dest [default: ]
      • lidar_port [default: 0]
      • imu_port [default: 0]
      • udp_profile_lidar [default: ]
      • lidar_mode [default: ]
      • timestamp_mode [default: ]
      • ptp_utc_tai_offset [default: -37.0]
      • metadata [default: ]
      • bag_file [default: ]
      • viz [default: true]
      • rviz_config [default: $(find-pkg-share ouster_ros)/config/viz-reliable.rviz]
      • sensor_frame [default: os_sensor]
      • lidar_frame [default: os_lidar]
      • imu_frame [default: os_imu]
      • point_cloud_frame [default: ]
      • pub_static_tf [default: true]
      • use_system_default_qos [default: true]
      • proc_mask [default: IMG|PCL|IMU|SCAN|TLM]
      • scan_ring [default: 0]
      • point_type [default: original]
      • organized [default: true]
      • destagger [default: true]
      • min_range [default: 0.0]
      • max_range [default: 100000.0]
      • azimuth_window_start [default: 0]
      • azimuth_window_end [default: 360000]
      • persist_config [default: false]
      • attempt_reconnect [default: false]
      • dormant_period_between_reconnects [default: 1.0]
      • max_failed_reconnect_attempts [default: 2147483647]
      • auto_start [default: true]
      • min_scan_valid_columns_ratio [default: 0.0]
      • v_reduction [default: 1]
      • mask_path [default: ]
  • launch/record.launch.xml
      • storage [default: sqlite3]
      • ouster_ns [default: ouster]
      • sensor_hostname
      • udp_dest [default: ]
      • lidar_port [default: 0]
      • imu_port [default: 0]
      • udp_profile_lidar [default: ]
      • lidar_mode [default: ]
      • timestamp_mode [default: ]
      • ptp_utc_tai_offset [default: -37.0]
      • metadata [default: ]
      • bag_file [default: ]
      • viz [default: true]
      • rviz_config [default: $(find-pkg-share ouster_ros)/config/viz-reliable.rviz]
      • sensor_frame [default: os_sensor]
      • lidar_frame [default: os_lidar]
      • imu_frame [default: os_imu]
      • point_cloud_frame [default: ]
      • pub_static_tf [default: true]
      • use_system_default_qos [default: true]
      • proc_mask [default: IMG|PCL|IMU|SCAN|TLM]
      • scan_ring [default: 0]
      • point_type [default: original]
      • organized [default: true]
      • destagger [default: true]
      • min_range [default: 0.0]
      • max_range [default: 100000.0]
      • azimuth_window_start [default: 0]
      • azimuth_window_end [default: 360000]
      • persist_config [default: false]
      • attempt_reconnect [default: false]
      • dormant_period_between_reconnects [default: 1.0]
      • max_failed_reconnect_attempts [default: 2147483647]
      • auto_start [default: true]
      • min_scan_valid_columns_ratio [default: 0.0]
      • v_reduction [default: 1]
      • mask_path [default: ]
  • launch/replay.composite.launch.xml
      • loop [default: false]
      • play_delay [default: 0]
      • play_rate [default: 1.0]
      • ouster_ns [default: ouster]
      • timestamp_mode [default: ]
      • ptp_utc_tai_offset [default: -37.0]
      • metadata [default: ]
      • bag_file
      • viz [default: true]
      • rviz_config [default: $(find-pkg-share ouster_ros)/config/viz-reliable.rviz]
      • sensor_frame [default: os_sensor]
      • lidar_frame [default: os_lidar]
      • imu_frame [default: os_imu]
      • point_cloud_frame [default: ]
      • pub_static_tf [default: true]
      • use_system_default_qos [default: true]
      • proc_mask [default: IMG|PCL|IMU|SCAN]
      • scan_ring [default: 0]
      • point_type [default: original]
      • organized [default: true]
      • destagger [default: true]
      • min_range [default: 0.0]
      • max_range [default: 100000.0]
      • min_scan_valid_columns_ratio [default: 0.0]
      • v_reduction [default: 1]
      • mask_path [default: ]
  • launch/replay.launch.xml
      • loop [default: false]
      • play_delay [default: 0]
      • play_rate [default: 1.0]
      • ouster_ns [default: ouster]
      • timestamp_mode [default: ]
      • ptp_utc_tai_offset [default: -37.0]
      • metadata [default: ]
      • bag_file
      • viz [default: true]
      • rviz_config [default: $(find-pkg-share ouster_ros)/config/viz-reliable.rviz]
      • sensor_frame [default: os_sensor]
      • lidar_frame [default: os_lidar]
      • imu_frame [default: os_imu]
      • point_cloud_frame [default: ]
      • pub_static_tf [default: true]
      • use_system_default_qos [default: true]
      • proc_mask [default: IMG|PCL|IMU|SCAN]
      • scan_ring [default: 0]
      • point_type [default: original]
      • organized [default: true]
      • destagger [default: true]
      • min_range [default: 0.0]
      • max_range [default: 100000.0]
      • min_scan_valid_columns_ratio [default: 0.0]
      • v_reduction [default: 1]
      • mask_path [default: ]
  • launch/replay_pcap.launch.xml
      • loop [default: false]
      • play_delay [default: 0]
      • progress_update_freq [default: 1.0]
      • ouster_ns [default: ouster]
      • timestamp_mode [default: TIME_FROM_INTERNAL_OSC]
      • ptp_utc_tai_offset [default: -37.0]
      • metadata
      • pcap_file
      • viz [default: true]
      • rviz_config [default: $(find-pkg-share ouster_ros)/config/viz-reliable.rviz]
      • sensor_frame [default: os_sensor]
      • lidar_frame [default: os_lidar]
      • imu_frame [default: os_imu]
      • point_cloud_frame [default: ]
      • pub_static_tf [default: true]
      • use_system_default_qos [default: true]
      • proc_mask [default: IMG|PCL|IMU|SCAN]
      • scan_ring [default: 0]
      • point_type [default: original]
      • organized [default: true]
      • destagger [default: true]
      • min_range [default: 0.0]
      • max_range [default: 10000.0]
      • min_scan_valid_columns_ratio [default: 0.0]
      • v_reduction [default: 1]
      • mask_path [default: ]
  • launch/rviz.launch.xml
      • ouster_ns [default: ouster]
      • rviz_config [default: $(find-pkg-share ouster_ros)/config/viz.rviz]
  • launch/sensor.composite.launch.xml
      • ouster_ns [default: ouster]
      • sensor_hostname
      • udp_dest [default: ]
      • lidar_port [default: 0]
      • imu_port [default: 0]
      • udp_profile_lidar [default: ]
      • lidar_mode [default: ]
      • timestamp_mode [default: ]
      • ptp_utc_tai_offset [default: -37.0]
      • metadata [default: ]
      • viz [default: true]
      • rviz_config [default: $(find-pkg-share ouster_ros)/config/viz.rviz]
      • sensor_frame [default: os_sensor]
      • lidar_frame [default: os_lidar]
      • imu_frame [default: os_imu]
      • point_cloud_frame [default: ]
      • pub_static_tf [default: true]
      • use_system_default_qos [default: false]
      • proc_mask [default: IMG|PCL|IMU|SCAN|TLM]
      • scan_ring [default: 0]
      • point_type [default: original]
      • azimuth_window_start [default: 0]
      • azimuth_window_end [default: 360000]
      • persist_config [default: false]
      • attempt_reconnect [default: false]
      • dormant_period_between_reconnects [default: 1.0]
      • max_failed_reconnect_attempts [default: 2147483647]
      • auto_start [default: true]
      • organized [default: true]
      • destagger [default: true]
      • min_range [default: 0.0]
      • max_range [default: 10000.0]
      • min_scan_valid_columns_ratio [default: 0.0]
      • v_reduction [default: 1]
      • mask_path [default: ]
  • launch/sensor.independent.launch.xml
      • ouster_ns [default: ouster]
      • sensor_hostname
      • udp_dest [default: ]
      • lidar_port [default: 0]
      • imu_port [default: 0]
      • udp_profile_lidar [default: ]
      • lidar_mode [default: ]
      • timestamp_mode [default: ]
      • ptp_utc_tai_offset [default: -37.0]
      • metadata [default: ]
      • viz [default: true]
      • rviz_config [default: $(find-pkg-share ouster_ros)/config/viz.rviz]
      • sensor_frame [default: os_sensor]
      • lidar_frame [default: os_lidar]
      • imu_frame [default: os_imu]
      • point_cloud_frame [default: ]
      • pub_static_tf [default: true]
      • use_system_default_qos [default: false]
      • proc_mask [default: IMG|PCL|IMU|SCAN]
      • scan_ring [default: 0]
      • point_type [default: original]
      • azimuth_window_start [default: 0]
      • azimuth_window_end [default: 360000]
      • persist_config [default: false]
      • attempt_reconnect [default: false]
      • dormant_period_between_reconnects [default: 1.0]
      • max_failed_reconnect_attempts [default: 2147483647]
      • auto_start [default: true]
      • min_scan_valid_columns_ratio [default: 0.0]
  • launch/sensor.launch.xml
      • ouster_ns [default: ouster]
      • sensor_hostname
      • udp_dest [default: ]
      • lidar_port [default: 0]
      • imu_port [default: 0]
      • udp_profile_lidar [default: ]
      • lidar_mode [default: ]
      • timestamp_mode [default: ]
      • ptp_utc_tai_offset [default: -37.0]
      • metadata [default: ]
      • viz [default: true]
      • rviz_config [default: $(find-pkg-share ouster_ros)/config/viz.rviz]
      • sensor_frame [default: os_sensor]
      • lidar_frame [default: os_lidar]
      • imu_frame [default: os_imu]
      • point_cloud_frame [default: ]
      • pub_static_tf [default: true]
      • use_system_default_qos [default: false]
      • proc_mask [default: IMG|PCL|IMU|SCAN|TLM]
      • scan_ring [default: 0]
      • point_type [default: original]
      • azimuth_window_start [default: 0]
      • azimuth_window_end [default: 360000]
      • persist_config [default: false]
      • attempt_reconnect [default: false]
      • dormant_period_between_reconnects [default: 1.0]
      • max_failed_reconnect_attempts [default: 2147483647]
      • auto_start [default: true]
      • organized [default: true]
      • destagger [default: true]
      • min_range [default: 0.0]
      • max_range [default: 10000.0]
      • min_scan_valid_columns_ratio [default: 0.0]
      • v_reduction [default: 1]
      • mask_path [default: ]
  • launch/sensor_mtp.launch.xml
      • ouster_ns [default: ouster]
      • sensor_hostname
      • udp_dest
      • mtp_dest [default: ]
      • mtp_main [default: false]
      • lidar_port [default: 0]
      • imu_port [default: 0]
      • udp_profile_lidar [default: ]
      • lidar_mode [default: ]
      • timestamp_mode [default: ]
      • ptp_utc_tai_offset [default: -37.0]
      • metadata [default: ]
      • viz [default: true]
      • rviz_config [default: $(find-pkg-share ouster_ros)/config/viz.rviz]
      • sensor_frame [default: os_sensor]
      • lidar_frame [default: os_lidar]
      • imu_frame [default: os_imu]
      • point_cloud_frame [default: ]
      • pub_static_tf [default: true]
      • use_system_default_qos [default: false]
      • proc_mask [default: IMG|PCL|IMU|SCAN|TLM]
      • scan_ring [default: 0]
      • point_type [default: original]
      • azimuth_window_start [default: 0]
      • azimuth_window_end [default: 360000]
      • persist_config [default: false]
      • attempt_reconnect [default: false]
      • dormant_period_between_reconnects [default: 1.0]
      • max_failed_reconnect_attempts [default: 2147483647]
      • auto_start [default: true]

Messages

No message files found.

Services

No service files found

Plugins

No plugins found.

Recent questions tagged ouster_ros at Robotics Stack Exchange

No version for distro galactic showing humble. Known supported distros are highlighted in the buttons above.
Package symbol

ouster_ros package from ouster-ros repo

ouster_ros ouster_sensor_msgs

ROS Distro
humble

Package Summary

Tags No category tags.
Version 0.13.14
License BSD
Build type AMENT_CMAKE
Use RECOMMENDED

Repository Summary

Description Official ROS drivers for Ouster sensors (OS0, OS1, OS2, OSDome)
Checkout URI https://github.com/ouster-lidar/ouster-ros.git
VCS Type git
VCS Version humble-devel
Last Updated 2025-09-23
Dev Status DEVELOPED
Released RELEASED
Tags point-cloud ros lidar pcl pointcloud ros2 ros-melodic ouster ros-noetic ros2-foxy ros-drivers ros2-rolling ros2-humble ros2-iron ros2-jazzy
Contributing Help Wanted (-)
Good First Issues (-)
Pull Requests to Review (-)

Package Description

Ouster ROS2 driver

Additional Links

No additional links.

Maintainers

  • ouster developers

Authors

No additional authors.
README
No README found. See repository README.
CHANGELOG

Changelog for package ouster_ros

0.13.14 (2025-09-22)

  • Add ouster-sdk directly

  • Drop whole archive linkage (#489)

  • fix-rolling build (#483)

  • Correct pointcloud.is_dense flag (#473)

  • Port the pointcloud mask feature to ROS2 (#462)

    • Port the pointcloud mask feature to ROS2
    • Base Image fixed
    • Update README and exclude iron from the build
  • [ROS2] Expose the vertical beam reduction param (#444)

    • Expose the vertical beam reduction value + rename arg + Better handling of deprecated topic names
  • ROS-317: Fix simulation in replay mode (#440)

    • Use node clock to properly populate the timestamp in replay modes
    • Update changelog and package number
  • Implement a padding-free version of pcl::PointXYZI (#439)

  • Add a new storage param to record.launch.xml (#437)

    • Add storage param to record
  • [ros2] Fix install directories (#433)

    • Cmakelists: Fix install directories
    • Bump package.xml patch version

    * Update changelog ---------Co-authored-by: Michael Wiznitzer <<mwiznitzer@neyarobotics.com>>

  • Port the changes to ROS2 (#430)

    • Port the changes to ROS2
    • Update sensor.*.launch
  • SW-6906: publish sensor telemetry in ouster ros (#422)

    • Port changes from ROS1 to ROS2
    • Mention TLM as an option in yaml configs
  • Enable auto start on replay node (#421)

  • ROS-389 [rolling/humble/iron/jazzy]: replay-improvments-and-fixes (#393) Remap metadata topic + Support loop capability in pcap replay + Add play_delay & play_rate for replay Added a launch file parameter pub_static_tf to disable sensor transforms broadcast ---------Co-authored-by: Guillaume Doisy <<guillaume@dexory.com>>

  • ROS-350[HUMBLE/IRON/JAZZY]: 't' timestamp field content is not plausible (#387) Align timestamps based on staggered/destaggered option

  • HOTFIX/ROS-382: os_driver fails when raw option is enabled (#384)

    • Fix os_driver fails when RAW option is enabled
    • Replace lifecycle_publisher with regular publisher for the os_pcap
  • HOTFIX/ROS-376-initialize-the-sensor-with-launch-config-params (#380)

    • Invoke parse_config_from_ros_parameters on node init
    • Fix a typo + Add a note regarding the recommendation
  • [HUMBLEJAZZY] Port ROS-363 to ROS2 (#369)

    • Port ROS-363 to ROS2
    • Turn off OSF
    • Update package version and CHANGELOG.rst + up the default max range to 10000.0 meters
  • ROS-368[HUMBLEJAZZY]: Unable to use the replay mode due to unknown substitution arg (#370)

    • Fix replay unknown substitution arg
    • Fix the definition of _loop variable
    • Move remap verb to the node
  • ROS-119: ouster-ros driver automatic reconnection [HUMBLE/IRON/JAZZY] (#362)

    • Port sensor reconnection logic to ROS 2
    • Add Jazzy to the build!
    • Update README and checkout
    • Add a note about not being able to properly handle invalid configuration

File truncated at 100 lines see the full file

Launch files

  • launch/record.composite.launch.xml
      • storage [default: sqlite3]
      • ouster_ns [default: ouster]
      • sensor_hostname
      • udp_dest [default: ]
      • lidar_port [default: 0]
      • imu_port [default: 0]
      • udp_profile_lidar [default: ]
      • lidar_mode [default: ]
      • timestamp_mode [default: ]
      • ptp_utc_tai_offset [default: -37.0]
      • metadata [default: ]
      • bag_file [default: ]
      • viz [default: true]
      • rviz_config [default: $(find-pkg-share ouster_ros)/config/viz-reliable.rviz]
      • sensor_frame [default: os_sensor]
      • lidar_frame [default: os_lidar]
      • imu_frame [default: os_imu]
      • point_cloud_frame [default: ]
      • pub_static_tf [default: true]
      • use_system_default_qos [default: true]
      • proc_mask [default: IMG|PCL|IMU|SCAN|TLM]
      • scan_ring [default: 0]
      • point_type [default: original]
      • organized [default: true]
      • destagger [default: true]
      • min_range [default: 0.0]
      • max_range [default: 100000.0]
      • azimuth_window_start [default: 0]
      • azimuth_window_end [default: 360000]
      • persist_config [default: false]
      • attempt_reconnect [default: false]
      • dormant_period_between_reconnects [default: 1.0]
      • max_failed_reconnect_attempts [default: 2147483647]
      • auto_start [default: true]
      • min_scan_valid_columns_ratio [default: 0.0]
      • v_reduction [default: 1]
      • mask_path [default: ]
  • launch/record.launch.xml
      • storage [default: sqlite3]
      • ouster_ns [default: ouster]
      • sensor_hostname
      • udp_dest [default: ]
      • lidar_port [default: 0]
      • imu_port [default: 0]
      • udp_profile_lidar [default: ]
      • lidar_mode [default: ]
      • timestamp_mode [default: ]
      • ptp_utc_tai_offset [default: -37.0]
      • metadata [default: ]
      • bag_file [default: ]
      • viz [default: true]
      • rviz_config [default: $(find-pkg-share ouster_ros)/config/viz-reliable.rviz]
      • sensor_frame [default: os_sensor]
      • lidar_frame [default: os_lidar]
      • imu_frame [default: os_imu]
      • point_cloud_frame [default: ]
      • pub_static_tf [default: true]
      • use_system_default_qos [default: true]
      • proc_mask [default: IMG|PCL|IMU|SCAN|TLM]
      • scan_ring [default: 0]
      • point_type [default: original]
      • organized [default: true]
      • destagger [default: true]
      • min_range [default: 0.0]
      • max_range [default: 100000.0]
      • azimuth_window_start [default: 0]
      • azimuth_window_end [default: 360000]
      • persist_config [default: false]
      • attempt_reconnect [default: false]
      • dormant_period_between_reconnects [default: 1.0]
      • max_failed_reconnect_attempts [default: 2147483647]
      • auto_start [default: true]
      • min_scan_valid_columns_ratio [default: 0.0]
      • v_reduction [default: 1]
      • mask_path [default: ]
  • launch/replay.composite.launch.xml
      • loop [default: false]
      • play_delay [default: 0]
      • play_rate [default: 1.0]
      • ouster_ns [default: ouster]
      • timestamp_mode [default: ]
      • ptp_utc_tai_offset [default: -37.0]
      • metadata [default: ]
      • bag_file
      • viz [default: true]
      • rviz_config [default: $(find-pkg-share ouster_ros)/config/viz-reliable.rviz]
      • sensor_frame [default: os_sensor]
      • lidar_frame [default: os_lidar]
      • imu_frame [default: os_imu]
      • point_cloud_frame [default: ]
      • pub_static_tf [default: true]
      • use_system_default_qos [default: true]
      • proc_mask [default: IMG|PCL|IMU|SCAN]
      • scan_ring [default: 0]
      • point_type [default: original]
      • organized [default: true]
      • destagger [default: true]
      • min_range [default: 0.0]
      • max_range [default: 100000.0]
      • min_scan_valid_columns_ratio [default: 0.0]
      • v_reduction [default: 1]
      • mask_path [default: ]
  • launch/replay.launch.xml
      • loop [default: false]
      • play_delay [default: 0]
      • play_rate [default: 1.0]
      • ouster_ns [default: ouster]
      • timestamp_mode [default: ]
      • ptp_utc_tai_offset [default: -37.0]
      • metadata [default: ]
      • bag_file
      • viz [default: true]
      • rviz_config [default: $(find-pkg-share ouster_ros)/config/viz-reliable.rviz]
      • sensor_frame [default: os_sensor]
      • lidar_frame [default: os_lidar]
      • imu_frame [default: os_imu]
      • point_cloud_frame [default: ]
      • pub_static_tf [default: true]
      • use_system_default_qos [default: true]
      • proc_mask [default: IMG|PCL|IMU|SCAN]
      • scan_ring [default: 0]
      • point_type [default: original]
      • organized [default: true]
      • destagger [default: true]
      • min_range [default: 0.0]
      • max_range [default: 100000.0]
      • min_scan_valid_columns_ratio [default: 0.0]
      • v_reduction [default: 1]
      • mask_path [default: ]
  • launch/replay_pcap.launch.xml
      • loop [default: false]
      • play_delay [default: 0]
      • progress_update_freq [default: 1.0]
      • ouster_ns [default: ouster]
      • timestamp_mode [default: TIME_FROM_INTERNAL_OSC]
      • ptp_utc_tai_offset [default: -37.0]
      • metadata
      • pcap_file
      • viz [default: true]
      • rviz_config [default: $(find-pkg-share ouster_ros)/config/viz-reliable.rviz]
      • sensor_frame [default: os_sensor]
      • lidar_frame [default: os_lidar]
      • imu_frame [default: os_imu]
      • point_cloud_frame [default: ]
      • pub_static_tf [default: true]
      • use_system_default_qos [default: true]
      • proc_mask [default: IMG|PCL|IMU|SCAN]
      • scan_ring [default: 0]
      • point_type [default: original]
      • organized [default: true]
      • destagger [default: true]
      • min_range [default: 0.0]
      • max_range [default: 10000.0]
      • min_scan_valid_columns_ratio [default: 0.0]
      • v_reduction [default: 1]
      • mask_path [default: ]
  • launch/rviz.launch.xml
      • ouster_ns [default: ouster]
      • rviz_config [default: $(find-pkg-share ouster_ros)/config/viz.rviz]
  • launch/sensor.composite.launch.xml
      • ouster_ns [default: ouster]
      • sensor_hostname
      • udp_dest [default: ]
      • lidar_port [default: 0]
      • imu_port [default: 0]
      • udp_profile_lidar [default: ]
      • lidar_mode [default: ]
      • timestamp_mode [default: ]
      • ptp_utc_tai_offset [default: -37.0]
      • metadata [default: ]
      • viz [default: true]
      • rviz_config [default: $(find-pkg-share ouster_ros)/config/viz.rviz]
      • sensor_frame [default: os_sensor]
      • lidar_frame [default: os_lidar]
      • imu_frame [default: os_imu]
      • point_cloud_frame [default: ]
      • pub_static_tf [default: true]
      • use_system_default_qos [default: false]
      • proc_mask [default: IMG|PCL|IMU|SCAN|TLM]
      • scan_ring [default: 0]
      • point_type [default: original]
      • azimuth_window_start [default: 0]
      • azimuth_window_end [default: 360000]
      • persist_config [default: false]
      • attempt_reconnect [default: false]
      • dormant_period_between_reconnects [default: 1.0]
      • max_failed_reconnect_attempts [default: 2147483647]
      • auto_start [default: true]
      • organized [default: true]
      • destagger [default: true]
      • min_range [default: 0.0]
      • max_range [default: 10000.0]
      • min_scan_valid_columns_ratio [default: 0.0]
      • v_reduction [default: 1]
      • mask_path [default: ]
  • launch/sensor.independent.launch.xml
      • ouster_ns [default: ouster]
      • sensor_hostname
      • udp_dest [default: ]
      • lidar_port [default: 0]
      • imu_port [default: 0]
      • udp_profile_lidar [default: ]
      • lidar_mode [default: ]
      • timestamp_mode [default: ]
      • ptp_utc_tai_offset [default: -37.0]
      • metadata [default: ]
      • viz [default: true]
      • rviz_config [default: $(find-pkg-share ouster_ros)/config/viz.rviz]
      • sensor_frame [default: os_sensor]
      • lidar_frame [default: os_lidar]
      • imu_frame [default: os_imu]
      • point_cloud_frame [default: ]
      • pub_static_tf [default: true]
      • use_system_default_qos [default: false]
      • proc_mask [default: IMG|PCL|IMU|SCAN]
      • scan_ring [default: 0]
      • point_type [default: original]
      • azimuth_window_start [default: 0]
      • azimuth_window_end [default: 360000]
      • persist_config [default: false]
      • attempt_reconnect [default: false]
      • dormant_period_between_reconnects [default: 1.0]
      • max_failed_reconnect_attempts [default: 2147483647]
      • auto_start [default: true]
      • min_scan_valid_columns_ratio [default: 0.0]
  • launch/sensor.launch.xml
      • ouster_ns [default: ouster]
      • sensor_hostname
      • udp_dest [default: ]
      • lidar_port [default: 0]
      • imu_port [default: 0]
      • udp_profile_lidar [default: ]
      • lidar_mode [default: ]
      • timestamp_mode [default: ]
      • ptp_utc_tai_offset [default: -37.0]
      • metadata [default: ]
      • viz [default: true]
      • rviz_config [default: $(find-pkg-share ouster_ros)/config/viz.rviz]
      • sensor_frame [default: os_sensor]
      • lidar_frame [default: os_lidar]
      • imu_frame [default: os_imu]
      • point_cloud_frame [default: ]
      • pub_static_tf [default: true]
      • use_system_default_qos [default: false]
      • proc_mask [default: IMG|PCL|IMU|SCAN|TLM]
      • scan_ring [default: 0]
      • point_type [default: original]
      • azimuth_window_start [default: 0]
      • azimuth_window_end [default: 360000]
      • persist_config [default: false]
      • attempt_reconnect [default: false]
      • dormant_period_between_reconnects [default: 1.0]
      • max_failed_reconnect_attempts [default: 2147483647]
      • auto_start [default: true]
      • organized [default: true]
      • destagger [default: true]
      • min_range [default: 0.0]
      • max_range [default: 10000.0]
      • min_scan_valid_columns_ratio [default: 0.0]
      • v_reduction [default: 1]
      • mask_path [default: ]
  • launch/sensor_mtp.launch.xml
      • ouster_ns [default: ouster]
      • sensor_hostname
      • udp_dest
      • mtp_dest [default: ]
      • mtp_main [default: false]
      • lidar_port [default: 0]
      • imu_port [default: 0]
      • udp_profile_lidar [default: ]
      • lidar_mode [default: ]
      • timestamp_mode [default: ]
      • ptp_utc_tai_offset [default: -37.0]
      • metadata [default: ]
      • viz [default: true]
      • rviz_config [default: $(find-pkg-share ouster_ros)/config/viz.rviz]
      • sensor_frame [default: os_sensor]
      • lidar_frame [default: os_lidar]
      • imu_frame [default: os_imu]
      • point_cloud_frame [default: ]
      • pub_static_tf [default: true]
      • use_system_default_qos [default: false]
      • proc_mask [default: IMG|PCL|IMU|SCAN|TLM]
      • scan_ring [default: 0]
      • point_type [default: original]
      • azimuth_window_start [default: 0]
      • azimuth_window_end [default: 360000]
      • persist_config [default: false]
      • attempt_reconnect [default: false]
      • dormant_period_between_reconnects [default: 1.0]
      • max_failed_reconnect_attempts [default: 2147483647]
      • auto_start [default: true]

Messages

No message files found.

Services

No service files found

Plugins

No plugins found.

Recent questions tagged ouster_ros at Robotics Stack Exchange

Package symbol

ouster_ros package from ouster-ros repo

ouster_ros ouster_sensor_msgs

ROS Distro
iron

Package Summary

Tags No category tags.
Version 0.11.1
License BSD
Build type AMENT_CMAKE
Use RECOMMENDED

Repository Summary

Description Official ROS drivers for Ouster sensors (OS0, OS1, OS2, OSDome)
Checkout URI https://github.com/ouster-lidar/ouster-ros.git
VCS Type git
VCS Version iron-devel
Last Updated 2023-11-01
Dev Status DEVELOPED
Released RELEASED
Tags point-cloud ros lidar pcl pointcloud ros2 ros-melodic ouster ros-noetic ros2-foxy ros-drivers ros2-rolling ros2-humble ros2-iron ros2-jazzy
Contributing Help Wanted (-)
Good First Issues (-)
Pull Requests to Review (-)

Package Description

Ouster ROS2 driver

Additional Links

No additional links.

Maintainers

  • Ussama Naal
  • ouster developers

Authors

No additional authors.
README
No README found. See repository README.
CHANGELOG

Changelog for package ouster_ros

0.11.1 (2023-11-01)

  • breaking: rename ouster_msgs to ouster_sensor_msgs
  • shutdown the driver when unable to connect to the sensor on startup

0.10.4 (2023-08-31)

  • breaking: publish PCL point clouds destaggered.
  • introduced a new launch file parameter ptp_utc_tai_offset which represent offset in seconds to be applied to all ROS messages the driver generates when TIME_FROM_PTP_1588 timestamp mode is used.
  • fix: destagger columns timestamp when generating destaggered point clouds.
  • Use the local copy of the LICENSE file during install
  • Contributors: Ussama Naal

0.10.3 (2023-08-15)

  • Add per package LICENSE file
  • manifest symbolic links as files
  • Contributors: Ussama Naal

0.10.2 (2023-08-15)

  • SW-5396: publish point cloud in destaggered form (#182)

    • Quick implementtion of cloud destaggering
    • Perform destaggering of point clouds during the copy + add a viz-reliable file + wrap all classes in ouster_ros
    • Update changelog and version
    • Reformat changelog
  • SW-5345: merge-ouster-srvs into ouster-msgs (#176)

    • Merge ouster-srvs into ouster-msgs package + Update dockerfile + Other fixes and code improvements
    • Update launch file name within the dockerfile
    • Update CHANGELOG.txt
    • Update ouster_ros package version to highlight the breadking change due obseleting ouster_srvs
    • Use angle brackets for external headers
    • Remove unused library include
    • Remove unused launch params in sensor_mtp.launch
    • Fix the table of contents
  • SW-5167: follow ups from SW-5167-fix-black-columns-when-recording-under-ros-foxy (#163)

    * Initialize point_cloud_frame with an empty string + and expose point_cloud_frame through launch xml files + Remove unused/duplicate param definitions + Update descriptions

    • Correct the name of the node to be activated for merged node
  • ROS compatibility mode dual returns fix (#156)

    • Separately initialize vector elements
    • Update changelog and package version
    • Properly check for the write_text_to_file success
  • ROS2 compatibility mode (#146)

    • Factoring out Imu and Lidar packets handling

    * Added os_driver which combines os_sensor and os_cloud + Added required launch files + Better abstraction of classes + Simplified threading logic + Added thread safe implemention of ring buffer (not hooked yet)

    • Move down pragma once in the handlers
    • Adding unit tests for the ThreadSafeRingBuffer
    • Add one more case to the unit test of ThreadSafeRingBuffer
    • Quick hook up of the ThreadSafeRingBuffer for os_sensor and os_driver
    • Add an option to select the point_cloud frame
    • Keep transforms in Lidar Frame by default with option to switch
    • Formatting os_sensor and os_driver
    • Provide support for parsing the community driver params file with approprite launch file
    • Factor out tf transforms broadcast
    • Formatting imu and lidar packet handlers
    • Fix build issue
    • Incorporate LaserScan message composition
    • Refactor a bit and add the ability to process and publish point clouds and laser scans
    • Restor os_cloud_node ability to process point clouds
    • Parse proc_mask and hook to launch files and config
    • Add support for the selecting IMU + create topics/subs when their respective flags enabled
    • Reduce sync operations + restore sensor reset/reactivation
    • Add the ability to override current qos settings
    • Add minor note
    • More detailed explanation about the IMG node
    • Rename the file os_sensor_cloud_image_params to os_sensor_cloud_image_params.yaml and update corresponding launch files
    • Expose use_system_default_qos parameter to xml launch file and use proper defaults

File truncated at 100 lines see the full file

Launch files

  • launch/record.launch.xml
      • ouster_ns [default: ouster]
      • sensor_hostname
      • udp_dest [default: ]
      • lidar_port [default: 0]
      • imu_port [default: 0]
      • udp_profile_lidar [default: ]
      • lidar_mode [default: ]
      • timestamp_mode [default: ]
      • ptp_utc_tai_offset [default: -37.0]
      • metadata [default: ]
      • bag_file [default: ]
      • viz [default: true]
      • rviz_config [default: $(find-pkg-share ouster_ros)/config/viz-reliable.rviz]
      • sensor_frame [default: os_sensor]
      • lidar_frame [default: os_lidar]
      • imu_frame [default: os_imu]
      • point_cloud_frame [default: ]
      • use_system_default_qos [default: true]
      • proc_mask [default: IMG|PCL|IMU|SCAN]
      • scan_ring [default: 0]
  • launch/replay.launch.xml
      • ouster_ns [default: ouster]
      • timestamp_mode [default: ]
      • ptp_utc_tai_offset [default: -37.0]
      • metadata [default: ]
      • bag_file
      • viz [default: true]
      • rviz_config [default: $(find-pkg-share ouster_ros)/config/viz-reliable.rviz]
      • sensor_frame [default: os_sensor]
      • lidar_frame [default: os_lidar]
      • imu_frame [default: os_imu]
      • point_cloud_frame [default: ]
      • use_system_default_qos [default: true]
      • proc_mask [default: IMG|PCL|IMU|SCAN]
      • scan_ring [default: 0]
  • launch/rviz.launch.xml
      • ouster_ns [default: ouster]
      • rviz_config [default: $(find-pkg-share ouster_ros)/config/viz.rviz]
  • launch/sensor.independent.launch.xml
      • ouster_ns [default: ouster]
      • sensor_hostname
      • udp_dest [default: ]
      • lidar_port [default: 0]
      • imu_port [default: 0]
      • udp_profile_lidar [default: ]
      • lidar_mode [default: ]
      • timestamp_mode [default: ]
      • ptp_utc_tai_offset [default: -37.0]
      • metadata [default: ]
      • viz [default: true]
      • rviz_config [default: $(find-pkg-share ouster_ros)/config/viz.rviz]
      • sensor_frame [default: os_sensor]
      • lidar_frame [default: os_lidar]
      • imu_frame [default: os_imu]
      • point_cloud_frame [default: ]
      • use_system_default_qos [default: false]
      • proc_mask [default: IMG|PCL|IMU|SCAN]
      • scan_ring [default: 0]
  • launch/sensor.launch.xml
      • ouster_ns [default: ouster]
      • sensor_hostname
      • udp_dest [default: ]
      • lidar_port [default: 0]
      • imu_port [default: 0]
      • udp_profile_lidar [default: ]
      • lidar_mode [default: ]
      • timestamp_mode [default: ]
      • ptp_utc_tai_offset [default: -37.0]
      • metadata [default: ]
      • viz [default: true]
      • rviz_config [default: $(find-pkg-share ouster_ros)/config/viz.rviz]
      • sensor_frame [default: os_sensor]
      • lidar_frame [default: os_lidar]
      • imu_frame [default: os_imu]
      • point_cloud_frame [default: ]
      • use_system_default_qos [default: false]
      • proc_mask [default: IMG|PCL|IMU|SCAN]
      • scan_ring [default: 0]
  • launch/sensor_mtp.launch.xml
      • ouster_ns [default: ouster]
      • sensor_hostname
      • udp_dest
      • mtp_dest [default: ]
      • mtp_main [default: false]
      • lidar_port [default: 0]
      • imu_port [default: 0]
      • udp_profile_lidar [default: ]
      • lidar_mode [default: ]
      • timestamp_mode [default: ]
      • ptp_utc_tai_offset [default: -37.0]
      • metadata [default: ]
      • viz [default: true]
      • rviz_config [default: $(find-pkg-share ouster_ros)/config/viz.rviz]
      • sensor_frame [default: os_sensor]
      • lidar_frame [default: os_lidar]
      • imu_frame [default: os_imu]
      • point_cloud_frame [default: ]
      • use_system_default_qos [default: false]
      • proc_mask [default: IMG|PCL|IMU|SCAN]
      • scan_ring [default: 0]

Messages

No message files found.

Services

No service files found

Plugins

No plugins found.

Recent questions tagged ouster_ros at Robotics Stack Exchange

No version for distro melodic showing humble. Known supported distros are highlighted in the buttons above.
Package symbol

ouster_ros package from ouster-ros repo

ouster_ros ouster_sensor_msgs

ROS Distro
humble

Package Summary

Tags No category tags.
Version 0.13.14
License BSD
Build type AMENT_CMAKE
Use RECOMMENDED

Repository Summary

Description Official ROS drivers for Ouster sensors (OS0, OS1, OS2, OSDome)
Checkout URI https://github.com/ouster-lidar/ouster-ros.git
VCS Type git
VCS Version humble-devel
Last Updated 2025-09-23
Dev Status DEVELOPED
Released RELEASED
Tags point-cloud ros lidar pcl pointcloud ros2 ros-melodic ouster ros-noetic ros2-foxy ros-drivers ros2-rolling ros2-humble ros2-iron ros2-jazzy
Contributing Help Wanted (-)
Good First Issues (-)
Pull Requests to Review (-)

Package Description

Ouster ROS2 driver

Additional Links

No additional links.

Maintainers

  • ouster developers

Authors

No additional authors.
README
No README found. See repository README.
CHANGELOG

Changelog for package ouster_ros

0.13.14 (2025-09-22)

  • Add ouster-sdk directly

  • Drop whole archive linkage (#489)

  • fix-rolling build (#483)

  • Correct pointcloud.is_dense flag (#473)

  • Port the pointcloud mask feature to ROS2 (#462)

    • Port the pointcloud mask feature to ROS2
    • Base Image fixed
    • Update README and exclude iron from the build
  • [ROS2] Expose the vertical beam reduction param (#444)

    • Expose the vertical beam reduction value + rename arg + Better handling of deprecated topic names
  • ROS-317: Fix simulation in replay mode (#440)

    • Use node clock to properly populate the timestamp in replay modes
    • Update changelog and package number
  • Implement a padding-free version of pcl::PointXYZI (#439)

  • Add a new storage param to record.launch.xml (#437)

    • Add storage param to record
  • [ros2] Fix install directories (#433)

    • Cmakelists: Fix install directories
    • Bump package.xml patch version

    * Update changelog ---------Co-authored-by: Michael Wiznitzer <<mwiznitzer@neyarobotics.com>>

  • Port the changes to ROS2 (#430)

    • Port the changes to ROS2
    • Update sensor.*.launch
  • SW-6906: publish sensor telemetry in ouster ros (#422)

    • Port changes from ROS1 to ROS2
    • Mention TLM as an option in yaml configs
  • Enable auto start on replay node (#421)

  • ROS-389 [rolling/humble/iron/jazzy]: replay-improvments-and-fixes (#393) Remap metadata topic + Support loop capability in pcap replay + Add play_delay & play_rate for replay Added a launch file parameter pub_static_tf to disable sensor transforms broadcast ---------Co-authored-by: Guillaume Doisy <<guillaume@dexory.com>>

  • ROS-350[HUMBLE/IRON/JAZZY]: 't' timestamp field content is not plausible (#387) Align timestamps based on staggered/destaggered option

  • HOTFIX/ROS-382: os_driver fails when raw option is enabled (#384)

    • Fix os_driver fails when RAW option is enabled
    • Replace lifecycle_publisher with regular publisher for the os_pcap
  • HOTFIX/ROS-376-initialize-the-sensor-with-launch-config-params (#380)

    • Invoke parse_config_from_ros_parameters on node init
    • Fix a typo + Add a note regarding the recommendation
  • [HUMBLEJAZZY] Port ROS-363 to ROS2 (#369)

    • Port ROS-363 to ROS2
    • Turn off OSF
    • Update package version and CHANGELOG.rst + up the default max range to 10000.0 meters
  • ROS-368[HUMBLEJAZZY]: Unable to use the replay mode due to unknown substitution arg (#370)

    • Fix replay unknown substitution arg
    • Fix the definition of _loop variable
    • Move remap verb to the node
  • ROS-119: ouster-ros driver automatic reconnection [HUMBLE/IRON/JAZZY] (#362)

    • Port sensor reconnection logic to ROS 2
    • Add Jazzy to the build!
    • Update README and checkout
    • Add a note about not being able to properly handle invalid configuration

File truncated at 100 lines see the full file

Launch files

  • launch/record.composite.launch.xml
      • storage [default: sqlite3]
      • ouster_ns [default: ouster]
      • sensor_hostname
      • udp_dest [default: ]
      • lidar_port [default: 0]
      • imu_port [default: 0]
      • udp_profile_lidar [default: ]
      • lidar_mode [default: ]
      • timestamp_mode [default: ]
      • ptp_utc_tai_offset [default: -37.0]
      • metadata [default: ]
      • bag_file [default: ]
      • viz [default: true]
      • rviz_config [default: $(find-pkg-share ouster_ros)/config/viz-reliable.rviz]
      • sensor_frame [default: os_sensor]
      • lidar_frame [default: os_lidar]
      • imu_frame [default: os_imu]
      • point_cloud_frame [default: ]
      • pub_static_tf [default: true]
      • use_system_default_qos [default: true]
      • proc_mask [default: IMG|PCL|IMU|SCAN|TLM]
      • scan_ring [default: 0]
      • point_type [default: original]
      • organized [default: true]
      • destagger [default: true]
      • min_range [default: 0.0]
      • max_range [default: 100000.0]
      • azimuth_window_start [default: 0]
      • azimuth_window_end [default: 360000]
      • persist_config [default: false]
      • attempt_reconnect [default: false]
      • dormant_period_between_reconnects [default: 1.0]
      • max_failed_reconnect_attempts [default: 2147483647]
      • auto_start [default: true]
      • min_scan_valid_columns_ratio [default: 0.0]
      • v_reduction [default: 1]
      • mask_path [default: ]
  • launch/record.launch.xml
      • storage [default: sqlite3]
      • ouster_ns [default: ouster]
      • sensor_hostname
      • udp_dest [default: ]
      • lidar_port [default: 0]
      • imu_port [default: 0]
      • udp_profile_lidar [default: ]
      • lidar_mode [default: ]
      • timestamp_mode [default: ]
      • ptp_utc_tai_offset [default: -37.0]
      • metadata [default: ]
      • bag_file [default: ]
      • viz [default: true]
      • rviz_config [default: $(find-pkg-share ouster_ros)/config/viz-reliable.rviz]
      • sensor_frame [default: os_sensor]
      • lidar_frame [default: os_lidar]
      • imu_frame [default: os_imu]
      • point_cloud_frame [default: ]
      • pub_static_tf [default: true]
      • use_system_default_qos [default: true]
      • proc_mask [default: IMG|PCL|IMU|SCAN|TLM]
      • scan_ring [default: 0]
      • point_type [default: original]
      • organized [default: true]
      • destagger [default: true]
      • min_range [default: 0.0]
      • max_range [default: 100000.0]
      • azimuth_window_start [default: 0]
      • azimuth_window_end [default: 360000]
      • persist_config [default: false]
      • attempt_reconnect [default: false]
      • dormant_period_between_reconnects [default: 1.0]
      • max_failed_reconnect_attempts [default: 2147483647]
      • auto_start [default: true]
      • min_scan_valid_columns_ratio [default: 0.0]
      • v_reduction [default: 1]
      • mask_path [default: ]
  • launch/replay.composite.launch.xml
      • loop [default: false]
      • play_delay [default: 0]
      • play_rate [default: 1.0]
      • ouster_ns [default: ouster]
      • timestamp_mode [default: ]
      • ptp_utc_tai_offset [default: -37.0]
      • metadata [default: ]
      • bag_file
      • viz [default: true]
      • rviz_config [default: $(find-pkg-share ouster_ros)/config/viz-reliable.rviz]
      • sensor_frame [default: os_sensor]
      • lidar_frame [default: os_lidar]
      • imu_frame [default: os_imu]
      • point_cloud_frame [default: ]
      • pub_static_tf [default: true]
      • use_system_default_qos [default: true]
      • proc_mask [default: IMG|PCL|IMU|SCAN]
      • scan_ring [default: 0]
      • point_type [default: original]
      • organized [default: true]
      • destagger [default: true]
      • min_range [default: 0.0]
      • max_range [default: 100000.0]
      • min_scan_valid_columns_ratio [default: 0.0]
      • v_reduction [default: 1]
      • mask_path [default: ]
  • launch/replay.launch.xml
      • loop [default: false]
      • play_delay [default: 0]
      • play_rate [default: 1.0]
      • ouster_ns [default: ouster]
      • timestamp_mode [default: ]
      • ptp_utc_tai_offset [default: -37.0]
      • metadata [default: ]
      • bag_file
      • viz [default: true]
      • rviz_config [default: $(find-pkg-share ouster_ros)/config/viz-reliable.rviz]
      • sensor_frame [default: os_sensor]
      • lidar_frame [default: os_lidar]
      • imu_frame [default: os_imu]
      • point_cloud_frame [default: ]
      • pub_static_tf [default: true]
      • use_system_default_qos [default: true]
      • proc_mask [default: IMG|PCL|IMU|SCAN]
      • scan_ring [default: 0]
      • point_type [default: original]
      • organized [default: true]
      • destagger [default: true]
      • min_range [default: 0.0]
      • max_range [default: 100000.0]
      • min_scan_valid_columns_ratio [default: 0.0]
      • v_reduction [default: 1]
      • mask_path [default: ]
  • launch/replay_pcap.launch.xml
      • loop [default: false]
      • play_delay [default: 0]
      • progress_update_freq [default: 1.0]
      • ouster_ns [default: ouster]
      • timestamp_mode [default: TIME_FROM_INTERNAL_OSC]
      • ptp_utc_tai_offset [default: -37.0]
      • metadata
      • pcap_file
      • viz [default: true]
      • rviz_config [default: $(find-pkg-share ouster_ros)/config/viz-reliable.rviz]
      • sensor_frame [default: os_sensor]
      • lidar_frame [default: os_lidar]
      • imu_frame [default: os_imu]
      • point_cloud_frame [default: ]
      • pub_static_tf [default: true]
      • use_system_default_qos [default: true]
      • proc_mask [default: IMG|PCL|IMU|SCAN]
      • scan_ring [default: 0]
      • point_type [default: original]
      • organized [default: true]
      • destagger [default: true]
      • min_range [default: 0.0]
      • max_range [default: 10000.0]
      • min_scan_valid_columns_ratio [default: 0.0]
      • v_reduction [default: 1]
      • mask_path [default: ]
  • launch/rviz.launch.xml
      • ouster_ns [default: ouster]
      • rviz_config [default: $(find-pkg-share ouster_ros)/config/viz.rviz]
  • launch/sensor.composite.launch.xml
      • ouster_ns [default: ouster]
      • sensor_hostname
      • udp_dest [default: ]
      • lidar_port [default: 0]
      • imu_port [default: 0]
      • udp_profile_lidar [default: ]
      • lidar_mode [default: ]
      • timestamp_mode [default: ]
      • ptp_utc_tai_offset [default: -37.0]
      • metadata [default: ]
      • viz [default: true]
      • rviz_config [default: $(find-pkg-share ouster_ros)/config/viz.rviz]
      • sensor_frame [default: os_sensor]
      • lidar_frame [default: os_lidar]
      • imu_frame [default: os_imu]
      • point_cloud_frame [default: ]
      • pub_static_tf [default: true]
      • use_system_default_qos [default: false]
      • proc_mask [default: IMG|PCL|IMU|SCAN|TLM]
      • scan_ring [default: 0]
      • point_type [default: original]
      • azimuth_window_start [default: 0]
      • azimuth_window_end [default: 360000]
      • persist_config [default: false]
      • attempt_reconnect [default: false]
      • dormant_period_between_reconnects [default: 1.0]
      • max_failed_reconnect_attempts [default: 2147483647]
      • auto_start [default: true]
      • organized [default: true]
      • destagger [default: true]
      • min_range [default: 0.0]
      • max_range [default: 10000.0]
      • min_scan_valid_columns_ratio [default: 0.0]
      • v_reduction [default: 1]
      • mask_path [default: ]
  • launch/sensor.independent.launch.xml
      • ouster_ns [default: ouster]
      • sensor_hostname
      • udp_dest [default: ]
      • lidar_port [default: 0]
      • imu_port [default: 0]
      • udp_profile_lidar [default: ]
      • lidar_mode [default: ]
      • timestamp_mode [default: ]
      • ptp_utc_tai_offset [default: -37.0]
      • metadata [default: ]
      • viz [default: true]
      • rviz_config [default: $(find-pkg-share ouster_ros)/config/viz.rviz]
      • sensor_frame [default: os_sensor]
      • lidar_frame [default: os_lidar]
      • imu_frame [default: os_imu]
      • point_cloud_frame [default: ]
      • pub_static_tf [default: true]
      • use_system_default_qos [default: false]
      • proc_mask [default: IMG|PCL|IMU|SCAN]
      • scan_ring [default: 0]
      • point_type [default: original]
      • azimuth_window_start [default: 0]
      • azimuth_window_end [default: 360000]
      • persist_config [default: false]
      • attempt_reconnect [default: false]
      • dormant_period_between_reconnects [default: 1.0]
      • max_failed_reconnect_attempts [default: 2147483647]
      • auto_start [default: true]
      • min_scan_valid_columns_ratio [default: 0.0]
  • launch/sensor.launch.xml
      • ouster_ns [default: ouster]
      • sensor_hostname
      • udp_dest [default: ]
      • lidar_port [default: 0]
      • imu_port [default: 0]
      • udp_profile_lidar [default: ]
      • lidar_mode [default: ]
      • timestamp_mode [default: ]
      • ptp_utc_tai_offset [default: -37.0]
      • metadata [default: ]
      • viz [default: true]
      • rviz_config [default: $(find-pkg-share ouster_ros)/config/viz.rviz]
      • sensor_frame [default: os_sensor]
      • lidar_frame [default: os_lidar]
      • imu_frame [default: os_imu]
      • point_cloud_frame [default: ]
      • pub_static_tf [default: true]
      • use_system_default_qos [default: false]
      • proc_mask [default: IMG|PCL|IMU|SCAN|TLM]
      • scan_ring [default: 0]
      • point_type [default: original]
      • azimuth_window_start [default: 0]
      • azimuth_window_end [default: 360000]
      • persist_config [default: false]
      • attempt_reconnect [default: false]
      • dormant_period_between_reconnects [default: 1.0]
      • max_failed_reconnect_attempts [default: 2147483647]
      • auto_start [default: true]
      • organized [default: true]
      • destagger [default: true]
      • min_range [default: 0.0]
      • max_range [default: 10000.0]
      • min_scan_valid_columns_ratio [default: 0.0]
      • v_reduction [default: 1]
      • mask_path [default: ]
  • launch/sensor_mtp.launch.xml
      • ouster_ns [default: ouster]
      • sensor_hostname
      • udp_dest
      • mtp_dest [default: ]
      • mtp_main [default: false]
      • lidar_port [default: 0]
      • imu_port [default: 0]
      • udp_profile_lidar [default: ]
      • lidar_mode [default: ]
      • timestamp_mode [default: ]
      • ptp_utc_tai_offset [default: -37.0]
      • metadata [default: ]
      • viz [default: true]
      • rviz_config [default: $(find-pkg-share ouster_ros)/config/viz.rviz]
      • sensor_frame [default: os_sensor]
      • lidar_frame [default: os_lidar]
      • imu_frame [default: os_imu]
      • point_cloud_frame [default: ]
      • pub_static_tf [default: true]
      • use_system_default_qos [default: false]
      • proc_mask [default: IMG|PCL|IMU|SCAN|TLM]
      • scan_ring [default: 0]
      • point_type [default: original]
      • azimuth_window_start [default: 0]
      • azimuth_window_end [default: 360000]
      • persist_config [default: false]
      • attempt_reconnect [default: false]
      • dormant_period_between_reconnects [default: 1.0]
      • max_failed_reconnect_attempts [default: 2147483647]
      • auto_start [default: true]

Messages

No message files found.

Services

No service files found

Plugins

No plugins found.

Recent questions tagged ouster_ros at Robotics Stack Exchange

No version for distro noetic showing humble. Known supported distros are highlighted in the buttons above.
Package symbol

ouster_ros package from ouster-ros repo

ouster_ros ouster_sensor_msgs

ROS Distro
humble

Package Summary

Tags No category tags.
Version 0.13.14
License BSD
Build type AMENT_CMAKE
Use RECOMMENDED

Repository Summary

Description Official ROS drivers for Ouster sensors (OS0, OS1, OS2, OSDome)
Checkout URI https://github.com/ouster-lidar/ouster-ros.git
VCS Type git
VCS Version humble-devel
Last Updated 2025-09-23
Dev Status DEVELOPED
Released RELEASED
Tags point-cloud ros lidar pcl pointcloud ros2 ros-melodic ouster ros-noetic ros2-foxy ros-drivers ros2-rolling ros2-humble ros2-iron ros2-jazzy
Contributing Help Wanted (-)
Good First Issues (-)
Pull Requests to Review (-)

Package Description

Ouster ROS2 driver

Additional Links

No additional links.

Maintainers

  • ouster developers

Authors

No additional authors.
README
No README found. See repository README.
CHANGELOG

Changelog for package ouster_ros

0.13.14 (2025-09-22)

  • Add ouster-sdk directly

  • Drop whole archive linkage (#489)

  • fix-rolling build (#483)

  • Correct pointcloud.is_dense flag (#473)

  • Port the pointcloud mask feature to ROS2 (#462)

    • Port the pointcloud mask feature to ROS2
    • Base Image fixed
    • Update README and exclude iron from the build
  • [ROS2] Expose the vertical beam reduction param (#444)

    • Expose the vertical beam reduction value + rename arg + Better handling of deprecated topic names
  • ROS-317: Fix simulation in replay mode (#440)

    • Use node clock to properly populate the timestamp in replay modes
    • Update changelog and package number
  • Implement a padding-free version of pcl::PointXYZI (#439)

  • Add a new storage param to record.launch.xml (#437)

    • Add storage param to record
  • [ros2] Fix install directories (#433)

    • Cmakelists: Fix install directories
    • Bump package.xml patch version

    * Update changelog ---------Co-authored-by: Michael Wiznitzer <<mwiznitzer@neyarobotics.com>>

  • Port the changes to ROS2 (#430)

    • Port the changes to ROS2
    • Update sensor.*.launch
  • SW-6906: publish sensor telemetry in ouster ros (#422)

    • Port changes from ROS1 to ROS2
    • Mention TLM as an option in yaml configs
  • Enable auto start on replay node (#421)

  • ROS-389 [rolling/humble/iron/jazzy]: replay-improvments-and-fixes (#393) Remap metadata topic + Support loop capability in pcap replay + Add play_delay & play_rate for replay Added a launch file parameter pub_static_tf to disable sensor transforms broadcast ---------Co-authored-by: Guillaume Doisy <<guillaume@dexory.com>>

  • ROS-350[HUMBLE/IRON/JAZZY]: 't' timestamp field content is not plausible (#387) Align timestamps based on staggered/destaggered option

  • HOTFIX/ROS-382: os_driver fails when raw option is enabled (#384)

    • Fix os_driver fails when RAW option is enabled
    • Replace lifecycle_publisher with regular publisher for the os_pcap
  • HOTFIX/ROS-376-initialize-the-sensor-with-launch-config-params (#380)

    • Invoke parse_config_from_ros_parameters on node init
    • Fix a typo + Add a note regarding the recommendation
  • [HUMBLEJAZZY] Port ROS-363 to ROS2 (#369)

    • Port ROS-363 to ROS2
    • Turn off OSF
    • Update package version and CHANGELOG.rst + up the default max range to 10000.0 meters
  • ROS-368[HUMBLEJAZZY]: Unable to use the replay mode due to unknown substitution arg (#370)

    • Fix replay unknown substitution arg
    • Fix the definition of _loop variable
    • Move remap verb to the node
  • ROS-119: ouster-ros driver automatic reconnection [HUMBLE/IRON/JAZZY] (#362)

    • Port sensor reconnection logic to ROS 2
    • Add Jazzy to the build!
    • Update README and checkout
    • Add a note about not being able to properly handle invalid configuration

File truncated at 100 lines see the full file

Launch files

  • launch/record.composite.launch.xml
      • storage [default: sqlite3]
      • ouster_ns [default: ouster]
      • sensor_hostname
      • udp_dest [default: ]
      • lidar_port [default: 0]
      • imu_port [default: 0]
      • udp_profile_lidar [default: ]
      • lidar_mode [default: ]
      • timestamp_mode [default: ]
      • ptp_utc_tai_offset [default: -37.0]
      • metadata [default: ]
      • bag_file [default: ]
      • viz [default: true]
      • rviz_config [default: $(find-pkg-share ouster_ros)/config/viz-reliable.rviz]
      • sensor_frame [default: os_sensor]
      • lidar_frame [default: os_lidar]
      • imu_frame [default: os_imu]
      • point_cloud_frame [default: ]
      • pub_static_tf [default: true]
      • use_system_default_qos [default: true]
      • proc_mask [default: IMG|PCL|IMU|SCAN|TLM]
      • scan_ring [default: 0]
      • point_type [default: original]
      • organized [default: true]
      • destagger [default: true]
      • min_range [default: 0.0]
      • max_range [default: 100000.0]
      • azimuth_window_start [default: 0]
      • azimuth_window_end [default: 360000]
      • persist_config [default: false]
      • attempt_reconnect [default: false]
      • dormant_period_between_reconnects [default: 1.0]
      • max_failed_reconnect_attempts [default: 2147483647]
      • auto_start [default: true]
      • min_scan_valid_columns_ratio [default: 0.0]
      • v_reduction [default: 1]
      • mask_path [default: ]
  • launch/record.launch.xml
      • storage [default: sqlite3]
      • ouster_ns [default: ouster]
      • sensor_hostname
      • udp_dest [default: ]
      • lidar_port [default: 0]
      • imu_port [default: 0]
      • udp_profile_lidar [default: ]
      • lidar_mode [default: ]
      • timestamp_mode [default: ]
      • ptp_utc_tai_offset [default: -37.0]
      • metadata [default: ]
      • bag_file [default: ]
      • viz [default: true]
      • rviz_config [default: $(find-pkg-share ouster_ros)/config/viz-reliable.rviz]
      • sensor_frame [default: os_sensor]
      • lidar_frame [default: os_lidar]
      • imu_frame [default: os_imu]
      • point_cloud_frame [default: ]
      • pub_static_tf [default: true]
      • use_system_default_qos [default: true]
      • proc_mask [default: IMG|PCL|IMU|SCAN|TLM]
      • scan_ring [default: 0]
      • point_type [default: original]
      • organized [default: true]
      • destagger [default: true]
      • min_range [default: 0.0]
      • max_range [default: 100000.0]
      • azimuth_window_start [default: 0]
      • azimuth_window_end [default: 360000]
      • persist_config [default: false]
      • attempt_reconnect [default: false]
      • dormant_period_between_reconnects [default: 1.0]
      • max_failed_reconnect_attempts [default: 2147483647]
      • auto_start [default: true]
      • min_scan_valid_columns_ratio [default: 0.0]
      • v_reduction [default: 1]
      • mask_path [default: ]
  • launch/replay.composite.launch.xml
      • loop [default: false]
      • play_delay [default: 0]
      • play_rate [default: 1.0]
      • ouster_ns [default: ouster]
      • timestamp_mode [default: ]
      • ptp_utc_tai_offset [default: -37.0]
      • metadata [default: ]
      • bag_file
      • viz [default: true]
      • rviz_config [default: $(find-pkg-share ouster_ros)/config/viz-reliable.rviz]
      • sensor_frame [default: os_sensor]
      • lidar_frame [default: os_lidar]
      • imu_frame [default: os_imu]
      • point_cloud_frame [default: ]
      • pub_static_tf [default: true]
      • use_system_default_qos [default: true]
      • proc_mask [default: IMG|PCL|IMU|SCAN]
      • scan_ring [default: 0]
      • point_type [default: original]
      • organized [default: true]
      • destagger [default: true]
      • min_range [default: 0.0]
      • max_range [default: 100000.0]
      • min_scan_valid_columns_ratio [default: 0.0]
      • v_reduction [default: 1]
      • mask_path [default: ]
  • launch/replay.launch.xml
      • loop [default: false]
      • play_delay [default: 0]
      • play_rate [default: 1.0]
      • ouster_ns [default: ouster]
      • timestamp_mode [default: ]
      • ptp_utc_tai_offset [default: -37.0]
      • metadata [default: ]
      • bag_file
      • viz [default: true]
      • rviz_config [default: $(find-pkg-share ouster_ros)/config/viz-reliable.rviz]
      • sensor_frame [default: os_sensor]
      • lidar_frame [default: os_lidar]
      • imu_frame [default: os_imu]
      • point_cloud_frame [default: ]
      • pub_static_tf [default: true]
      • use_system_default_qos [default: true]
      • proc_mask [default: IMG|PCL|IMU|SCAN]
      • scan_ring [default: 0]
      • point_type [default: original]
      • organized [default: true]
      • destagger [default: true]
      • min_range [default: 0.0]
      • max_range [default: 100000.0]
      • min_scan_valid_columns_ratio [default: 0.0]
      • v_reduction [default: 1]
      • mask_path [default: ]
  • launch/replay_pcap.launch.xml
      • loop [default: false]
      • play_delay [default: 0]
      • progress_update_freq [default: 1.0]
      • ouster_ns [default: ouster]
      • timestamp_mode [default: TIME_FROM_INTERNAL_OSC]
      • ptp_utc_tai_offset [default: -37.0]
      • metadata
      • pcap_file
      • viz [default: true]
      • rviz_config [default: $(find-pkg-share ouster_ros)/config/viz-reliable.rviz]
      • sensor_frame [default: os_sensor]
      • lidar_frame [default: os_lidar]
      • imu_frame [default: os_imu]
      • point_cloud_frame [default: ]
      • pub_static_tf [default: true]
      • use_system_default_qos [default: true]
      • proc_mask [default: IMG|PCL|IMU|SCAN]
      • scan_ring [default: 0]
      • point_type [default: original]
      • organized [default: true]
      • destagger [default: true]
      • min_range [default: 0.0]
      • max_range [default: 10000.0]
      • min_scan_valid_columns_ratio [default: 0.0]
      • v_reduction [default: 1]
      • mask_path [default: ]
  • launch/rviz.launch.xml
      • ouster_ns [default: ouster]
      • rviz_config [default: $(find-pkg-share ouster_ros)/config/viz.rviz]
  • launch/sensor.composite.launch.xml
      • ouster_ns [default: ouster]
      • sensor_hostname
      • udp_dest [default: ]
      • lidar_port [default: 0]
      • imu_port [default: 0]
      • udp_profile_lidar [default: ]
      • lidar_mode [default: ]
      • timestamp_mode [default: ]
      • ptp_utc_tai_offset [default: -37.0]
      • metadata [default: ]
      • viz [default: true]
      • rviz_config [default: $(find-pkg-share ouster_ros)/config/viz.rviz]
      • sensor_frame [default: os_sensor]
      • lidar_frame [default: os_lidar]
      • imu_frame [default: os_imu]
      • point_cloud_frame [default: ]
      • pub_static_tf [default: true]
      • use_system_default_qos [default: false]
      • proc_mask [default: IMG|PCL|IMU|SCAN|TLM]
      • scan_ring [default: 0]
      • point_type [default: original]
      • azimuth_window_start [default: 0]
      • azimuth_window_end [default: 360000]
      • persist_config [default: false]
      • attempt_reconnect [default: false]
      • dormant_period_between_reconnects [default: 1.0]
      • max_failed_reconnect_attempts [default: 2147483647]
      • auto_start [default: true]
      • organized [default: true]
      • destagger [default: true]
      • min_range [default: 0.0]
      • max_range [default: 10000.0]
      • min_scan_valid_columns_ratio [default: 0.0]
      • v_reduction [default: 1]
      • mask_path [default: ]
  • launch/sensor.independent.launch.xml
      • ouster_ns [default: ouster]
      • sensor_hostname
      • udp_dest [default: ]
      • lidar_port [default: 0]
      • imu_port [default: 0]
      • udp_profile_lidar [default: ]
      • lidar_mode [default: ]
      • timestamp_mode [default: ]
      • ptp_utc_tai_offset [default: -37.0]
      • metadata [default: ]
      • viz [default: true]
      • rviz_config [default: $(find-pkg-share ouster_ros)/config/viz.rviz]
      • sensor_frame [default: os_sensor]
      • lidar_frame [default: os_lidar]
      • imu_frame [default: os_imu]
      • point_cloud_frame [default: ]
      • pub_static_tf [default: true]
      • use_system_default_qos [default: false]
      • proc_mask [default: IMG|PCL|IMU|SCAN]
      • scan_ring [default: 0]
      • point_type [default: original]
      • azimuth_window_start [default: 0]
      • azimuth_window_end [default: 360000]
      • persist_config [default: false]
      • attempt_reconnect [default: false]
      • dormant_period_between_reconnects [default: 1.0]
      • max_failed_reconnect_attempts [default: 2147483647]
      • auto_start [default: true]
      • min_scan_valid_columns_ratio [default: 0.0]
  • launch/sensor.launch.xml
      • ouster_ns [default: ouster]
      • sensor_hostname
      • udp_dest [default: ]
      • lidar_port [default: 0]
      • imu_port [default: 0]
      • udp_profile_lidar [default: ]
      • lidar_mode [default: ]
      • timestamp_mode [default: ]
      • ptp_utc_tai_offset [default: -37.0]
      • metadata [default: ]
      • viz [default: true]
      • rviz_config [default: $(find-pkg-share ouster_ros)/config/viz.rviz]
      • sensor_frame [default: os_sensor]
      • lidar_frame [default: os_lidar]
      • imu_frame [default: os_imu]
      • point_cloud_frame [default: ]
      • pub_static_tf [default: true]
      • use_system_default_qos [default: false]
      • proc_mask [default: IMG|PCL|IMU|SCAN|TLM]
      • scan_ring [default: 0]
      • point_type [default: original]
      • azimuth_window_start [default: 0]
      • azimuth_window_end [default: 360000]
      • persist_config [default: false]
      • attempt_reconnect [default: false]
      • dormant_period_between_reconnects [default: 1.0]
      • max_failed_reconnect_attempts [default: 2147483647]
      • auto_start [default: true]
      • organized [default: true]
      • destagger [default: true]
      • min_range [default: 0.0]
      • max_range [default: 10000.0]
      • min_scan_valid_columns_ratio [default: 0.0]
      • v_reduction [default: 1]
      • mask_path [default: ]
  • launch/sensor_mtp.launch.xml
      • ouster_ns [default: ouster]
      • sensor_hostname
      • udp_dest
      • mtp_dest [default: ]
      • mtp_main [default: false]
      • lidar_port [default: 0]
      • imu_port [default: 0]
      • udp_profile_lidar [default: ]
      • lidar_mode [default: ]
      • timestamp_mode [default: ]
      • ptp_utc_tai_offset [default: -37.0]
      • metadata [default: ]
      • viz [default: true]
      • rviz_config [default: $(find-pkg-share ouster_ros)/config/viz.rviz]
      • sensor_frame [default: os_sensor]
      • lidar_frame [default: os_lidar]
      • imu_frame [default: os_imu]
      • point_cloud_frame [default: ]
      • pub_static_tf [default: true]
      • use_system_default_qos [default: false]
      • proc_mask [default: IMG|PCL|IMU|SCAN|TLM]
      • scan_ring [default: 0]
      • point_type [default: original]
      • azimuth_window_start [default: 0]
      • azimuth_window_end [default: 360000]
      • persist_config [default: false]
      • attempt_reconnect [default: false]
      • dormant_period_between_reconnects [default: 1.0]
      • max_failed_reconnect_attempts [default: 2147483647]
      • auto_start [default: true]

Messages

No message files found.

Services

No service files found

Plugins

No plugins found.

Recent questions tagged ouster_ros at Robotics Stack Exchange