OpenGV
A library for solving calibrated central and non-central geometric vision problems
AbsoluteMultiAdapterBase.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_ABSOLUTE_POSE_ABSOLUTEMULTIADAPTERBASE_HPP_
40 #define OPENGV_ABSOLUTE_POSE_ABSOLUTEMULTIADAPTERBASE_HPP_
41 
42 #include <stdlib.h>
43 #include <vector>
44 #include <opengv/types.hpp>
46 
50 namespace opengv
51 {
55 namespace absolute_pose
56 {
57 
67 {
68 protected:
71 public:
72  EIGEN_MAKE_ALIGNED_OPERATOR_NEW
73 
85  AbsoluteAdapterBase(R) {};
94  const opengv::translation_t & t,
95  const opengv::rotation_t & R ) :
96  AbsoluteAdapterBase(t,R) {};
101 
102  //camera-wise access of correspondences
103 
111  size_t frameIndex, size_t correspondenceIndex ) const = 0;
120  virtual double getWeight(
121  size_t frameIndex, size_t correspondenceIndex ) const = 0;
128  virtual opengv::translation_t getMultiCamOffset( size_t frameIndex ) const = 0;
135  virtual opengv::rotation_t getMultiCamRotation( size_t frameIndex ) const = 0;
142  virtual opengv::point_t getPoint(
143  size_t frameIndex, size_t correspondenceIndex ) const = 0;
149  virtual size_t getNumberCorrespondences( size_t frameIndex ) const = 0;
154  virtual size_t getNumberFrames() const = 0;
155 
156  //Conversion to and from serialized indices
157 
165  virtual std::vector<int> convertMultiIndices(
166  const std::vector<std::vector<int> > & multiIndices ) const = 0;
175  virtual int convertMultiIndex(
176  size_t frameIndex, size_t correspondenceIndex ) const = 0;
182  virtual int multiFrameIndex( size_t index ) const = 0;
188  virtual int multiCorrespondenceIndex( size_t index ) const = 0;
189 
190  //the classic interface (with serialized indices, used by the opengv-methods)
191 
193  virtual bearingVector_t getBearingVector( size_t index ) const
194  {
195  return getBearingVector(
196  multiFrameIndex(index), multiCorrespondenceIndex(index) );
197  }
199  virtual double getWeight( size_t index ) const
200  {
201  return getWeight(
202  multiFrameIndex(index), multiCorrespondenceIndex(index) );
203  }
205  virtual translation_t getCamOffset( size_t index ) const
206  { return getMultiCamOffset( multiFrameIndex(index) ); }
208  virtual rotation_t getCamRotation( size_t index ) const
209  { return getMultiCamRotation( multiFrameIndex(index) ); }
211  virtual point_t getPoint( size_t index ) const
212  {
213  return getPoint(
214  multiFrameIndex(index), multiCorrespondenceIndex(index) );
215  }
217  virtual size_t getNumberCorrespondences() const
218  {
219  size_t numberCorrespondences = 0;
220  for(size_t i = 0; i < getNumberFrames(); i++)
221  numberCorrespondences += getNumberCorrespondences(i);
222  return numberCorrespondences;
223  }
224 };
225 
226 }
227 };
228 
229 #endif /* OPENGV_ABSOLUTE_POSE_ABSOLUTEMULTIADAPTERBASE_HPP_ */
opengv::translation_t _t
Definition: AbsoluteAdapterBase.hpp:164
virtual int convertMultiIndex(size_t frameIndex, size_t correspondenceIndex) const =0
Convert a (frameIndex,correspondenceIndex)-pair into a serialized index.
virtual double getWeight(size_t frameIndex, size_t correspondenceIndex) const =0
Retrieve the weight of a correspondence. The weight is supposed to reflect the quality of a correspon...
virtual size_t getNumberFrames() const =0
Retrieve the number of cameras.
virtual opengv::rotation_t getMultiCamRotation(size_t frameIndex) const =0
Retrieve the rotation from a camera to the viewpoint frame.
EIGEN_MAKE_ALIGNED_OPERATOR_NEW AbsoluteMultiAdapterBase()
Constructor.
Definition: AbsoluteMultiAdapterBase.hpp:77
The namespace of this library.
Definition: AbsoluteAdapterBase.hpp:47
virtual opengv::bearingVector_t getBearingVector(size_t frameIndex, size_t correspondenceIndex) const =0
Retrieve the bearing vector of a correspondence in a certain frame.
virtual double getWeight(size_t index) const
Definition: AbsoluteMultiAdapterBase.hpp:199
Adapter-class for passing bearing-vector-to-point correspondences to the absolute-pose algorithms...
opengv::rotation_t _R
Definition: AbsoluteAdapterBase.hpp:174
virtual int multiFrameIndex(size_t index) const =0
Get the frame-index corresponding to a serialized index.
Eigen::Vector3d translation_t
Definition: types.hpp:63
A collection of variables used in geometric vision for the computation of calibrated absolute and rel...
Definition: AbsoluteMultiAdapterBase.hpp:66
virtual bearingVector_t getBearingVector(size_t index) const
Definition: AbsoluteMultiAdapterBase.hpp:193
Eigen::Matrix3d rotation_t
Definition: types.hpp:71
virtual size_t getNumberCorrespondences() const
Definition: AbsoluteMultiAdapterBase.hpp:217
virtual translation_t getCamOffset(size_t index) const
Definition: AbsoluteMultiAdapterBase.hpp:205
virtual opengv::point_t getPoint(size_t frameIndex, size_t correspondenceIndex) const =0
Retrieve the world point of a correspondence.
Eigen::Vector3d bearingVector_t
Definition: types.hpp:55
virtual point_t getPoint(size_t index) const
Definition: AbsoluteMultiAdapterBase.hpp:211
virtual int multiCorrespondenceIndex(size_t index) const =0
Get the correspondence-index in a camera for a serialized index.
virtual rotation_t getCamRotation(size_t index) const
Definition: AbsoluteMultiAdapterBase.hpp:208
virtual ~AbsoluteMultiAdapterBase()
Destructor.
Definition: AbsoluteMultiAdapterBase.hpp:100
virtual opengv::translation_t getMultiCamOffset(size_t frameIndex) const =0
Retrieve the position of a camera seen from the viewpoint origin.
Eigen::Vector3d point_t
Definition: types.hpp:123
AbsoluteMultiAdapterBase(const opengv::rotation_t &R)
Constructor.
Definition: AbsoluteMultiAdapterBase.hpp:84
AbsoluteMultiAdapterBase(const opengv::translation_t &t, const opengv::rotation_t &R)
Constructor.
Definition: AbsoluteMultiAdapterBase.hpp:93
virtual std::vector< int > convertMultiIndices(const std::vector< std::vector< int > > &multiIndices) const =0
Convert an array of (frameIndex,correspondenceIndex)-pairs into an array of serialized indices...
Definition: AbsoluteAdapterBase.hpp:63