/** * @file ISAM2-inl.h * @brief Incremental update functionality (ISAM2) for BayesTree, with fluid relinearization. * @author Michael Kaess */ #include #include // for operator += using namespace boost::assign; #include #include "NonlinearFactorGraph-inl.h" #include "GaussianFactor.h" #include "VectorConfig.h" #include "Conditional.h" #include "BayesTree-inl.h" #include "ISAM2.h" namespace gtsam { using namespace std; // from inference-inl.h - need to additionally return the newly created factor for caching boost::shared_ptr _eliminateOne(FactorGraph& graph, CachedFactors& cached, const Symbol& key) { // combine the factors of all nodes connected to the variable to be eliminated // if no factors are connected to key, returns an empty factor boost::shared_ptr joint_factor = removeAndCombineFactors(graph,key); // eliminate that joint factor boost::shared_ptr factor; boost::shared_ptr conditional; boost::tie(conditional, factor) = joint_factor->eliminate(key); // ADDED: remember the intermediate result to be able to later restart computation in the middle cached[key] = factor; // add new factor on separator back into the graph if (!factor->empty()) graph.push_back(factor); // return the conditional Gaussian return conditional; } // from GaussianFactorGraph.cpp, see _eliminateOne above GaussianBayesNet _eliminate(FactorGraph& graph, CachedFactors& cached, const Ordering& ordering) { GaussianBayesNet chordalBayesNet; // empty BOOST_FOREACH(const Symbol& key, ordering) { GaussianConditional::shared_ptr cg = _eliminateOne(graph, cached, key); chordalBayesNet.push_back(cg); } return chordalBayesNet; } GaussianBayesNet _eliminate_const(const FactorGraph& graph, CachedFactors& cached, const Ordering& ordering) { // make a copy that can be modified locally FactorGraph graph_ignored = graph; return _eliminate(graph_ignored, cached, ordering); } /** Create an empty Bayes Tree */ template ISAM2::ISAM2() : BayesTree() {} /** Create a Bayes Tree from a nonlinear factor graph */ template ISAM2::ISAM2(const NonlinearFactorGraph& nlfg, const Ordering& ordering, const Config& config) : BayesTree(nlfg.linearize(config).eliminate(ordering)), theta_(config), thetaFuture_(config), nonlinearFactors_(nlfg) { // todo: repeats calculation above, just to set "cached" _eliminate_const(nlfg.linearize(config), cached_, ordering); } /* ************************************************************************* */ template list ISAM2::getAffectedFactors(const list& keys) const { FactorGraph > allAffected; list indices; BOOST_FOREACH(const Symbol& key, keys) { const list l = nonlinearFactors_.factors(key); indices.insert(indices.begin(), l.begin(), l.end()); } indices.sort(); indices.unique(); return indices; } /* ************************************************************************* */ // retrieve all factors that ONLY contain the affected variables // (note that the remaining stuff is summarized in the cached factors) template FactorGraph ISAM2::relinearizeAffectedFactors(const set& affectedKeys) const { list affectedKeysList; // todo: shouldn't have to convert back to list... affectedKeysList.insert(affectedKeysList.begin(), affectedKeys.begin(), affectedKeys.end()); list candidates = getAffectedFactors(affectedKeysList); NonlinearFactorGraph nonlinearAffectedFactors; BOOST_FOREACH(int idx, candidates) { bool inside = true; BOOST_FOREACH(const Symbol& key, nonlinearFactors_[idx]->keys()) { if (affectedKeys.find(key) == affectedKeys.end()) { inside = false; break; } } if (inside) nonlinearAffectedFactors.push_back(nonlinearFactors_[idx]); } return nonlinearAffectedFactors.linearize(theta_); } /* ************************************************************************* */ // find intermediate (linearized) factors from cache that are passed into the affected area template FactorGraph ISAM2::getCachedBoundaryFactors(Cliques& orphans) { FactorGraph cachedBoundary; BOOST_FOREACH(sharedClique orphan, orphans) { // find the last variable that was eliminated const Symbol& key = orphan->ordering().back(); // retrieve the cached factor and add to boundary cachedBoundary.push_back(cached_[key]); } return cachedBoundary; } /* ************************************************************************* */ template void ISAM2::update_internal(const NonlinearFactorGraph& newFactors, const Config& newTheta, Cliques& orphans, double wildfire_threshold, double relinearize_threshold, bool relinearize) { // marked_ = nonlinearFactors_.keys(); // debug only //////////// // only relinearize if requested in previous step AND necessary (ie. at least one variable changes) relinearize = true; // todo - switched off bool relinFromLast = true; //marked_.size() > 0; //// 1 - relinearize selected variables if (relinFromLast) { theta_ = expmap(theta_, deltaMarked_); } //// 2 - Add new factors (for later relinearization) nonlinearFactors_.push_back(newFactors); //// 3 - Initialize new variables theta_.insert(newTheta); thetaFuture_.insert(newTheta); //// 4 - Mark affected variables as invalid // todo - not in lyx yet: relin requires more than just removing the cliques corresponding to the variables!!! // It's about factors!!! if (relinFromLast) { // mark variables that have to be removed as invalid (removeFATtop) // basically calculate all the keys contained in the factors that contain any of the keys... // the goal is to relinearize all variables directly affected by new factors list allAffected = getAffectedFactors(marked_); set accumulate; BOOST_FOREACH(int idx, allAffected) { list tmp = nonlinearFactors_[idx]->keys(); accumulate.insert(tmp.begin(), tmp.end()); } marked_.clear(); marked_.insert(marked_.begin(), accumulate.begin(), accumulate.end()); } // else: marked_ is empty anyways // also mark variables that are affected by new factors as invalid const list newKeys = newFactors.keys(); marked_.insert(marked_.begin(), newKeys.begin(), newKeys.end()); // eliminate duplicates marked_.sort(); marked_.unique(); //// 5 - removeTop invalidate all cliques involving marked variables // remove affected factors BayesNet affectedBayesNet; this->removeTop(marked_, affectedBayesNet, orphans); //// 6 - find factors connected to affected variables //// 7 - linearize FactorGraph factors; if (relinFromLast) { // ordering provides all keys in conditionals, there cannot be others because path to root included set affectedKeys; list tmp = affectedBayesNet.ordering(); affectedKeys.insert(tmp.begin(), tmp.end()); // todo - remerge in keys of new factors affectedKeys.insert(newKeys.begin(), newKeys.end()); factors = relinearizeAffectedFactors(affectedKeys); // add the cached intermediate results from the boundary of the orphans ... FactorGraph cachedBoundary = getCachedBoundaryFactors(orphans); factors.push_back(cachedBoundary); } else { // reuse the old factors FactorGraph tmp(affectedBayesNet); factors.push_back(tmp); factors.push_back(newFactors.linearize(theta_)); } //// 8 - eliminate and add orphans back in // create an ordering for the new and contaminated factors Ordering ordering = factors.getOrdering(); // eliminate into a Bayes net BayesNet bayesNet = _eliminate(factors, cached_, ordering); // Create Index from ordering IndexTable index(ordering); // insert conditionals back in, straight into the topless bayesTree typename BayesNet::const_reverse_iterator rit; for ( rit=bayesNet.rbegin(); rit != bayesNet.rend(); ++rit ) this->insert(*rit, index); // add orphans to the bottom of the new tree BOOST_FOREACH(sharedClique orphan, orphans) { Symbol parentRepresentative = findParentClique(orphan->separator_, index); sharedClique parent = (*this)[parentRepresentative]; parent->children_ += orphan; orphan->parent_ = parent; // set new parent! } //// 9 - update solution delta_ = optimize2(*this, wildfire_threshold); //// 10 - mark variables, if significant change marked_.clear(); deltaMarked_ = VectorConfig(); // clear if (relinearize) { // decides about next step!!! for (VectorConfig::const_iterator it = delta_.begin(); it!=delta_.end(); it++) { Symbol key = it->first; Vector v = it->second; if (max(abs(v)) >= relinearize_threshold) { marked_.push_back(key); deltaMarked_.insert(key, v); } } // not part of the formal algorithm, but needed to allow initialization of new variables outside by the user thetaFuture_ = expmap(thetaFuture_, deltaMarked_); } } template void ISAM2::update( const NonlinearFactorGraph& newFactors, const Config& newTheta, double wildfire_threshold, double relinearize_threshold, bool relinearize) { Cliques orphans; this->update_internal(newFactors, newTheta, orphans, wildfire_threshold, relinearize_threshold, relinearize); } /* ************************************************************************* */ } /// namespace gtsam