vpgl_ba_fixed_k_lsqr.h

Go to the documentation of this file.

// This is vpgl/algo/vpgl_ba_fixed_k_lsqr.h
#ifndef vpgl_ba_fixed_k_lsqr_h_
#define vpgl_ba_fixed_k_lsqr_h_
//:
// \file
// \brief Bundle adjustment sparse least squares class for fixed intrinsics
// \author Matt Leotta
// \date April 18, 2005
// \verbatim
//  Modifications
//   Mar 23, 2010  MJL - Split off base class and moved to its own file
// \endverbatim

#include <vpgl/algo/vpgl_bundle_adjust_lsqr.h>


//: a class for bundle adjustment with fixed intrinsic parameters
class vpgl_ba_fixed_k_lsqr : public vpgl_bundle_adjust_lsqr
{
 public:
  //: Constructor
  // \note image points are not homogeneous because they require finite points
  //       to measure projection error
  vpgl_ba_fixed_k_lsqr(std::vector<vpgl_calibration_matrix<double> >  K,
                       const std::vector<vgl_point_2d<double> >& image_points,
                       const std::vector<std::vector<bool> >& mask);

  //: Constructor
  //  Each image point is assigned an inverse covariance (error projector) matrix
  // \note image points are not homogeneous because they require finite points
  //       to measure projection error
  vpgl_ba_fixed_k_lsqr(std::vector<vpgl_calibration_matrix<double> >  K,
                       const std::vector<vgl_point_2d<double> >& image_points,
                       const std::vector<vnl_matrix<double> >& inv_covars,
                       const std::vector<std::vector<bool> >& mask);

  // Destructor
  ~vpgl_ba_fixed_k_lsqr() override = default;


  //: compute the Jacobian Aij
  void jac_Aij(unsigned int i,
                       unsigned int j,
                       vnl_double_3x4 const& Pi,
                       vnl_vector<double> const& ai,
                       vnl_vector<double> const& bj,
                       vnl_vector<double> const& c,
                       vnl_matrix<double>& Aij) override;

  //: compute the Jacobian Bij
  void jac_Bij(unsigned int i,
                       unsigned int j,
                       vnl_double_3x4 const& Pi,
                       vnl_vector<double> const& ai,
                       vnl_vector<double> const& bj,
                       vnl_vector<double> const& c,
                       vnl_matrix<double>& Bij) override;

  //: compute the Jacobian Cij
  void jac_Cij(unsigned int i,
                       unsigned int j,
                       vnl_double_3x4 const& Pi,
                       vnl_vector<double> const& ai,
                       vnl_vector<double> const& bj,
                       vnl_vector<double> const& c,
                       vnl_matrix<double>& Cij) override;


  //: construct the \param j-th perspective camera from a pointer to the j-th parameters of \param b and parameters \param c
  vgl_homg_point_3d<double>
  param_to_point(int j,
                 const double* bj,
                 const vnl_vector<double>& c) const override;

  //: construct the \param j-th perspective camera from a pointer to the j-th parameters of \param b and parameters \param c
  vnl_vector_fixed<double,4>
  param_to_pt_vector(int j,
                     const double* bj,
                     const vnl_vector<double>& c) const override;

  //: construct the \param i-th perspective camera from a pointer to the i-th parameters of \param a and parameters \param c
  vpgl_perspective_camera<double>
  param_to_cam(int i,
               const double* ai,
               const vnl_vector<double>& c) const override;

  //: compute a 3x4 camera matrix of camera \param i from a pointer to the i-th parameters of \param a and parameters \param c
  vnl_double_3x4
  param_to_cam_matrix(int i,
                      const double* ai,
                      const vnl_vector<double>& c) const override;


  //: Create the parameter vector \p a from a vector of cameras
  static vnl_vector<double>
  create_param_vector(const std::vector<vpgl_perspective_camera<double> >& cameras);

  //: Create the parameter vector \p b from a vector of 3D points
  static vnl_vector<double>
  create_param_vector(const std::vector<vgl_point_3d<double> >& world_points);


 protected:
  //: The fixed internal camera calibration
  std::vector<vpgl_calibration_matrix<double> > K_;
  //: The fixed internal camera calibration in matrix form
  std::vector<vnl_double_3x3> Km_;
};


#endif // vpgl_ba_fixed_k_lsqr_h_