Nav2 Navigation Stack - rolling  main
ROS 2 Navigation Stack
pointcloud.cpp
1 // Copyright (c) 2022 Samsung R&D Institute Russia
2 //
3 // Licensed under the Apache License, Version 2.0 (the "License");
4 // you may not use this file except in compliance with the License.
5 // You may obtain a copy of the License at
6 //
7 // http://www.apache.org/licenses/LICENSE-2.0
8 //
9 // Unless required by applicable law or agreed to in writing, software
10 // distributed under the License is distributed on an "AS IS" BASIS,
11 // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
12 // See the License for the specific language governing permissions and
13 // limitations under the License.
14 
15 #include "nav2_collision_monitor/pointcloud.hpp"
16 
17 #include <functional>
18 
19 #include "sensor_msgs/point_cloud2_iterator.hpp"
20 #include "tf2/transform_datatypes.hpp"
21 
22 #include "nav2_ros_common/node_utils.hpp"
23 #include "nav2_util/robot_utils.hpp"
24 
25 namespace nav2_collision_monitor
26 {
27 
29  const nav2::LifecycleNode::WeakPtr & node,
30  const std::string & source_name,
31  const std::shared_ptr<tf2_ros::Buffer> tf_buffer,
32  const std::string & base_frame_id,
33  const std::string & global_frame_id,
34  const tf2::Duration & transform_tolerance,
35  const rclcpp::Duration & source_timeout,
36  const bool base_shift_correction)
37 : Source(
38  node, source_name, tf_buffer, base_frame_id, global_frame_id,
39  transform_tolerance, source_timeout, base_shift_correction),
40  data_(nullptr)
41 {
42  RCLCPP_INFO(logger_, "[%s]: Creating PointCloud", source_name_.c_str());
43 }
44 
46 {
47  RCLCPP_INFO(logger_, "[%s]: Destroying PointCloud", source_name_.c_str());
48  #if RCLCPP_VERSION_GTE(30, 0, 0)
49  data_sub_.shutdown();
50  #else
51  data_sub_.reset();
52  #endif
53 }
54 
56 {
58  auto node = node_.lock();
59  if (!node) {
60  throw std::runtime_error{"Failed to lock node"};
61  }
62 
63  std::string source_topic;
64 
65  getParameters(source_topic);
66 
67  #if RCLCPP_VERSION_GTE(30, 0, 0)
68  const point_cloud_transport::TransportHints hint(transport_type_);
69  pct_ = std::make_shared<point_cloud_transport::PointCloudTransport>(*node);
70  data_sub_ = pct_->subscribe(
71  source_topic, nav2::qos::SensorDataQoS(),
72  std::bind(&PointCloud::dataCallback, this, std::placeholders::_1),
73  {}, &hint
74  );
75  #else
76  data_sub_ = node->create_subscription<sensor_msgs::msg::PointCloud2>(
77  source_topic,
78  std::bind(&PointCloud::dataCallback, this, std::placeholders::_1),
80  #endif
81 
82  // Add callback for dynamic parameters
83  dyn_params_handler_ = node->add_on_set_parameters_callback(
84  std::bind(&PointCloud::dynamicParametersCallback, this, std::placeholders::_1));
85 }
86 
88  const rclcpp::Time & curr_time,
89  std::vector<Point> & data)
90 {
91  // Ignore data from the source if it is not being published yet or
92  // not published for a long time
93  if (data_ == nullptr) {
94  return false;
95  }
96  if (!sourceValid(data_->header.stamp, curr_time)) {
97  return false;
98  }
99 
100  tf2::Transform tf_transform;
101  if (!getTransform(curr_time, data_->header, tf_transform)) {
102  return false;
103  }
104 
105  sensor_msgs::PointCloud2ConstIterator<float> iter_x(*data_, "x");
106  sensor_msgs::PointCloud2ConstIterator<float> iter_y(*data_, "y");
107  sensor_msgs::PointCloud2ConstIterator<float> iter_z(*data_, "z");
108 
109  // Refill data array with PointCloud points in base frame
110  for (; iter_x != iter_x.end(); ++iter_x, ++iter_y, ++iter_z) {
111  // Transform point coordinates from source frame -> to base frame
112  tf2::Vector3 p_v3_s(*iter_x, *iter_y, *iter_z);
113 
114  // Check range from sensor origin before transformation
115  double range = p_v3_s.length();
116  if (range < min_range_) {
117  continue;
118  }
119 
120  tf2::Vector3 p_v3_b = tf_transform * p_v3_s;
121 
122  // Refill data array
123  if (p_v3_b.z() >= min_height_ && p_v3_b.z() <= max_height_) {
124  data.push_back({p_v3_b.x(), p_v3_b.y()});
125  }
126  }
127  return true;
128 }
129 
130 void PointCloud::getParameters(std::string & source_topic)
131 {
132  auto node = node_.lock();
133  if (!node) {
134  throw std::runtime_error{"Failed to lock node"};
135  }
136 
137  getCommonParameters(source_topic);
138 
139  nav2::declare_parameter_if_not_declared(
140  node, source_name_ + ".min_height", rclcpp::ParameterValue(0.05));
141  min_height_ = node->get_parameter(source_name_ + ".min_height").as_double();
142  nav2::declare_parameter_if_not_declared(
143  node, source_name_ + ".max_height", rclcpp::ParameterValue(0.5));
144  max_height_ = node->get_parameter(source_name_ + ".max_height").as_double();
145  nav2::declare_parameter_if_not_declared(
146  node, source_name_ + ".min_range", rclcpp::ParameterValue(0.0));
147  min_range_ = node->get_parameter(source_name_ + ".min_range").as_double();
148  nav2::declare_parameter_if_not_declared(
149  node, source_name_ + ".transport_type", rclcpp::ParameterValue(std::string("raw")));
150  transport_type_ = node->get_parameter(source_name_ + ".transport_type").as_string();
151 }
152 
153 void PointCloud::dataCallback(sensor_msgs::msg::PointCloud2::ConstSharedPtr msg)
154 {
155  data_ = msg;
156 }
157 
158 rcl_interfaces::msg::SetParametersResult
160  std::vector<rclcpp::Parameter> parameters)
161 {
162  rcl_interfaces::msg::SetParametersResult result;
163 
164  for (auto parameter : parameters) {
165  const auto & param_type = parameter.get_type();
166  const auto & param_name = parameter.get_name();
167  if(param_name.find(source_name_ + ".") != 0) {
168  continue;
169  }
170  if (param_type == rcl_interfaces::msg::ParameterType::PARAMETER_DOUBLE) {
171  if (param_name == source_name_ + "." + "min_height") {
172  min_height_ = parameter.as_double();
173  } else if (param_name == source_name_ + "." + "max_height") {
174  max_height_ = parameter.as_double();
175  } else if (param_name == source_name_ + "." + "min_range") {
176  min_range_ = parameter.as_double();
177  }
178  } else if (param_type == rcl_interfaces::msg::ParameterType::PARAMETER_BOOL) {
179  if (param_name == source_name_ + "." + "enabled") {
180  enabled_ = parameter.as_bool();
181  }
182  }
183  }
184  result.successful = true;
185  return result;
186 }
187 
188 } // namespace nav2_collision_monitor
A QoS profile for best-effort sensor data with a history of 10 messages.
void getParameters(std::string &source_topic)
Getting sensor-specific ROS-parameters.
Definition: pointcloud.cpp:130
sensor_msgs::msg::PointCloud2::ConstSharedPtr data_
Latest data obtained from pointcloud.
Definition: pointcloud.hpp:118
void configure()
Data source configuration routine. Obtains pointcloud related ROS-parameters and creates pointcloud s...
Definition: pointcloud.cpp:55
nav2::Subscription< sensor_msgs::msg::PointCloud2 >::SharedPtr data_sub_
PointCloud data subscriber.
Definition: pointcloud.hpp:106
void dataCallback(sensor_msgs::msg::PointCloud2::ConstSharedPtr msg)
PointCloud data callback.
Definition: pointcloud.cpp:153
PointCloud(const nav2::LifecycleNode::WeakPtr &node, const std::string &source_name, const std::shared_ptr< tf2_ros::Buffer > tf_buffer, const std::string &base_frame_id, const std::string &global_frame_id, const tf2::Duration &transform_tolerance, const rclcpp::Duration &source_timeout, const bool base_shift_correction)
PointCloud constructor.
Definition: pointcloud.cpp:28
rcl_interfaces::msg::SetParametersResult dynamicParametersCallback(std::vector< rclcpp::Parameter > parameters)
Callback executed when a parameter change is detected.
Definition: pointcloud.cpp:159
~PointCloud()
PointCloud destructor.
Definition: pointcloud.cpp:45
bool getData(const rclcpp::Time &curr_time, std::vector< Point > &data)
Adds latest data from pointcloud source to the data array.
Definition: pointcloud.cpp:87
Basic data source class.
Definition: source.hpp:38
nav2::LifecycleNode::WeakPtr node_
Collision Monitor node.
Definition: source.hpp:144
rclcpp::Logger logger_
Collision monitor node logger stored for further usage.
Definition: source.hpp:146
bool getTransform(const rclcpp::Time &curr_time, const std_msgs::msg::Header &data_header, tf2::Transform &tf_transform) const
Obtain the transform to get data from source frame and time where it was received to the base frame a...
Definition: source.cpp:137
bool enabled_
Whether source is enabled.
Definition: source.hpp:169
void getCommonParameters(std::string &source_topic)
Supporting routine obtaining ROS-parameters common for all data sources.
Definition: source.cpp:58
bool configure()
Source configuration routine.
Definition: source.cpp:47
std::string source_name_
Name of data source.
Definition: source.hpp:152
bool sourceValid(const rclcpp::Time &source_time, const rclcpp::Time &curr_time) const
Checks whether the source data might be considered as valid.
Definition: source.cpp:81
rclcpp::node_interfaces::OnSetParametersCallbackHandle::SharedPtr dyn_params_handler_
Dynamic parameters handler.
Definition: source.hpp:148