/* ---------------------------------------------------------------------------- * GTSAM Copyright 2010, Georgia Tech Research Corporation, * Atlanta, Georgia 30332-0415 * All Rights Reserved * Authors: Frank Dellaert, et al. (see THANKS for the full author list) * See LICENSE for the license information * -------------------------------------------------------------------------- */ /** * @file Expression-inl.h * @date September 18, 2014 * @author Frank Dellaert * @author Paul Furgale * @brief Internals for Expression.h, not for general consumption */ #pragma once #include #include #include namespace gtsam { template class Expression; typedef std::map JacobianMap; //----------------------------------------------------------------------------- /** * Value and Jacobians */ template class Augmented { private: T value_; JacobianMap jacobians_; typedef std::pair Pair; /// Insert terms into jacobians_, premultiplying by H, adding if already exists void add(const Matrix& H, const JacobianMap& terms) { BOOST_FOREACH(const Pair& term, terms) { JacobianMap::iterator it = jacobians_.find(term.first); if (it != jacobians_.end()) it->second += H * term.second; else jacobians_[term.first] = H * term.second; } } public: /// Construct value that does not depend on anything Augmented(const T& t) : value_(t) { } /// Construct value dependent on a single key Augmented(const T& t, Key key) : value_(t) { size_t n = t.dim(); jacobians_[key] = Eigen::MatrixXd::Identity(n, n); } /// Construct value, pre-multiply jacobians by H Augmented(const T& t, const Matrix& H, const JacobianMap& jacobians) : value_(t) { add(H, jacobians); } /// Construct value, pre-multiply jacobians by H Augmented(const T& t, const Matrix& H1, const JacobianMap& jacobians1, const Matrix& H2, const JacobianMap& jacobians2) : value_(t) { add(H1, jacobians1); add(H2, jacobians2); } /// Construct value, pre-multiply jacobians by H Augmented(const T& t, const Matrix& H1, const JacobianMap& jacobians1, const Matrix& H2, const JacobianMap& jacobians2, const Matrix& H3, const JacobianMap& jacobians3) : value_(t) { add(H2, jacobians2); add(H3, jacobians3); add(H1, jacobians1); } /// Return value const T& value() const { return value_; } /// Return jacobians const JacobianMap& jacobians() const { return jacobians_; } /// Not dependent on any key bool constant() const { return jacobians_.empty(); } /// debugging void print(const KeyFormatter& keyFormatter = DefaultKeyFormatter) { BOOST_FOREACH(const Pair& term, jacobians_) std::cout << "(" << keyFormatter(term.first) << ", " << term.second.rows() << "x" << term.second.cols() << ") "; std::cout << std::endl; } }; //----------------------------------------------------------------------------- /** * Expression node. The superclass for objects that do the heavy lifting * An Expression has a pointer to an ExpressionNode underneath * allowing Expressions to have polymorphic behaviour even though they * are passed by value. This is the same way boost::function works. * http://loki-lib.sourceforge.net/html/a00652.html */ template class ExpressionNode { protected: ExpressionNode() { } public: /// Destructor virtual ~ExpressionNode() { } /// Return keys that play in this expression as a set virtual std::set keys() const = 0; /// Return value virtual T value(const Values& values) const = 0; /// Return value and derivatives virtual Augmented augmented(const Values& values) const = 0; }; //----------------------------------------------------------------------------- /// Constant Expression template class ConstantExpression: public ExpressionNode { /// The constant value T constant_; /// Constructor with a value, yielding a constant ConstantExpression(const T& value) : constant_(value) { } friend class Expression ; public: /// Destructor virtual ~ConstantExpression() { } /// Return keys that play in this expression, i.e., the empty set virtual std::set keys() const { std::set keys; return keys; } /// Return value virtual T value(const Values& values) const { return constant_; } /// Return value and derivatives virtual Augmented augmented(const Values& values) const { T t = value(values); return Augmented(t); } }; //----------------------------------------------------------------------------- /// Leaf Expression template class LeafExpression: public ExpressionNode { /// The key into values Key key_; /// Constructor with a single key LeafExpression(Key key) : key_(key) { } friend class Expression ; public: /// Destructor virtual ~LeafExpression() { } /// Return keys that play in this expression virtual std::set keys() const { std::set keys; keys.insert(key_); return keys; } /// Return value virtual T value(const Values& values) const { return values.at(key_); } /// Return value and derivatives virtual Augmented augmented(const Values& values) const { T t = value(values); return Augmented(t, key_); } }; //----------------------------------------------------------------------------- /// Unary Function Expression template class UnaryExpression: public ExpressionNode { public: typedef boost::function)> Function; private: Function function_; boost::shared_ptr > expressionA_; /// Constructor with a unary function f, and input argument e UnaryExpression(Function f, const Expression& e) : function_(f), expressionA_(e.root()) { } friend class Expression ; public: /// Destructor virtual ~UnaryExpression() { } /// Return keys that play in this expression virtual std::set keys() const { return expressionA_->keys(); } /// Return value virtual T value(const Values& values) const { return function_(this->expressionA_->value(values), boost::none); } /// Return value and derivatives virtual Augmented augmented(const Values& values) const { using boost::none; Augmented argument = this->expressionA_->augmented(values); Matrix H; T t = function_(argument.value(), argument.constant() ? none : boost::optional(H)); return Augmented(t, H, argument.jacobians()); } }; //----------------------------------------------------------------------------- /// Binary Expression template class BinaryExpression: public ExpressionNode { public: typedef boost::function< T(const A1&, const A2&, boost::optional, boost::optional)> Function; private: Function function_; boost::shared_ptr > expressionA1_; boost::shared_ptr > expressionA2_; /// Constructor with a binary function f, and two input arguments BinaryExpression(Function f, // const Expression& e1, const Expression& e2) : function_(f), expressionA1_(e1.root()), expressionA2_(e2.root()) { } friend class Expression ; public: /// Destructor virtual ~BinaryExpression() { } /// Return keys that play in this expression virtual std::set keys() const { std::set keys1 = expressionA1_->keys(); std::set keys2 = expressionA2_->keys(); keys1.insert(keys2.begin(), keys2.end()); return keys1; } /// Return value virtual T value(const Values& values) const { using boost::none; return function_(this->expressionA1_->value(values), this->expressionA2_->value(values), none, none); } /// Return value and derivatives virtual Augmented augmented(const Values& values) const { using boost::none; Augmented argument1 = this->expressionA1_->augmented(values); Augmented argument2 = this->expressionA2_->augmented(values); Matrix H1, H2; T t = function_(argument1.value(), argument2.value(), argument1.constant() ? none : boost::optional(H1), argument2.constant() ? none : boost::optional(H2)); return Augmented(t, H1, argument1.jacobians(), H2, argument2.jacobians()); } }; //----------------------------------------------------------------------------- /// Ternary Expression template class TernaryExpression: public ExpressionNode { public: typedef boost::function< T(const A1&, const A2&, const A3&, boost::optional, boost::optional, boost::optional)> Function; private: Function function_; boost::shared_ptr > expressionA1_; boost::shared_ptr > expressionA2_; boost::shared_ptr > expressionA3_; /// Constructor with a ternary function f, and three input arguments TernaryExpression(Function f, // const Expression& e1, const Expression& e2, const Expression& e3) : function_(f), expressionA1_(e1.root()), expressionA2_(e2.root()), expressionA3_(e3.root()) { } friend class Expression ; public: /// Destructor virtual ~TernaryExpression() { } /// Return keys that play in this expression virtual std::set keys() const { std::set keys1 = expressionA1_->keys(); std::set keys2 = expressionA2_->keys(); std::set keys3 = expressionA3_->keys(); keys2.insert(keys3.begin(), keys3.end()); keys1.insert(keys2.begin(), keys2.end()); return keys1; } /// Return value virtual T value(const Values& values) const { using boost::none; return function_(this->expressionA1_->value(values), this->expressionA2_->value(values), this->expressionA3_->value(values), none, none, none); } /// Return value and derivatives virtual Augmented augmented(const Values& values) const { using boost::none; Augmented argument1 = this->expressionA1_->augmented(values); Augmented argument2 = this->expressionA2_->augmented(values); Augmented argument3 = this->expressionA3_->augmented(values); Matrix H1, H2, H3; T t = function_(argument1.value(), argument2.value(), argument3.value(), argument1.constant() ? none : boost::optional(H1), argument2.constant() ? none : boost::optional(H2), argument3.constant() ? none : boost::optional(H3)); return Augmented(t, H1, argument1.jacobians(), H2, argument2.jacobians()); } }; //----------------------------------------------------------------------------- }