OpenGV
A library for solving calibrated central and non-central geometric vision problems
RelativeMultiAdapterBase.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_RELATIVE_POSE_RELATIVEMULTIADAPTERBASE_HPP_
40 #define OPENGV_RELATIVE_POSE_RELATIVEMULTIADAPTERBASE_HPP_
41 
42 #include <stdlib.h>
43 #include <vector>
44 #include <opengv/types.hpp>
46 
50 namespace opengv
51 {
55 namespace relative_pose
56 {
57 
68 {
69 protected:
72 
73 public:
74  EIGEN_MAKE_ALIGNED_OPERATOR_NEW
75 
81  RelativeAdapterBase( R12 ) {};
83  RelativeMultiAdapterBase( const translation_t & t12, const rotation_t & R12 ) :
84  RelativeAdapterBase( t12, R12 ) {};
87 
88  //camera-pair-wise access of correspondences
89 
97  size_t pairIndex, size_t correspondenceIndex ) const = 0;
105  size_t pairIndex, size_t correspondenceIndex ) const = 0;
114  virtual double getWeight(
115  size_t pairIndex, size_t correspondenceIndex ) const = 0;
123  virtual translation_t getCamOffset( size_t pairIndex ) const = 0;
131  virtual rotation_t getCamRotation( size_t pairIndex ) const = 0;
137  virtual size_t getNumberCorrespondences( size_t pairIndex ) const = 0;
142  virtual size_t getNumberPairs() const = 0;
143 
144  //Conversion to and from serialized indices
145 
153  virtual std::vector<int> convertMultiIndices(
154  const std::vector<std::vector<int> > & multiIndices ) const = 0;
162  virtual int convertMultiIndex(
163  size_t pairIndex, size_t correspondenceIndex ) const = 0;
169  virtual int multiPairIndex( size_t index ) const = 0;
175  virtual int multiCorrespondenceIndex( size_t index ) const = 0;
176 
177  //the classic interface (with serialized indices, used by the opengv-methods)
178 
180  virtual bearingVector_t getBearingVector1( size_t index ) const
181  {
182  return getBearingVector1(
183  multiPairIndex(index), multiCorrespondenceIndex(index) );
184  }
186  virtual bearingVector_t getBearingVector2( size_t index ) const
187  {
188  return getBearingVector2(
189  multiPairIndex(index), multiCorrespondenceIndex(index) );
190  }
192  virtual double getWeight( size_t index ) const
193  {
194  return getWeight(
195  multiPairIndex(index), multiCorrespondenceIndex(index) );
196  }
198  virtual translation_t getCamOffset1( size_t index ) const
199  { return getCamOffset( multiPairIndex(index) ); }
201  virtual rotation_t getCamRotation1( size_t index ) const
202  { return getCamRotation( multiPairIndex(index) ); }
204  virtual translation_t getCamOffset2( size_t index ) const
205  { return getCamOffset( multiPairIndex(index) ); }
207  virtual rotation_t getCamRotation2( size_t index ) const
208  { return getCamRotation( multiPairIndex(index) ); }
210  virtual size_t getNumberCorrespondences() const
211  {
212  size_t numberCorrespondences = 0;
213  for(size_t i = 0; i < getNumberPairs(); i++)
214  numberCorrespondences += getNumberCorrespondences(i);
215  return numberCorrespondences;
216  }
217 };
218 
219 }
220 }
221 
222 #endif /* OPENGV_RELATIVE_POSE_RELATIVEMULTIADAPTERBASE_HPP_ */
virtual rotation_t getCamRotation2(size_t index) const
Definition: RelativeMultiAdapterBase.hpp:207
virtual int convertMultiIndex(size_t pairIndex, size_t correspondenceIndex) const =0
Convert a (pairIndex,correspondenceIndex)-pair into a serialized index.
virtual bearingVector_t getBearingVector2(size_t index) const
Definition: RelativeMultiAdapterBase.hpp:186
The namespace of this library.
Definition: AbsoluteAdapterBase.hpp:47
virtual int multiPairIndex(size_t index) const =0
Get the camera-pair-index corresponding to a serialized index.
RelativeMultiAdapterBase(const rotation_t &R12)
Definition: RelativeMultiAdapterBase.hpp:80
Adapter-class for passing bearing-vector correspondences to the relative-pose algorithms.
virtual std::vector< int > convertMultiIndices(const std::vector< std::vector< int > > &multiIndices) const =0
Convert an array of (pairIndex,correspondenceIndex)-pairs into an array of serialized indices...
virtual bearingVector_t getBearingVector1(size_t pairIndex, size_t correspondenceIndex) const =0
Retrieve the bearing vector of a correspondence in camera 1 of a pair.
opengv::rotation_t _R12
Definition: RelativeAdapterBase.hpp:188
Eigen::Vector3d translation_t
Definition: types.hpp:63
A collection of variables used in geometric vision for the computation of calibrated absolute and rel...
Eigen::Matrix3d rotation_t
Definition: types.hpp:71
virtual int multiCorrespondenceIndex(size_t index) const =0
Get the keypoint-index in a camera-pair for a serialized index.
opengv::translation_t _t12
Definition: RelativeAdapterBase.hpp:178
Definition: RelativeAdapterBase.hpp:63
virtual translation_t getCamOffset(size_t pairIndex) const =0
Retrieve the position of the cameras of a camera-pair seen from the origin of the viewpoints (assumed...
virtual bearingVector_t getBearingVector2(size_t pairIndex, size_t correspondenceIndex) const =0
Retrieve the bearing vector of a correspondence in camera 2 of a pair.
virtual ~RelativeMultiAdapterBase()
Definition: RelativeMultiAdapterBase.hpp:86
virtual size_t getNumberPairs() const =0
Retrieve the number of camera-pairs.
virtual bearingVector_t getBearingVector1(size_t index) const
Definition: RelativeMultiAdapterBase.hpp:180
Eigen::Vector3d bearingVector_t
Definition: types.hpp:55
RelativeMultiAdapterBase(const translation_t &t12, const rotation_t &R12)
Definition: RelativeMultiAdapterBase.hpp:83
virtual rotation_t getCamRotation1(size_t index) const
Definition: RelativeMultiAdapterBase.hpp:201
virtual double getWeight(size_t index) const
Definition: RelativeMultiAdapterBase.hpp:192
virtual translation_t getCamOffset2(size_t index) const
Definition: RelativeMultiAdapterBase.hpp:204
virtual translation_t getCamOffset1(size_t index) const
Definition: RelativeMultiAdapterBase.hpp:198
virtual double getWeight(size_t pairIndex, size_t correspondenceIndex) const =0
Retrieve the weight of a correspondence. The weight is supposed to reflect the quality of a correspon...
EIGEN_MAKE_ALIGNED_OPERATOR_NEW RelativeMultiAdapterBase()
Definition: RelativeMultiAdapterBase.hpp:77
virtual size_t getNumberCorrespondences() const
Definition: RelativeMultiAdapterBase.hpp:210
virtual rotation_t getCamRotation(size_t pairIndex) const =0
Retrieve the rotation from the cameras of a camera-pair back to the origin of the viewpoints (assumed...
Definition: RelativeMultiAdapterBase.hpp:67