Blame examples/bal_problem.cc

Packit ea1746
// Ceres Solver - A fast non-linear least squares minimizer
Packit ea1746
// Copyright 2015 Google Inc. All rights reserved.
Packit ea1746
// http://ceres-solver.org/
Packit ea1746
//
Packit ea1746
// Redistribution and use in source and binary forms, with or without
Packit ea1746
// modification, are permitted provided that the following conditions are met:
Packit ea1746
//
Packit ea1746
// * Redistributions of source code must retain the above copyright notice,
Packit ea1746
//   this list of conditions and the following disclaimer.
Packit ea1746
// * Redistributions in binary form must reproduce the above copyright notice,
Packit ea1746
//   this list of conditions and the following disclaimer in the documentation
Packit ea1746
//   and/or other materials provided with the distribution.
Packit ea1746
// * Neither the name of Google Inc. nor the names of its contributors may be
Packit ea1746
//   used to endorse or promote products derived from this software without
Packit ea1746
//   specific prior written permission.
Packit ea1746
//
Packit ea1746
// THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
Packit ea1746
// AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
Packit ea1746
// IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
Packit ea1746
// ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE
Packit ea1746
// LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
Packit ea1746
// CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
Packit ea1746
// SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
Packit ea1746
// INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
Packit ea1746
// CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
Packit ea1746
// ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
Packit ea1746
// POSSIBILITY OF SUCH DAMAGE.
Packit ea1746
//
Packit ea1746
// Author: sameeragarwal@google.com (Sameer Agarwal)
Packit ea1746
Packit ea1746
#include "bal_problem.h"
Packit ea1746
Packit ea1746
#include <cstdio>
Packit ea1746
#include <cstdlib>
Packit ea1746
#include <fstream>
Packit ea1746
#include <string>
Packit ea1746
#include <vector>
Packit ea1746
#include "Eigen/Core"
Packit ea1746
#include "ceres/rotation.h"
Packit ea1746
#include "glog/logging.h"
Packit ea1746
#include "random.h"
Packit ea1746
Packit ea1746
namespace ceres {
Packit ea1746
namespace examples {
Packit ea1746
namespace {
Packit ea1746
typedef Eigen::Map<Eigen::VectorXd> VectorRef;
Packit ea1746
typedef Eigen::Map<const Eigen::VectorXd> ConstVectorRef;
Packit ea1746
Packit ea1746
template<typename T>
Packit ea1746
void FscanfOrDie(FILE* fptr, const char* format, T* value) {
Packit ea1746
  int num_scanned = fscanf(fptr, format, value);
Packit ea1746
  if (num_scanned != 1) {
Packit ea1746
    LOG(FATAL) << "Invalid UW data file.";
Packit ea1746
  }
Packit ea1746
}
Packit ea1746
Packit ea1746
void PerturbPoint3(const double sigma, double* point) {
Packit ea1746
  for (int i = 0; i < 3; ++i) {
Packit ea1746
    point[i] += RandNormal() * sigma;
Packit ea1746
  }
Packit ea1746
}
Packit ea1746
Packit ea1746
double Median(std::vector<double>* data) {
Packit ea1746
  int n = data->size();
Packit ea1746
  std::vector<double>::iterator mid_point = data->begin() + n / 2;
Packit ea1746
  std::nth_element(data->begin(), mid_point, data->end());
Packit ea1746
  return *mid_point;
Packit ea1746
}
Packit ea1746
Packit ea1746
}  // namespace
Packit ea1746
Packit ea1746
BALProblem::BALProblem(const std::string& filename, bool use_quaternions) {
Packit ea1746
  FILE* fptr = fopen(filename.c_str(), "r");
Packit ea1746
Packit ea1746
  if (fptr == NULL) {
Packit ea1746
    LOG(FATAL) << "Error: unable to open file " << filename;
Packit ea1746
    return;
Packit ea1746
  };
Packit ea1746
Packit ea1746
  // This wil die horribly on invalid files. Them's the breaks.
Packit ea1746
  FscanfOrDie(fptr, "%d", &num_cameras_);
Packit ea1746
  FscanfOrDie(fptr, "%d", &num_points_);
Packit ea1746
  FscanfOrDie(fptr, "%d", &num_observations_);
Packit ea1746
Packit ea1746
  VLOG(1) << "Header: " << num_cameras_
Packit ea1746
          << " " << num_points_
Packit ea1746
          << " " << num_observations_;
Packit ea1746
Packit ea1746
  point_index_ = new int[num_observations_];
Packit ea1746
  camera_index_ = new int[num_observations_];
Packit ea1746
  observations_ = new double[2 * num_observations_];
Packit ea1746
Packit ea1746
  num_parameters_ = 9 * num_cameras_ + 3 * num_points_;
Packit ea1746
  parameters_ = new double[num_parameters_];
Packit ea1746
Packit ea1746
  for (int i = 0; i < num_observations_; ++i) {
Packit ea1746
    FscanfOrDie(fptr, "%d", camera_index_ + i);
Packit ea1746
    FscanfOrDie(fptr, "%d", point_index_ + i);
Packit ea1746
    for (int j = 0; j < 2; ++j) {
Packit ea1746
      FscanfOrDie(fptr, "%lf", observations_ + 2*i + j);
Packit ea1746
    }
Packit ea1746
  }
Packit ea1746
Packit ea1746
  for (int i = 0; i < num_parameters_; ++i) {
Packit ea1746
    FscanfOrDie(fptr, "%lf", parameters_ + i);
Packit ea1746
  }
Packit ea1746
Packit ea1746
  fclose(fptr);
Packit ea1746
Packit ea1746
  use_quaternions_ = use_quaternions;
Packit ea1746
  if (use_quaternions) {
Packit ea1746
    // Switch the angle-axis rotations to quaternions.
Packit ea1746
    num_parameters_ = 10 * num_cameras_ + 3 * num_points_;
Packit ea1746
    double* quaternion_parameters = new double[num_parameters_];
Packit ea1746
    double* original_cursor = parameters_;
Packit ea1746
    double* quaternion_cursor = quaternion_parameters;
Packit ea1746
    for (int i = 0; i < num_cameras_; ++i) {
Packit ea1746
      AngleAxisToQuaternion(original_cursor, quaternion_cursor);
Packit ea1746
      quaternion_cursor += 4;
Packit ea1746
      original_cursor += 3;
Packit ea1746
      for (int j = 4; j < 10; ++j) {
Packit ea1746
       *quaternion_cursor++ = *original_cursor++;
Packit ea1746
      }
Packit ea1746
    }
Packit ea1746
    // Copy the rest of the points.
Packit ea1746
    for (int i = 0; i < 3 * num_points_; ++i) {
Packit ea1746
      *quaternion_cursor++ = *original_cursor++;
Packit ea1746
    }
Packit ea1746
    // Swap in the quaternion parameters.
Packit ea1746
    delete []parameters_;
Packit ea1746
    parameters_ = quaternion_parameters;
Packit ea1746
  }
Packit ea1746
}
Packit ea1746
Packit ea1746
// This function writes the problem to a file in the same format that
Packit ea1746
// is read by the constructor.
Packit ea1746
void BALProblem::WriteToFile(const std::string& filename) const {
Packit ea1746
  FILE* fptr = fopen(filename.c_str(), "w");
Packit ea1746
Packit ea1746
  if (fptr == NULL) {
Packit ea1746
    LOG(FATAL) << "Error: unable to open file " << filename;
Packit ea1746
    return;
Packit ea1746
  };
Packit ea1746
Packit ea1746
  fprintf(fptr, "%d %d %d\n", num_cameras_, num_points_, num_observations_);
Packit ea1746
Packit ea1746
  for (int i = 0; i < num_observations_; ++i) {
Packit ea1746
    fprintf(fptr, "%d %d", camera_index_[i], point_index_[i]);
Packit ea1746
    for (int j = 0; j < 2; ++j) {
Packit ea1746
      fprintf(fptr, " %g", observations_[2 * i + j]);
Packit ea1746
    }
Packit ea1746
    fprintf(fptr, "\n");
Packit ea1746
  }
Packit ea1746
Packit ea1746
  for (int i = 0; i < num_cameras(); ++i) {
Packit ea1746
    double angleaxis[9];
Packit ea1746
    if (use_quaternions_) {
Packit ea1746
      // Output in angle-axis format.
Packit ea1746
      QuaternionToAngleAxis(parameters_ + 10 * i, angleaxis);
Packit ea1746
      memcpy(angleaxis + 3, parameters_ + 10 * i + 4, 6 * sizeof(double));
Packit ea1746
    } else {
Packit ea1746
      memcpy(angleaxis, parameters_ + 9 * i, 9 * sizeof(double));
Packit ea1746
    }
Packit ea1746
    for (int j = 0; j < 9; ++j) {
Packit ea1746
      fprintf(fptr, "%.16g\n", angleaxis[j]);
Packit ea1746
    }
Packit ea1746
  }
Packit ea1746
Packit ea1746
  const double* points = parameters_ + camera_block_size() * num_cameras_;
Packit ea1746
  for (int i = 0; i < num_points(); ++i) {
Packit ea1746
    const double* point = points + i * point_block_size();
Packit ea1746
    for (int j = 0; j < point_block_size(); ++j) {
Packit ea1746
      fprintf(fptr, "%.16g\n", point[j]);
Packit ea1746
    }
Packit ea1746
  }
Packit ea1746
Packit ea1746
  fclose(fptr);
Packit ea1746
}
Packit ea1746
Packit ea1746
// Write the problem to a PLY file for inspection in Meshlab or CloudCompare.
Packit ea1746
void BALProblem::WriteToPLYFile(const std::string& filename) const {
Packit ea1746
  std::ofstream of(filename.c_str());
Packit ea1746
Packit ea1746
  of << "ply"
Packit ea1746
     << '\n' << "format ascii 1.0"
Packit ea1746
     << '\n' << "element vertex " << num_cameras_ + num_points_
Packit ea1746
     << '\n' << "property float x"
Packit ea1746
     << '\n' << "property float y"
Packit ea1746
     << '\n' << "property float z"
Packit ea1746
     << '\n' << "property uchar red"
Packit ea1746
     << '\n' << "property uchar green"
Packit ea1746
     << '\n' << "property uchar blue"
Packit ea1746
     << '\n' << "end_header" << std::endl;
Packit ea1746
Packit ea1746
  // Export extrinsic data (i.e. camera centers) as green points.
Packit ea1746
  double angle_axis[3];
Packit ea1746
  double center[3];
Packit ea1746
  for (int i = 0; i < num_cameras(); ++i)  {
Packit ea1746
    const double* camera = cameras() + camera_block_size() * i;
Packit ea1746
    CameraToAngleAxisAndCenter(camera, angle_axis, center);
Packit ea1746
    of << center[0] << ' ' << center[1] << ' ' << center[2]
Packit ea1746
       << " 0 255 0" << '\n';
Packit ea1746
  }
Packit ea1746
Packit ea1746
  // Export the structure (i.e. 3D Points) as white points.
Packit ea1746
  const double* points = parameters_ + camera_block_size() * num_cameras_;
Packit ea1746
  for (int i = 0; i < num_points(); ++i) {
Packit ea1746
    const double* point = points + i * point_block_size();
Packit ea1746
    for (int j = 0; j < point_block_size(); ++j) {
Packit ea1746
      of << point[j] << ' ';
Packit ea1746
    }
Packit ea1746
    of << "255 255 255\n";
Packit ea1746
  }
Packit ea1746
  of.close();
Packit ea1746
}
Packit ea1746
Packit ea1746
void BALProblem::CameraToAngleAxisAndCenter(const double* camera,
Packit ea1746
                                            double* angle_axis,
Packit ea1746
                                            double* center) const {
Packit ea1746
  VectorRef angle_axis_ref(angle_axis, 3);
Packit ea1746
  if (use_quaternions_) {
Packit ea1746
    QuaternionToAngleAxis(camera, angle_axis);
Packit ea1746
  } else {
Packit ea1746
    angle_axis_ref = ConstVectorRef(camera, 3);
Packit ea1746
  }
Packit ea1746
Packit ea1746
  // c = -R't
Packit ea1746
  Eigen::VectorXd inverse_rotation = -angle_axis_ref;
Packit ea1746
  AngleAxisRotatePoint(inverse_rotation.data(),
Packit ea1746
                       camera + camera_block_size() - 6,
Packit ea1746
                       center);
Packit ea1746
  VectorRef(center, 3) *= -1.0;
Packit ea1746
}
Packit ea1746
Packit ea1746
void BALProblem::AngleAxisAndCenterToCamera(const double* angle_axis,
Packit ea1746
                                            const double* center,
Packit ea1746
                                            double* camera) const {
Packit ea1746
  ConstVectorRef angle_axis_ref(angle_axis, 3);
Packit ea1746
  if (use_quaternions_) {
Packit ea1746
    AngleAxisToQuaternion(angle_axis, camera);
Packit ea1746
  } else {
Packit ea1746
    VectorRef(camera, 3) = angle_axis_ref;
Packit ea1746
  }
Packit ea1746
Packit ea1746
  // t = -R * c
Packit ea1746
  AngleAxisRotatePoint(angle_axis,
Packit ea1746
                       center,
Packit ea1746
                       camera + camera_block_size() - 6);
Packit ea1746
  VectorRef(camera + camera_block_size() - 6, 3) *= -1.0;
Packit ea1746
}
Packit ea1746
Packit ea1746
Packit ea1746
void BALProblem::Normalize() {
Packit ea1746
  // Compute the marginal median of the geometry.
Packit ea1746
  std::vector<double> tmp(num_points_);
Packit ea1746
  Eigen::Vector3d median;
Packit ea1746
  double* points = mutable_points();
Packit ea1746
  for (int i = 0; i < 3; ++i) {
Packit ea1746
    for (int j = 0; j < num_points_; ++j) {
Packit ea1746
      tmp[j] = points[3 * j + i];
Packit ea1746
    }
Packit ea1746
    median(i) = Median(&tmp);
Packit ea1746
  }
Packit ea1746
Packit ea1746
  for (int i = 0; i < num_points_; ++i) {
Packit ea1746
    VectorRef point(points + 3 * i, 3);
Packit ea1746
    tmp[i] = (point - median).lpNorm<1>();
Packit ea1746
  }
Packit ea1746
Packit ea1746
  const double median_absolute_deviation = Median(&tmp);
Packit ea1746
Packit ea1746
  // Scale so that the median absolute deviation of the resulting
Packit ea1746
  // reconstruction is 100.
Packit ea1746
  const double scale = 100.0 / median_absolute_deviation;
Packit ea1746
Packit ea1746
  VLOG(2) << "median: " << median.transpose();
Packit ea1746
  VLOG(2) << "median absolute deviation: " << median_absolute_deviation;
Packit ea1746
  VLOG(2) << "scale: " << scale;
Packit ea1746
Packit ea1746
  // X = scale * (X - median)
Packit ea1746
  for (int i = 0; i < num_points_; ++i) {
Packit ea1746
    VectorRef point(points + 3 * i, 3);
Packit ea1746
    point = scale * (point - median);
Packit ea1746
  }
Packit ea1746
Packit ea1746
  double* cameras = mutable_cameras();
Packit ea1746
  double angle_axis[3];
Packit ea1746
  double center[3];
Packit ea1746
  for (int i = 0; i < num_cameras_; ++i) {
Packit ea1746
    double* camera = cameras + camera_block_size() * i;
Packit ea1746
    CameraToAngleAxisAndCenter(camera, angle_axis, center);
Packit ea1746
    // center = scale * (center - median)
Packit ea1746
    VectorRef(center, 3) = scale * (VectorRef(center, 3) - median);
Packit ea1746
    AngleAxisAndCenterToCamera(angle_axis, center, camera);
Packit ea1746
  }
Packit ea1746
}
Packit ea1746
Packit ea1746
void BALProblem::Perturb(const double rotation_sigma,
Packit ea1746
                         const double translation_sigma,
Packit ea1746
                         const double point_sigma) {
Packit ea1746
  CHECK_GE(point_sigma, 0.0);
Packit ea1746
  CHECK_GE(rotation_sigma, 0.0);
Packit ea1746
  CHECK_GE(translation_sigma, 0.0);
Packit ea1746
Packit ea1746
  double* points = mutable_points();
Packit ea1746
  if (point_sigma > 0) {
Packit ea1746
    for (int i = 0; i < num_points_; ++i) {
Packit ea1746
      PerturbPoint3(point_sigma, points + 3 * i);
Packit ea1746
    }
Packit ea1746
  }
Packit ea1746
Packit ea1746
  for (int i = 0; i < num_cameras_; ++i) {
Packit ea1746
    double* camera = mutable_cameras() + camera_block_size() * i;
Packit ea1746
Packit ea1746
    double angle_axis[3];
Packit ea1746
    double center[3];
Packit ea1746
    // Perturb in the rotation of the camera in the angle-axis
Packit ea1746
    // representation.
Packit ea1746
    CameraToAngleAxisAndCenter(camera, angle_axis, center);
Packit ea1746
    if (rotation_sigma > 0.0) {
Packit ea1746
      PerturbPoint3(rotation_sigma, angle_axis);
Packit ea1746
    }
Packit ea1746
    AngleAxisAndCenterToCamera(angle_axis, center, camera);
Packit ea1746
Packit ea1746
    if (translation_sigma > 0.0) {
Packit ea1746
      PerturbPoint3(translation_sigma, camera + camera_block_size() - 6);
Packit ea1746
    }
Packit ea1746
  }
Packit ea1746
}
Packit ea1746
Packit ea1746
BALProblem::~BALProblem() {
Packit ea1746
  delete []point_index_;
Packit ea1746
  delete []camera_index_;
Packit ea1746
  delete []observations_;
Packit ea1746
  delete []parameters_;
Packit ea1746
}
Packit ea1746
Packit ea1746
}  // namespace examples
Packit ea1746
}  // namespace ceres