2010-01-11 02:21:20 +08:00
|
|
|
/**
|
|
|
|
|
* @file Pose3Graph.h
|
|
|
|
|
* @brief A factor graph for the 3D PoseSLAM problem
|
|
|
|
|
* @author Frank Dellaert
|
|
|
|
|
* @author Viorela Ila
|
|
|
|
|
*/
|
|
|
|
|
|
|
|
|
|
#pragma once
|
|
|
|
|
|
|
|
|
|
#include "Pose3Factor.h"
|
Large gtsam refactoring
To support faster development *and* better performance Richard and I pushed through a large refactoring of NonlinearFactors.
The following are the biggest changes:
1) NonLinearFactor1 and NonLinearFactor2 are now templated on Config, Key type, and X type, where X is the argument to the measurement function.
2) The measurement itself is no longer kept in the nonlinear factor. Instead, a derived class (see testVSLAMFactor, testNonlinearEquality, testPose3Factor etc...) has to implement a function to compute the errors, "evaluateErrors". Instead of (h(x)-z), it needs to return (z-h(x)), so Ax-b is an approximation of the error. IMPORTANT: evaluateErrors needs - if asked - *combine* the calculation of the function value h(x) and the derivatives dh(x)/dx. This was a major performance issue. To do this, boost::optional<Matrix&> arguments are provided, and tin EvaluateErrors you just says something like
if (H) *H = Matrix_(3,6,....);
3) We are no longer using int or strings for nonlinear factors. Instead, the preferred key type is now Symbol, defined in Key.h. This is both fast and cool: you can construct it from an int, and cast it to a strong. It also does type checking: a Symbol<Pose3,'x'> will not match a Symbol<Pose2,'x'>
4) minor: take a look at LieConfig.h: it help you avoid writing a lot of code bu automatically creating configs for a certain type. See e.g. Pose3Config.h. A "double" LieConfig is on the way - Thanks Richard and Manohar !
2010-01-14 06:25:03 +08:00
|
|
|
#include "NonlinearFactorGraph.h"
|
2010-01-11 02:21:20 +08:00
|
|
|
|
2010-01-11 03:25:19 +08:00
|
|
|
namespace gtsam {
|
|
|
|
|
|
|
|
|
|
/**
|
|
|
|
|
* Non-linear factor graph for visual SLAM
|
|
|
|
|
*/
|
|
|
|
|
class Pose3Graph: public gtsam::NonlinearFactorGraph<Pose3Config> {
|
|
|
|
|
|
|
|
|
|
public:
|
|
|
|
|
|
|
|
|
|
/** default constructor is empty graph */
|
|
|
|
|
Pose3Graph() {
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
/**
|
|
|
|
|
* equals
|
|
|
|
|
*/
|
|
|
|
|
bool equals(const Pose3Graph& p, double tol = 1e-9) const;
|
|
|
|
|
|
|
|
|
|
/**
|
|
|
|
|
* Add a factor without having to do shared factor dance
|
|
|
|
|
*/
|
Large gtsam refactoring
To support faster development *and* better performance Richard and I pushed through a large refactoring of NonlinearFactors.
The following are the biggest changes:
1) NonLinearFactor1 and NonLinearFactor2 are now templated on Config, Key type, and X type, where X is the argument to the measurement function.
2) The measurement itself is no longer kept in the nonlinear factor. Instead, a derived class (see testVSLAMFactor, testNonlinearEquality, testPose3Factor etc...) has to implement a function to compute the errors, "evaluateErrors". Instead of (h(x)-z), it needs to return (z-h(x)), so Ax-b is an approximation of the error. IMPORTANT: evaluateErrors needs - if asked - *combine* the calculation of the function value h(x) and the derivatives dh(x)/dx. This was a major performance issue. To do this, boost::optional<Matrix&> arguments are provided, and tin EvaluateErrors you just says something like
if (H) *H = Matrix_(3,6,....);
3) We are no longer using int or strings for nonlinear factors. Instead, the preferred key type is now Symbol, defined in Key.h. This is both fast and cool: you can construct it from an int, and cast it to a strong. It also does type checking: a Symbol<Pose3,'x'> will not match a Symbol<Pose2,'x'>
4) minor: take a look at LieConfig.h: it help you avoid writing a lot of code bu automatically creating configs for a certain type. See e.g. Pose3Config.h. A "double" LieConfig is on the way - Thanks Richard and Manohar !
2010-01-14 06:25:03 +08:00
|
|
|
inline void add(const Pose3Config::Key& key1, const Pose3Config::Key& key2,
|
2010-01-11 03:25:19 +08:00
|
|
|
const Pose3& measured, const Matrix& covariance) {
|
|
|
|
|
push_back(sharedFactor(new Pose3Factor(key1, key2, measured, covariance)));
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
/**
|
|
|
|
|
* Add an equality constraint on a pose
|
|
|
|
|
* @param key of pose
|
|
|
|
|
* @param pose which pose to constrain it to
|
|
|
|
|
*/
|
2010-01-14 09:44:00 +08:00
|
|
|
void addConstraint(const Pose3Config::Key& key, const Pose3& pose =Pose3());
|
2010-01-11 03:25:19 +08:00
|
|
|
|
|
|
|
|
private:
|
|
|
|
|
/** Serialization function */
|
|
|
|
|
friend class boost::serialization::access;
|
|
|
|
|
template<class Archive>
|
|
|
|
|
void serialize(Archive & ar, const unsigned int version) {
|
|
|
|
|
}
|
|
|
|
|
};
|
2010-01-11 02:21:20 +08:00
|
|
|
|
|
|
|
|
} // namespace gtsam
|