trajectory_options.cc

Go to the documentation of this file.

/*
 * Copyright 2016 The Cartographer Authors
 *
 * 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.
 */

#include "cartographer_ros/trajectory_options.h"

#include "cartographer/mapping/trajectory_builder_interface.h"
#include "cartographer/transform/rigid_transform.h"
#include "cartographer/transform/transform.h"
#include "cartographer_ros/time_conversion.h"
#include "glog/logging.h"

namespace cartographer_ros {

namespace {

void CheckTrajectoryOptions(const TrajectoryOptions& options) {
  CHECK_GE(options.num_subdivisions_per_laser_scan, 1);
  CHECK_GE(options.num_laser_scans + options.num_multi_echo_laser_scans +
               options.num_point_clouds,
           1)
      << "Configuration error: 'num_laser_scans', "
         "'num_multi_echo_laser_scans' and 'num_point_clouds' are "
         "all zero, but at least one is required.";
}

}  // namespace

TrajectoryOptions CreateTrajectoryOptions(
    ::cartographer::common::LuaParameterDictionary* const
        lua_parameter_dictionary) {
  TrajectoryOptions options;
  options.trajectory_builder_options =
      ::cartographer::mapping::CreateTrajectoryBuilderOptions(
          lua_parameter_dictionary->GetDictionary("trajectory_builder").get());
  options.tracking_frame =
      lua_parameter_dictionary->GetString("tracking_frame");
  options.published_frame =
      lua_parameter_dictionary->GetString("published_frame");
  options.odom_frame = lua_parameter_dictionary->GetString("odom_frame");
  options.provide_odom_frame =
      lua_parameter_dictionary->GetBool("provide_odom_frame");
  options.use_odometry = lua_parameter_dictionary->GetBool("use_odometry");
  options.use_nav_sat = lua_parameter_dictionary->GetBool("use_nav_sat");
  options.use_landmarks = lua_parameter_dictionary->GetBool("use_landmarks");
  options.publish_frame_projected_to_2d =
      lua_parameter_dictionary->GetBool("publish_frame_projected_to_2d");
  options.num_laser_scans =
      lua_parameter_dictionary->GetNonNegativeInt("num_laser_scans");
  options.num_multi_echo_laser_scans =
      lua_parameter_dictionary->GetNonNegativeInt("num_multi_echo_laser_scans");
  options.num_subdivisions_per_laser_scan =
      lua_parameter_dictionary->GetNonNegativeInt(
          "num_subdivisions_per_laser_scan");
  options.num_point_clouds =
      lua_parameter_dictionary->GetNonNegativeInt("num_point_clouds");
  options.rangefinder_sampling_ratio =
      lua_parameter_dictionary->GetDouble("rangefinder_sampling_ratio");
  options.odometry_sampling_ratio =
      lua_parameter_dictionary->GetDouble("odometry_sampling_ratio");
  options.fixed_frame_pose_sampling_ratio =
      lua_parameter_dictionary->GetDouble("fixed_frame_pose_sampling_ratio");
  options.imu_sampling_ratio =
      lua_parameter_dictionary->GetDouble("imu_sampling_ratio");
  options.landmarks_sampling_ratio =
      lua_parameter_dictionary->GetDouble("landmarks_sampling_ratio");
  CheckTrajectoryOptions(options);
  return options;
}

TrajectoryOptions CreateTrajectoryOptions(
    ::cartographer::common::LuaParameterDictionary* lua_parameter_dictionary,
    ::cartographer::common::LuaParameterDictionary* initial_trajectory_pose) {
  TrajectoryOptions options = CreateTrajectoryOptions(lua_parameter_dictionary);
  *options.trajectory_builder_options.mutable_initial_trajectory_pose() =
      CreateInitialTrajectoryPose(initial_trajectory_pose);
  return options;
}

::cartographer::mapping::proto::InitialTrajectoryPose
CreateInitialTrajectoryPose(
    ::cartographer::common::LuaParameterDictionary* lua_parameter_dictionary) {
  ::cartographer::mapping::proto::InitialTrajectoryPose pose;
  pose.set_to_trajectory_id(
      lua_parameter_dictionary->GetNonNegativeInt("to_trajectory_id"));
  *pose.mutable_relative_pose() =
      cartographer::transform::ToProto(cartographer::transform::FromDictionary(
          lua_parameter_dictionary->GetDictionary("relative_pose").get()));
  pose.set_timestamp(
      lua_parameter_dictionary->HasKey("timestamp")
          ? lua_parameter_dictionary->GetNonNegativeInt("timestamp")
          : cartographer::common::ToUniversal(FromRos(ros::Time::now())));
  return pose;
}

bool FromRosMessage(const cartographer_ros_msgs::TrajectoryOptions& msg,
                    TrajectoryOptions* options) {
  options->tracking_frame = msg.tracking_frame;
  options->published_frame = msg.published_frame;
  options->odom_frame = msg.odom_frame;
  options->provide_odom_frame = msg.provide_odom_frame;
  options->use_odometry = msg.use_odometry;
  options->use_nav_sat = msg.use_nav_sat;
  options->use_landmarks = msg.use_landmarks;
  options->publish_frame_projected_to_2d = msg.publish_frame_projected_to_2d;
  options->num_laser_scans = msg.num_laser_scans;
  options->num_multi_echo_laser_scans = msg.num_multi_echo_laser_scans;
  options->num_subdivisions_per_laser_scan =
      msg.num_subdivisions_per_laser_scan;
  options->num_point_clouds = msg.num_point_clouds;
  options->rangefinder_sampling_ratio = msg.rangefinder_sampling_ratio;
  options->odometry_sampling_ratio = msg.odometry_sampling_ratio;
  options->fixed_frame_pose_sampling_ratio =
      msg.fixed_frame_pose_sampling_ratio;
  options->imu_sampling_ratio = msg.imu_sampling_ratio;
  options->landmarks_sampling_ratio = msg.landmarks_sampling_ratio;
  if (!options->trajectory_builder_options.ParseFromString(
          msg.trajectory_builder_options_proto)) {
    LOG(ERROR) << "Failed to parse protobuf";
    return false;
  }
  CheckTrajectoryOptions(*options);
  return true;
}

cartographer_ros_msgs::TrajectoryOptions ToRosMessage(
    const TrajectoryOptions& options) {
  cartographer_ros_msgs::TrajectoryOptions msg;
  msg.tracking_frame = options.tracking_frame;
  msg.published_frame = options.published_frame;
  msg.odom_frame = options.odom_frame;
  msg.provide_odom_frame = options.provide_odom_frame;
  msg.use_odometry = options.use_odometry;
  msg.use_nav_sat = options.use_nav_sat;
  msg.use_landmarks = options.use_landmarks;
  msg.publish_frame_projected_to_2d = options.publish_frame_projected_to_2d;
  msg.num_laser_scans = options.num_laser_scans;
  msg.num_multi_echo_laser_scans = options.num_multi_echo_laser_scans;
  msg.num_subdivisions_per_laser_scan = options.num_subdivisions_per_laser_scan;
  msg.num_point_clouds = options.num_point_clouds;
  msg.rangefinder_sampling_ratio = options.rangefinder_sampling_ratio;
  msg.odometry_sampling_ratio = options.odometry_sampling_ratio;
  msg.fixed_frame_pose_sampling_ratio = options.fixed_frame_pose_sampling_ratio;
  msg.imu_sampling_ratio = options.imu_sampling_ratio;
  msg.landmarks_sampling_ratio = options.landmarks_sampling_ratio;
  options.trajectory_builder_options.SerializeToString(
      &msg.trajectory_builder_options_proto);
  return msg;
}

}  // namespace cartographer_ros