parameters_handler.hpp

// Copyright (c) 2022 Samsung Research America, @artofnothingness Alexey Budyakov
//
// Licensed under the Apache License, Version 2.0 (the "License");
// you may not use this file except in compliance with the License.
// You may obtain a copy of the License at
//
//     http://www.apache.org/licenses/LICENSE-2.0
//
// Unless required by applicable law or agreed to in writing, software
// distributed under the License is distributed on an "AS IS" BASIS,
// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
// See the License for the specific language governing permissions and
// limitations under the License.
 
#ifndef NAV2_MPPI_CONTROLLER__TOOLS__PARAMETERS_HANDLER_HPP_
#define NAV2_MPPI_CONTROLLER__TOOLS__PARAMETERS_HANDLER_HPP_
 
#include <functional>
#include <string>
#include <type_traits>
#include <unordered_map>
#include <utility>
#include <vector>
 
#include "nav2_ros_common/lifecycle_node.hpp"
#include "nav2_ros_common/node_utils.hpp"
#include "rclcpp/rclcpp.hpp"
#include "rclcpp/parameter_value.hpp"
#include "rclcpp_lifecycle/lifecycle_node.hpp"
 
namespace mppi
{
enum class ParameterType { Dynamic, Static };
 
class ParametersHandler
{
public:
  using get_param_func_t = void (const rclcpp::Parameter & param,
    rcl_interfaces::msg::SetParametersResult & result);
  using post_callback_t = void ();
  using pre_callback_t = void ();
  ParametersHandler() = default;
 
  explicit ParametersHandler(
    const nav2::LifecycleNode::WeakPtr & parent, std::string & name);
 
  ~ParametersHandler();
 
  void start();
 
  rcl_interfaces::msg::SetParametersResult validateParameterUpdatesCallback(
    const std::vector<rclcpp::Parameter> & parameters);
 
  void updateParametersCallback(const std::vector<rclcpp::Parameter> & parameters);
 
  inline auto getParamGetter(const std::string & ns);
 
  template<typename T>
  void addPostCallback(T && callback);
 
  template<typename T>
  void addPreCallback(const std::string & name, T && callback);
 
  template<typename T>
  void setParamCallback(
    T & setting, const std::string & name, ParameterType param_type = ParameterType::Dynamic);
 
  std::mutex * getLock()
  {
    return &parameters_change_mutex_;
  }
 
  template<typename T>
  void addParamCallback(const std::string & name, T && callback);
 
protected:
  template<typename SettingT, typename ParamT>
  void getParam(
    SettingT & setting, const std::string & name, ParamT default_value,
    ParameterType param_type = ParameterType::Dynamic);
 
  template<typename ParamT, typename SettingT>
  void setParam(
    SettingT & setting,
    const std::string & name,
    nav2::LifecycleNode::SharedPtr node) const;
 
  template<typename T>
  static auto as(const rclcpp::Parameter & parameter);
 
  std::mutex parameters_change_mutex_;
  rclcpp::Logger logger_{rclcpp::get_logger("MPPIController")};
  rclcpp::node_interfaces::OnSetParametersCallbackHandle::SharedPtr
    on_set_param_handler_;
  rclcpp::node_interfaces::PostSetParametersCallbackHandle::SharedPtr
    post_set_param_handler_;
  nav2::LifecycleNode::WeakPtr node_;
  std::string node_name_;
  std::string name_;
 
  bool verbose_{false};
 
  std::unordered_map<std::string,
    std::function<void(const rclcpp::Parameter &)>> get_param_callbacks_;
  std::unordered_map<std::string, std::function<get_param_func_t>> get_pre_callbacks_;
 
  std::vector<std::function<post_callback_t>> post_callbacks_;
};
 
inline auto ParametersHandler::getParamGetter(const std::string & ns)
{
  return [this, ns](
    auto & setting, const std::string & name, auto default_value,
    ParameterType param_type = ParameterType::Dynamic) {
           getParam(
             setting, ns.empty() ? name : ns + "." + name,
             std::move(default_value), param_type);
         };
}
 
template<typename T>
void ParametersHandler::addParamCallback(const std::string & name, T && callback)
{
  get_param_callbacks_[name] = callback;
}
 
template<typename T>
void ParametersHandler::addPostCallback(T && callback)
{
  post_callbacks_.push_back(callback);
}
 
template<typename T>
void ParametersHandler::addPreCallback(const std::string & name, T && callback)
{
  get_pre_callbacks_[name] = callback;
}
 
template<typename SettingT, typename ParamT>
void ParametersHandler::getParam(
  SettingT & setting, const std::string & name,
  ParamT default_value,
  ParameterType param_type)
{
  auto node = node_.lock();
 
  nav2::declare_parameter_if_not_declared(
    node, name, rclcpp::ParameterValue(default_value));
 
  setParam<ParamT>(setting, name, node);
  setParamCallback(setting, name, param_type);
}
 
template<typename ParamT, typename SettingT>
void ParametersHandler::setParam(
  SettingT & setting, const std::string & name, nav2::LifecycleNode::SharedPtr node) const
{
  ParamT param_in{};
  node->get_parameter(name, param_in);
  setting = static_cast<SettingT>(param_in);
}
 
template<typename T>
void ParametersHandler::setParamCallback(
  T & setting, const std::string & name, ParameterType param_type)
{
  if (get_param_callbacks_.find(name) != get_param_callbacks_.end()) {
    return;
  }
 
  auto dynamic_callback =
    [this, &setting, name](
    const rclcpp::Parameter & param) {
      setting = as<T>(param);
      if (verbose_) {
        RCLCPP_INFO(logger_, "Dynamic parameter changed: %s", std::to_string(param).c_str());
      }
    };
 
  auto static_callback =
    [name](
    const rclcpp::Parameter & param, rcl_interfaces::msg::SetParametersResult & result) {
      std::string reason = "Rejected change to static parameter: " + std::to_string(param);
      result.successful = false;
      if (!result.reason.empty()) {
        result.reason += "\n";
      }
      result.reason += reason;
    };
 
  if (param_type == ParameterType::Dynamic) {
    addParamCallback(name, dynamic_callback);
  } else {
    addPreCallback(name, static_callback);
  }
}
 
template<typename T>
auto ParametersHandler::as(const rclcpp::Parameter & parameter)
{
  if constexpr (std::is_same_v<T, bool>) {
    return parameter.as_bool();
  } else if constexpr (std::is_integral_v<T>) {
    return parameter.as_int();
  } else if constexpr (std::is_floating_point_v<T>) {
    return parameter.as_double();
  } else if constexpr (std::is_same_v<T, std::string>) {
    return parameter.as_string();
  } else if constexpr (std::is_same_v<T, std::vector<int64_t>>) {
    return parameter.as_integer_array();
  } else if constexpr (std::is_same_v<T, std::vector<double>>) {
    return parameter.as_double_array();
  } else if constexpr (std::is_same_v<T, std::vector<std::string>>) {
    return parameter.as_string_array();
  } else if constexpr (std::is_same_v<T, std::vector<bool>>) {
    return parameter.as_bool_array();
  }
}
 
}  // namespace mppi
 
#endif  // NAV2_MPPI_CONTROLLER__TOOLS__PARAMETERS_HANDLER_HPP_