// Ceres Solver - A fast non-linear least squares minimizer // Copyright 2010, 2011, 2012 Google Inc. All rights reserved. // http://code.google.com/p/ceres-solver/ // // Redistribution and use in source and binary forms, with or without // modification, are permitted provided that the following conditions are met: // // * Redistributions of source code must retain the above copyright notice, // this list of conditions and the following disclaimer. // * Redistributions in binary form must reproduce the above copyright notice, // this list of conditions and the following disclaimer in the documentation // and/or other materials provided with the distribution. // * Neither the name of Google Inc. nor the names of its contributors may be // used to endorse or promote products derived from this software without // specific prior written permission. // // THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" // AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE // IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE // ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE // LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR // CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF // SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS // INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN // CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) // ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE // POSSIBILITY OF SUCH DAMAGE. // // Author: keir@google.com (Keir Mierle) #include "ceres/parameter_block.h" #include "gtest/gtest.h" #include "ceres/internal/eigen.h" namespace ceres { namespace internal { TEST(ParameterBlock, SetLocalParameterization) { double x[3] = { 1.0, 2.0, 3.0 }; ParameterBlock parameter_block(x, 3, -1); // The indices to set constant within the parameter block (used later). vector<int> indices; indices.push_back(1); // Can't set the parameterization if the sizes don't match. SubsetParameterization subset_wrong_size(4, indices); EXPECT_DEATH_IF_SUPPORTED( parameter_block.SetParameterization(&subset_wrong_size), "global"); // Can't set parameterization to NULL from NULL. EXPECT_DEATH_IF_SUPPORTED (parameter_block.SetParameterization(NULL), "NULL"); // Now set the parameterization. SubsetParameterization subset(3, indices); parameter_block.SetParameterization(&subset); // Re-setting the parameterization to the same value is supported. parameter_block.SetParameterization(&subset); // Can't set parameterization to NULL from another parameterization. EXPECT_DEATH_IF_SUPPORTED(parameter_block.SetParameterization(NULL), "NULL"); // Can't set the parameterization more than once. SubsetParameterization subset_different(3, indices); EXPECT_DEATH_IF_SUPPORTED (parameter_block.SetParameterization(&subset_different), "re-set"); // Ensure the local parameterization jacobian result is correctly computed. ConstMatrixRef local_parameterization_jacobian( parameter_block.LocalParameterizationJacobian(), 3, 2); ASSERT_EQ(1.0, local_parameterization_jacobian(0, 0)); ASSERT_EQ(0.0, local_parameterization_jacobian(0, 1)); ASSERT_EQ(0.0, local_parameterization_jacobian(1, 0)); ASSERT_EQ(0.0, local_parameterization_jacobian(1, 1)); ASSERT_EQ(0.0, local_parameterization_jacobian(2, 0)); ASSERT_EQ(1.0, local_parameterization_jacobian(2, 1)); // Check that updating works as expected. double x_plus_delta[3]; double delta[2] = { 0.5, 0.3 }; parameter_block.Plus(x, delta, x_plus_delta); ASSERT_EQ(1.5, x_plus_delta[0]); ASSERT_EQ(2.0, x_plus_delta[1]); ASSERT_EQ(3.3, x_plus_delta[2]); } struct TestParameterization : public LocalParameterization { public: virtual ~TestParameterization() {} virtual bool Plus(const double* x, const double* delta, double* x_plus_delta) const { LOG(FATAL) << "Shouldn't get called."; return true; } virtual bool ComputeJacobian(const double* x, double* jacobian) const { jacobian[0] = *x * 2; return true; } virtual int GlobalSize() const { return 1; } virtual int LocalSize() const { return 1; } }; TEST(ParameterBlock, SetStateUpdatesLocalParameterizationJacobian) { TestParameterization test_parameterization; double x[1] = { 1.0 }; ParameterBlock parameter_block(x, 1, -1, &test_parameterization); EXPECT_EQ(2.0, *parameter_block.LocalParameterizationJacobian()); x[0] = 5.5; parameter_block.SetState(x); EXPECT_EQ(11.0, *parameter_block.LocalParameterizationJacobian()); } TEST(ParameterBlock, PlusWithNoLocalParameterization) { double x[2] = { 1.0, 2.0 }; ParameterBlock parameter_block(x, 2, -1); double delta[2] = { 0.2, 0.3 }; double x_plus_delta[2]; parameter_block.Plus(x, delta, x_plus_delta); EXPECT_EQ(1.2, x_plus_delta[0]); EXPECT_EQ(2.3, x_plus_delta[1]); } // Stops computing the jacobian after the first time. class BadLocalParameterization : public LocalParameterization { public: BadLocalParameterization() : calls_(0) { } virtual ~BadLocalParameterization() {} virtual bool Plus(const double* x, const double* delta, double* x_plus_delta) const { *x_plus_delta = *x + *delta; return true; } virtual bool ComputeJacobian(const double* x, double* jacobian) const { if (calls_ == 0) { jacobian[0] = 0; } ++calls_; return true; } virtual int GlobalSize() const { return 1;} virtual int LocalSize() const { return 1;} private: mutable int calls_; }; TEST(ParameterBlock, DetectBadLocalParameterization) { double x = 1; BadLocalParameterization bad_parameterization; ParameterBlock parameter_block(&x, 1, -1, &bad_parameterization); double y = 2; EXPECT_FALSE(parameter_block.SetState(&y)); } TEST(ParameterBlock, DefaultBounds) { double x[2]; ParameterBlock parameter_block(x, 2, -1, NULL); EXPECT_EQ(parameter_block.UpperBoundForParameter(0), std::numeric_limits<double>::max()); EXPECT_EQ(parameter_block.UpperBoundForParameter(1), std::numeric_limits<double>::max()); EXPECT_EQ(parameter_block.LowerBoundForParameter(0), -std::numeric_limits<double>::max()); EXPECT_EQ(parameter_block.LowerBoundForParameter(1), -std::numeric_limits<double>::max()); } TEST(ParameterBlock, SetBounds) { double x[2]; ParameterBlock parameter_block(x, 2, -1, NULL); parameter_block.SetLowerBound(0, 1); parameter_block.SetUpperBound(1, 1); EXPECT_EQ(parameter_block.LowerBoundForParameter(0), 1.0); EXPECT_EQ(parameter_block.LowerBoundForParameter(1), -std::numeric_limits<double>::max()); EXPECT_EQ(parameter_block.UpperBoundForParameter(0), std::numeric_limits<double>::max()); EXPECT_EQ(parameter_block.UpperBoundForParameter(1), 1.0); } TEST(ParameterBlock, PlusWithBoundsConstraints) { double x[] = {1.0, 0.0}; double delta[] = {2.0, -10.0}; ParameterBlock parameter_block(x, 2, -1, NULL); parameter_block.SetUpperBound(0, 2.0); parameter_block.SetLowerBound(1, -1.0); double x_plus_delta[2]; parameter_block.Plus(x, delta, x_plus_delta); EXPECT_EQ(x_plus_delta[0], 2.0); EXPECT_EQ(x_plus_delta[1], -1.0); } } // namespace internal } // namespace ceres