base_edge.h

Go to the documentation of this file.

// g2o - General Graph Optimization
// Copyright (C) 2011 R. Kuemmerle, G. Grisetti, H. Strasdat, W. Burgard
// All rights reserved.
//
// Redistribution and use in source and binary forms, with or without
// modification, are permitted provided that the following conditions are
// met:
//
// * Redistributions of source code must retain the above copyright notice,
//   this list of conditions and the following disclaimer.
// * Redistributions in binary form must reproduce the above copyright
//   notice, this list of conditions and the following disclaimer in the
//   documentation and/or other materials provided with the distribution.
//
// THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS
// IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
// TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A
// PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
// HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
// SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED
// TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR
// PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
// LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
// NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
// SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
 
#ifndef G2O_BASE_EDGE_H
#define G2O_BASE_EDGE_H
 
#include <Eigen/Core>
#include <iostream>
#include <limits>
#include <type_traits>
 
#include "g2o/stuff/logger.h"
#include "optimizable_graph.h"
 
namespace g2o {
 
namespace internal {
 
#ifdef G2O_OPENMP
struct QuadraticFormLock {
  explicit QuadraticFormLock(OptimizableGraph::Vertex& vertex)
      : _vertex(vertex) {
    _vertex.lockQuadraticForm();
  }
  ~QuadraticFormLock() { _vertex.unlockQuadraticForm(); }
 
 private:
  OptimizableGraph::Vertex& _vertex;
};
#else
struct QuadraticFormLock {
  explicit QuadraticFormLock(OptimizableGraph::Vertex&) {}
  ~QuadraticFormLock() {}
};
#endif
 
template <int D>
struct BaseEdgeTraits {
  static constexpr int Dimension = D;
  typedef Eigen::Matrix<double, D, 1, Eigen::ColMajor> ErrorVector;
  typedef Eigen::Matrix<double, D, D, Eigen::ColMajor> InformationType;
};
template <>
struct BaseEdgeTraits<-1> {
  static constexpr int Dimension = -1;
  typedef Eigen::Matrix<double, Eigen::Dynamic, 1, Eigen::ColMajor> ErrorVector;
  typedef Eigen::Matrix<double, Eigen::Dynamic, Eigen::Dynamic, Eigen::ColMajor>
      InformationType;
};
 
}  // namespace internal
 
template <int D, typename E>
class BaseEdge : public OptimizableGraph::Edge {
 public:
  static constexpr int Dimension = internal::BaseEdgeTraits<D>::Dimension;
  typedef E Measurement;
  typedef typename internal::BaseEdgeTraits<D>::ErrorVector ErrorVector;
  typedef typename internal::BaseEdgeTraits<D>::InformationType InformationType;
 
  BaseEdge() : OptimizableGraph::Edge() { _dimension = D; }
  BaseEdge& operator=(const BaseEdge&) = delete;
  BaseEdge(const BaseEdge&) = delete;
 
  virtual ~BaseEdge() {}
 
  virtual double chi2() const { return _error.dot(information() * _error); }
 
  virtual const double* errorData() const { return _error.data(); }
  virtual double* errorData() { return _error.data(); }
  const ErrorVector& error() const { return _error; }
  ErrorVector& error() { return _error; }
 
  EIGEN_STRONG_INLINE const InformationType& information() const {
    return _information;
  }
  EIGEN_STRONG_INLINE InformationType& information() { return _information; }
  void setInformation(const InformationType& information) {
    _information = information;
  }
 
  virtual const double* informationData() const { return _information.data(); }
  virtual double* informationData() { return _information.data(); }
 
  EIGEN_STRONG_INLINE const Measurement& measurement() const {
    return _measurement;
  }
  virtual void setMeasurement(const Measurement& m) { _measurement = m; }
 
  virtual int rank() const { return _dimension; }
 
  virtual void initialEstimate(const OptimizableGraph::VertexSet&,
                               OptimizableGraph::Vertex*) {
    G2O_WARN(
        "inititialEstimate() is not implemented, please give implementation in "
        "your derived class");
  }
 
  template <int Dim = D>
  typename std::enable_if<Dim == -1, void>::type setDimension(int dim) {
    _dimension = dim;
    _information.resize(dim, dim);
    _error.resize(dim, 1);
  }
 
 protected:
  Measurement _measurement;      
  InformationType _information;  
  ErrorVector _error;  
 
  InformationType robustInformation(const Vector3& rho) const {
    InformationType result = rho[1] * _information;
    // ErrorVector weightedError = _information * _error;
    // result.noalias() += 2 * rho[2] * (weightedError *
    // weightedError.transpose());
    return result;
  }
 
  bool writeInformationMatrix(std::ostream& os) const {
    for (int i = 0; i < information().rows(); ++i)
      for (int j = i; j < information().cols(); ++j)
        os << information()(i, j) << " ";
    return os.good();
  }
  bool readInformationMatrix(std::istream& is) {
    for (int i = 0; i < information().rows() && is.good(); ++i)
      for (int j = i; j < information().cols() && is.good(); ++j) {
        is >> information()(i, j);
        if (i != j) information()(j, i) = information()(i, j);
      }
    return is.good() || is.eof();
  }
  bool writeParamIds(std::ostream& os) const {
    for (auto id : _parameterIds) os << id << " ";
    return os.good();
  }
  bool readParamIds(std::istream& is) {
    for (size_t i = 0; i < numParameters(); ++i) {
      int paramId;
      is >> paramId;
      setParameterId(i, paramId);
    }
    return is.good() || is.eof();
  }
 
 public:
  EIGEN_MAKE_ALIGNED_OPERATOR_NEW
};
 
}  // end namespace g2o
 
#endif