DsfTrackGenerator.h

Go to the documentation of this file.

/* ----------------------------------------------------------------------------
 
 * 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
 
 * -------------------------------------------------------------------------- */
 
#pragma once
#include <gtsam/base/DSFMap.h>
#include <gtsam/sfm/SfmTrack.h>
 
#include <Eigen/Core>
#include <map>
#include <optional>
#include <vector>
 
namespace gtsam {
 
namespace gtsfm {
 
typedef Eigen::MatrixX2i CorrespondenceIndices;  // N x 2 array
 
// Output of detections in an image.
// Coordinate system convention:
// 1. The x coordinate denotes the horizontal direction (+ve direction towards
// the right).
// 2. The y coordinate denotes the vertical direction (+ve direction downwards).
// 3. Origin is at the top left corner of the image.
struct Keypoints {
  // The (x, y) coordinates of the features, of shape Nx2.
  Eigen::MatrixX2d coordinates;
 
  // Optional scale of the detections, of shape N.
  // Note: gtsam::Vector is typedef'd for Eigen::VectorXd.
  std::optional<gtsam::Vector> scales;
 
  std::optional<gtsam::Vector> responses;
 
  Keypoints(const Eigen::MatrixX2d &_coordinates)
      : coordinates(_coordinates) {}
};
 
using KeypointsVector = std::vector<Keypoints>;
// Mapping from each image pair to (N,2) array representing indices of matching
// keypoints.
using MatchIndicesMap = std::map<IndexPair, CorrespondenceIndices>;
 
std::vector<SfmTrack2d> GTSAM_EXPORT tracksFromPairwiseMatches(
    const MatchIndicesMap& matches, const KeypointsVector& keypoints,
    bool verbose = false);
 
}  // namespace gtsfm
 
}  // namespace gtsam