vgl_h_matrix_2d_compute_linear.h

Go to the documentation of this file.

#ifndef vgl_h_matrix_2d_compute_linear_h_
#define vgl_h_matrix_2d_compute_linear_h_
//:
// \file
// \brief contains class vgl_h_matrix_2d_compute_linear
//
// vgl_h_matrix_2d_compute_linear contains a linear method to calculate
// the plane projectivity which relates four 2D point (or plane)
// correspondences.
// The returned $H$ is such that
// $H  [p_1  p_2  p_3  p_4 ] \sim [p'_1  p'_2  p'_3  p'_4 ]$
// where the $p_i$ are the homogeneous points in the first view, and the
// $p'_i$ their images.
//
// \verbatim
//  Modifications
//   200598 FSM added checks for degenerate or coincident points.
//   230603 Peter Vanroose - made compute_pl() etc. pure virtual
//   240603 Peter Vanroose - added rough first implementation for compute_pl()
// \endverbatim

#include <vgl/algo/vgl_h_matrix_2d_compute.h>

class vgl_h_matrix_2d_compute_linear : public vgl_h_matrix_2d_compute
{
  bool allow_ideal_points_;
 protected:
  //: compute from matched points

  bool compute_p(std::vector<vgl_homg_point_2d<double> > const& points1,
                 std::vector<vgl_homg_point_2d<double> > const& points2,
                 vgl_h_matrix_2d<double>& H) override;

  //:compute from matched lines

  bool compute_l(std::vector<vgl_homg_line_2d<double> > const& lines1,
                 std::vector<vgl_homg_line_2d<double> > const& lines2,
                 vgl_h_matrix_2d<double>& H) override;

  //:compute from matched lines with weight vector

  bool compute_l(std::vector<vgl_homg_line_2d<double> > const& lines1,
                 std::vector<vgl_homg_line_2d<double> > const& lines2,
                 std::vector<double> const& weights,
                 vgl_h_matrix_2d<double>& H) override;

  //:compute from matched points and lines

  bool compute_pl(std::vector<vgl_homg_point_2d<double> > const& points1,
                  std::vector<vgl_homg_point_2d<double> > const& points2,
                  std::vector<vgl_homg_line_2d<double> > const& lines1,
                  std::vector<vgl_homg_line_2d<double> > const& lines2,
                  vgl_h_matrix_2d<double>& H) override;

  //:Assumes all corresponding points have equal weight
  bool solve_linear_problem(int equ_count,
                            std::vector<vgl_homg_point_2d<double> > const& p1,
                            std::vector<vgl_homg_point_2d<double> > const& p2,
                            vgl_h_matrix_2d<double>& H);

  //: for lines, the solution should be weighted by line length
  bool
  solve_weighted_least_squares(std::vector<vgl_homg_line_2d<double> > const& l1,
                               std::vector<vgl_homg_line_2d<double> > const& l2,
                               std::vector<double> const& w,
                               vgl_h_matrix_2d<double>& H);

 public:
  vgl_h_matrix_2d_compute_linear(bool allow_ideal_points = false);
  int minimum_number_of_correspondences() const override { return 4; }
};

#endif // vgl_h_matrix_2d_compute_linear_h_