/* * 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. */ #ifndef CARTOGRAPHER_COMMON_MATH_H_ #define CARTOGRAPHER_COMMON_MATH_H_ #include #include #include "Eigen/Core" #include "port.h" #include "ceres/ceres.h" namespace common { // Clamps 'value' to be in the range ['min', 'max']. template T Clamp(const T value, const T min, const T max) { if (value > max) { return max; } if (value < min) { return min; } return value; } // Calculates 'base'^'exponent'. template constexpr T Power(T base, int exponent) { return (exponent != 0) ? base * Power(base, exponent - 1) : T(1); } // Calculates a^2. template constexpr T Pow2(T a) { return Power(a, 2); } // Converts from degrees to radians. constexpr double DegToRad(double deg) { return M_PI * deg / 180.; } // Converts form radians to degrees. constexpr double RadToDeg(double rad) { return 180. * rad / M_PI; } // Bring the 'difference' between two angles into [-pi; pi]. template T NormalizeAngleDifference(T difference) { const T kPi = T(M_PI); while (difference > kPi) difference -= 2. * kPi; while (difference < -kPi) difference += 2. * kPi; return difference; } template T atan2(const Eigen::Matrix& vector) { return ceres::atan2(vector.y(), vector.x()); } template inline void QuaternionProduct(const double* const z, const T* const w, T* const zw) { zw[0] = z[0] * w[0] - z[1] * w[1] - z[2] * w[2] - z[3] * w[3]; zw[1] = z[0] * w[1] + z[1] * w[0] + z[2] * w[3] - z[3] * w[2]; zw[2] = z[0] * w[2] - z[1] * w[3] + z[2] * w[0] + z[3] * w[1]; zw[3] = z[0] * w[3] + z[1] * w[2] - z[2] * w[1] + z[3] * w[0]; } } // namespace common #endif // CARTOGRAPHER_COMMON_MATH_H_