/* * Copyright 2018 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/mapping/internal/global_trajectory_builder.h" #include #include "absl/memory/memory.h" #include "absl/types/optional.h" #include "cartographer/common/time.h" #include "cartographer/mapping/internal/local_slam_result_data.h" #include "cartographer/mapping/internal/motion_filter.h" #include "cartographer/metrics/family_factory.h" #include "glog/logging.h" namespace cartographer { namespace mapping { namespace { static auto* kLocalSlamMatchingResults = metrics::Counter::Null(); static auto* kLocalSlamInsertionResults = metrics::Counter::Null(); template class GlobalTrajectoryBuilder : public mapping::TrajectoryBuilderInterface { public: // Passing a 'nullptr' for 'local_trajectory_builder' is acceptable, but no // 'TimedPointCloudData' may be added in that case. GlobalTrajectoryBuilder( std::unique_ptr local_trajectory_builder, const int trajectory_id, PoseGraph* const pose_graph, const LocalSlamResultCallback& local_slam_result_callback, const absl::optional& pose_graph_odometry_motion_filter) : trajectory_id_(trajectory_id), pose_graph_(pose_graph), local_trajectory_builder_(std::move(local_trajectory_builder)), local_slam_result_callback_(local_slam_result_callback), pose_graph_odometry_motion_filter_(pose_graph_odometry_motion_filter) {} ~GlobalTrajectoryBuilder() override {} GlobalTrajectoryBuilder(const GlobalTrajectoryBuilder&) = delete; GlobalTrajectoryBuilder& operator=(const GlobalTrajectoryBuilder&) = delete; void AddSensorData( const std::string& sensor_id, const sensor::TimedPointCloudData& timed_point_cloud_data) override { CHECK(local_trajectory_builder_) << "Cannot add TimedPointCloudData without a LocalTrajectoryBuilder."; std::unique_ptr matching_result = local_trajectory_builder_->AddRangeData( sensor_id, timed_point_cloud_data); if (matching_result == nullptr) { // The range data has not been fully accumulated yet. return; } kLocalSlamMatchingResults->Increment(); std::unique_ptr insertion_result; if (matching_result->insertion_result != nullptr) { kLocalSlamInsertionResults->Increment(); auto node_id = pose_graph_->AddNode( matching_result->insertion_result->constant_data, trajectory_id_, matching_result->insertion_result->insertion_submaps); CHECK_EQ(node_id.trajectory_id, trajectory_id_); insertion_result = absl::make_unique(InsertionResult{ node_id, matching_result->insertion_result->constant_data, std::vector>( matching_result->insertion_result->insertion_submaps.begin(), matching_result->insertion_result->insertion_submaps.end())}); } if (local_slam_result_callback_) { local_slam_result_callback_( trajectory_id_, matching_result->time, matching_result->local_pose, std::move(matching_result->range_data_in_local), std::move(insertion_result)); } } void AddSensorData(const std::string& sensor_id, const sensor::ImuData& imu_data) override { if (local_trajectory_builder_) { local_trajectory_builder_->AddImuData(imu_data); } pose_graph_->AddImuData(trajectory_id_, imu_data); } void AddSensorData(const std::string& sensor_id, const sensor::OdometryData& odometry_data) override { CHECK(odometry_data.pose.IsValid()) << odometry_data.pose; if (local_trajectory_builder_) { local_trajectory_builder_->AddOdometryData(odometry_data); } // TODO(MichaelGrupp): Instead of having an optional filter on this level, // odometry could be marginalized between nodes in the pose graph. // Related issue: cartographer-project/cartographer/#1768 if (pose_graph_odometry_motion_filter_.has_value() && pose_graph_odometry_motion_filter_.value().IsSimilar( odometry_data.time, odometry_data.pose)) { return; } pose_graph_->AddOdometryData(trajectory_id_, odometry_data); } void AddSensorData( const std::string& sensor_id, const sensor::FixedFramePoseData& fixed_frame_pose) override { if (fixed_frame_pose.pose.has_value()) { CHECK(fixed_frame_pose.pose.value().IsValid()) << fixed_frame_pose.pose.value(); } pose_graph_->AddFixedFramePoseData(trajectory_id_, fixed_frame_pose); } void AddSensorData(const std::string& sensor_id, const sensor::LandmarkData& landmark_data) override { pose_graph_->AddLandmarkData(trajectory_id_, landmark_data); } void AddLocalSlamResultData(std::unique_ptr local_slam_result_data) override { CHECK(!local_trajectory_builder_) << "Can't add LocalSlamResultData with " "local_trajectory_builder_ present."; local_slam_result_data->AddToPoseGraph(trajectory_id_, pose_graph_); } private: const int trajectory_id_; PoseGraph* const pose_graph_; std::unique_ptr local_trajectory_builder_; LocalSlamResultCallback local_slam_result_callback_; absl::optional pose_graph_odometry_motion_filter_; }; } // namespace std::unique_ptr CreateGlobalTrajectoryBuilder2D( std::unique_ptr local_trajectory_builder, const int trajectory_id, mapping::PoseGraph2D* const pose_graph, const TrajectoryBuilderInterface::LocalSlamResultCallback& local_slam_result_callback, const absl::optional& pose_graph_odometry_motion_filter) { return absl::make_unique< GlobalTrajectoryBuilder>( std::move(local_trajectory_builder), trajectory_id, pose_graph, local_slam_result_callback, pose_graph_odometry_motion_filter); } std::unique_ptr CreateGlobalTrajectoryBuilder3D( std::unique_ptr local_trajectory_builder, const int trajectory_id, mapping::PoseGraph3D* const pose_graph, const TrajectoryBuilderInterface::LocalSlamResultCallback& local_slam_result_callback, const absl::optional& pose_graph_odometry_motion_filter) { return absl::make_unique< GlobalTrajectoryBuilder>( std::move(local_trajectory_builder), trajectory_id, pose_graph, local_slam_result_callback, pose_graph_odometry_motion_filter); } void GlobalTrajectoryBuilderRegisterMetrics(metrics::FamilyFactory* factory) { auto* results = factory->NewCounterFamily( "mapping_global_trajectory_builder_local_slam_results", "Local SLAM results"); kLocalSlamMatchingResults = results->Add({{"type", "MatchingResult"}}); kLocalSlamInsertionResults = results->Add({{"type", "InsertionResult"}}); } } // namespace mapping } // namespace cartographer