mlpack  1.0.12
neighbor_search_rules.hpp
Go to the documentation of this file.
1 
15 #ifndef __MLPACK_METHODS_NEIGHBOR_SEARCH_NEIGHBOR_SEARCH_RULES_HPP
16 #define __MLPACK_METHODS_NEIGHBOR_SEARCH_NEIGHBOR_SEARCH_RULES_HPP
17 
18 #include "ns_traversal_info.hpp"
19 
20 namespace mlpack {
21 namespace neighbor {
22 
23 template<typename SortPolicy, typename MetricType, typename TreeType>
25 {
26  public:
27  NeighborSearchRules(const typename TreeType::Mat& referenceSet,
28  const typename TreeType::Mat& querySet,
29  arma::Mat<size_t>& neighbors,
30  arma::mat& distances,
31  MetricType& metric);
40  double BaseCase(const size_t queryIndex, const size_t referenceIndex);
41 
50  double Score(const size_t queryIndex, TreeType& referenceNode);
51 
63  double Rescore(const size_t queryIndex,
64  TreeType& referenceNode,
65  const double oldScore) const;
66 
75  double Score(TreeType& queryNode, TreeType& referenceNode);
76 
88  double Rescore(TreeType& queryNode,
89  TreeType& referenceNode,
90  const double oldScore) const;
91 
93  size_t BaseCases() const { return baseCases; }
95  size_t& BaseCases() { return baseCases; }
96 
98  size_t Scores() const { return scores; }
100  size_t& Scores() { return scores; }
101 
104 
106  const TraversalInfoType& TraversalInfo() const { return traversalInfo; }
108  TraversalInfoType& TraversalInfo() { return traversalInfo; }
109 
110  private:
112  const typename TreeType::Mat& referenceSet;
113 
115  const typename TreeType::Mat& querySet;
116 
118  arma::Mat<size_t>& neighbors;
119 
121  arma::mat& distances;
122 
124  MetricType& metric;
125 
131  double lastBaseCase;
132 
134  size_t baseCases;
136  size_t scores;
137 
140  TraversalInfoType traversalInfo;
141 
145  double CalculateBound(TreeType& queryNode) const;
146 
156  void InsertNeighbor(const size_t queryIndex,
157  const size_t pos,
158  const size_t neighbor,
159  const double distance);
160 };
161 
162 }; // namespace neighbor
163 }; // namespace mlpack
164 
165 // Include implementation.
166 #include "neighbor_search_rules_impl.hpp"
167 
168 #endif // __MLPACK_METHODS_NEIGHBOR_SEARCH_NEIGHBOR_SEARCH_RULES_HPP
double CalculateBound(TreeType &queryNode) const
Recalculate the bound for a given query node.
TraversalInfoType & TraversalInfo()
Modify the traversal info.
size_t lastQueryIndex
The last query point BaseCase() was called with.
Linear algebra utility functions, generally performed on matrices or vectors.
Definition: load.hpp:23
arma::mat & distances
The matrix the resultant neighbor distances should be stored in.
TraversalInfoType traversalInfo
Traversal info for the parent combination; this is updated by the traversal before each call to Score...
size_t BaseCases() const
Get the number of base cases that have been performed.
const TreeType::Mat & referenceSet
The reference set.
void InsertNeighbor(const size_t queryIndex, const size_t pos, const size_t neighbor, const double distance)
Insert a point into the neighbors and distances matrices; this is a helper function.
NeighborSearchTraversalInfo< TreeType > TraversalInfoType
Convenience typedef.
const TraversalInfoType & TraversalInfo() const
Get the traversal info.
Traversal information for NeighborSearch.
size_t & Scores()
Modify the number of scores that have been performed.
double lastBaseCase
The last base case result.
size_t Scores() const
Get the number of scores that have been performed.
size_t lastReferenceIndex
The last reference point BaseCase() was called with.
double Score(const size_t queryIndex, TreeType &referenceNode)
Get the score for recursion order.
NeighborSearchRules(const typename TreeType::Mat &referenceSet, const typename TreeType::Mat &querySet, arma::Mat< size_t > &neighbors, arma::mat &distances, MetricType &metric)
arma::Mat< size_t > & neighbors
The matrix the resultant neighbor indices should be stored in.
double BaseCase(const size_t queryIndex, const size_t referenceIndex)
Get the distance from the query point to the reference point.
size_t & BaseCases()
Modify the number of base cases that have been performed.
double Rescore(const size_t queryIndex, TreeType &referenceNode, const double oldScore) const
Re-evaluate the score for recursion order.
MetricType & metric
The instantiated metric.
size_t scores
The number of scores that have been performed.
size_t baseCases
The number of base cases that have been performed.
const TreeType::Mat & querySet
The query set.