/* * SubgraphPreconditioner.h * Created on: Dec 31, 2009 * @author: Frank Dellaert */ #pragma once #include #include #include namespace gtsam { /** * Subgraph conditioner class, as explained in the RSS 2010 submission. * Starting with a graph A*x=b, we split it in two systems A1*x=b1 and A2*x=b2 * We solve R1*x=c1, and make the substitution y=R1*x-c1. * To use the class, give the Bayes Net R1*x=c1 and Graph A2*x=b2. * Then solve for yhat using CG, and solve for xhat = system.x(yhat). */ class SubgraphPreconditioner { public: typedef boost::shared_ptr sharedBayesNet; typedef boost::shared_ptr sharedFG; typedef boost::shared_ptr sharedValues; typedef boost::shared_ptr sharedErrors; private: sharedFG Ab1_, Ab2_; sharedBayesNet Rc1_; sharedValues xbar_; sharedErrors b2bar_; /** b2 - A2*xbar */ public: /** * Constructor * @param Ab1: the Graph A1*x=b1 * @param Ab2: the Graph A2*x=b2 * @param Rc1: the Bayes Net R1*x=c1 * @param xbar: the solution to R1*x=c1 */ SubgraphPreconditioner(sharedFG& Ab1, sharedFG& Ab2, sharedBayesNet& Rc1, sharedValues& xbar); std::pair Ab1(const Ordering& ordering) const { return Ab1_->matrix(ordering); } std::pair Ab2(const Ordering& ordering) const { return Ab2_->matrix(ordering); } Matrix A1(const Ordering& ordering) const { return Ab1_->sparse(ordering); } Matrix A2(const Ordering& ordering) const { return Ab2_->sparse(Ab1_->columnIndices(ordering)); } Vector b1() const { return Ab1_->rhsVector(); } Vector b2() const { return Ab2_->rhsVector(); } VectorValues assembleValues(const Vector& v, const Ordering& ordering) const { return Ab1_->assembleValues(v, ordering); } /* x = xbar + inv(R1)*y */ VectorValues x(const VectorValues& y) const; /* A zero VectorValues with the structure of xbar */ VectorValues zero() const { return VectorValues::zero(*xbar_);} /* error, given y */ double error(const VectorValues& y) const; /** gradient = y + inv(R1')*A2'*(A2*inv(R1)*y-b2bar) */ VectorValues gradient(const VectorValues& y) const; /** Apply operator A */ Errors operator*(const VectorValues& y) const; /** Apply operator A in place: needs e allocated already */ void multiplyInPlace(const VectorValues& y, Errors& e) const; /** Apply operator A' */ VectorValues operator^(const Errors& e) const; /** * Add A'*e to y * y += alpha*A'*[e1;e2] = [alpha*e1; alpha*inv(R1')*A2'*e2] */ void transposeMultiplyAdd(double alpha, const Errors& e, VectorValues& y) const; /** * Add constraint part of the error only, used in both calls above * y += alpha*inv(R1')*A2'*e2 * Takes a range indicating e2 !!!! */ void transposeMultiplyAdd2(double alpha, Errors::const_iterator begin, Errors::const_iterator end, VectorValues& y) const; /** print the object */ void print(const std::string& s = "SubgraphPreconditioner") const; }; } // namespace gtsam