OpenGV
A library for solving calibrated central and non-central geometric vision problems
AbsolutePoseSacProblem.hpp
Go to the documentation of this file.
1 /******************************************************************************
2  * Author: Laurent Kneip *
3  * Contact: kneip.laurent@gmail.com *
4  * License: Copyright (c) 2013 Laurent Kneip, ANU. All rights reserved. *
5  * *
6  * Redistribution and use in source and binary forms, with or without *
7  * modification, are permitted provided that the following conditions *
8  * are met: *
9  * * Redistributions of source code must retain the above copyright *
10  * notice, this list of conditions and the following disclaimer. *
11  * * Redistributions in binary form must reproduce the above copyright *
12  * notice, this list of conditions and the following disclaimer in the *
13  * documentation and/or other materials provided with the distribution. *
14  * * Neither the name of ANU nor the names of its contributors may be *
15  * used to endorse or promote products derived from this software without *
16  * specific prior written permission. *
17  * *
18  * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"*
19  * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE *
20  * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE *
21  * ARE DISCLAIMED. IN NO EVENT SHALL ANU OR THE CONTRIBUTORS BE LIABLE *
22  * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL *
23  * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR *
24  * SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER *
25  * CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT *
26  * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY *
27  * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF *
28  * SUCH DAMAGE. *
29  ******************************************************************************/
30 
39 #ifndef OPENGV_SAC_PROBLEMS_ABSOLUTE_POSE_ABSOLUTEPOSESACPROBLEM_HPP_
40 #define OPENGV_SAC_PROBLEMS_ABSOLUTE_POSE_ABSOLUTEPOSESACPROBLEM_HPP_
41 
43 #include <opengv/types.hpp>
45 
49 namespace opengv
50 {
54 namespace sac_problems
55 {
59 namespace absolute_pose
60 {
61 
69  public sac::SampleConsensusProblem<transformation_t>
70 {
71 public:
76 
78  typedef enum Algorithm
79  {
80  TWOPT = 0, // central, with rotation prior
81  KNEIP = 1, // central [1]
82  GAO = 2, // central [2]
83  EPNP = 3, // central [4]
84  GP3P = 4 // non-central [3]
85  } algorithm_t;
86 
94  AbsolutePoseSacProblem(adapter_t & adapter, algorithm_t algorithm,
95  bool randomSeed = true) :
96  sac::SampleConsensusProblem<model_t> (randomSeed),
97  _adapter(adapter),
98  _algorithm(algorithm)
99  {
101  };
102 
113  adapter_t & adapter,
114  algorithm_t algorithm,
115  const std::vector<int> & indices,
116  bool randomSeed = true) :
117  sac::SampleConsensusProblem<model_t> (randomSeed),
118  _adapter(adapter),
119  _algorithm(algorithm)
120  {
121  setIndices(indices);
122  };
123 
128 
132  virtual bool computeModelCoefficients(
133  const std::vector<int> & indices,
134  model_t & outModel) const;
135 
139  virtual void getSelectedDistancesToModel(
140  const model_t & model,
141  const std::vector<int> & indices,
142  std::vector<double> & scores) const;
143 
147  virtual void optimizeModelCoefficients(
148  const std::vector<int> & inliers,
149  const model_t & model,
150  model_t & optimized_model);
151 
155  virtual int getSampleSize() const;
156 
157 protected:
159  adapter_t & _adapter;
162 };
163 
164 }
165 }
166 }
167 
168 #endif //#ifndef OPENGV_SAC_PROBLEMS_ABSOLUTE_POSE_ABSOLUTEPOSESACPROBLEM_HPP_
Algorithm
Definition: AbsolutePoseSacProblem.hpp:78
Definition: AbsolutePoseSacProblem.hpp:68
algorithm_t _algorithm
Definition: AbsolutePoseSacProblem.hpp:161
Eigen::Matrix< double, 3, 4 > transformation_t
Definition: types.hpp:82
The namespace of this library.
Definition: AbsoluteAdapterBase.hpp:47
transformation_t model_t
Definition: AbsolutePoseSacProblem.hpp:73
Adapter-class for passing bearing-vector-to-point correspondences to the absolute-pose algorithms...
void setIndices(const std::vector< int > &indices)
Set the indices_ variable (see member-description).
SampleConsensusProblem(bool randomSeed=true)
Contructor.
virtual void optimizeModelCoefficients(const std::vector< int > &inliers, const model_t &model, model_t &optimized_model)
See parent-class.
Basis-class for Sample-consensus problems. Contains declarations for the three basic functions of a s...
opengv::absolute_pose::AbsoluteAdapterBase adapter_t
Definition: AbsolutePoseSacProblem.hpp:75
A collection of variables used in geometric vision for the computation of calibrated absolute and rel...
enum opengv::sac_problems::absolute_pose::AbsolutePoseSacProblem::Algorithm algorithm_t
virtual int getSampleSize() const
See parent-class.
AbsolutePoseSacProblem(adapter_t &adapter, algorithm_t algorithm, bool randomSeed=true)
Constructor.
Definition: AbsolutePoseSacProblem.hpp:94
Definition: SampleConsensusProblem.hpp:67
virtual void getSelectedDistancesToModel(const model_t &model, const std::vector< int > &indices, std::vector< double > &scores) const
See parent-class.
virtual size_t getNumberCorrespondences() const =0
Retrieve the number of correspondences.
AbsolutePoseSacProblem(adapter_t &adapter, algorithm_t algorithm, const std::vector< int > &indices, bool randomSeed=true)
Constructor.
Definition: AbsolutePoseSacProblem.hpp:112
virtual ~AbsolutePoseSacProblem()
Definition: AbsolutePoseSacProblem.hpp:127
void setUniformIndices(int N)
Use this method if you want to use all samples.
adapter_t & _adapter
Definition: AbsolutePoseSacProblem.hpp:159
virtual bool computeModelCoefficients(const std::vector< int > &indices, model_t &outModel) const
See parent-class.
Definition: AbsoluteAdapterBase.hpp:63