File: PointLocator.h

package info (click to toggle)
caret 5.6.4~dfsg.1-3
  • links: PTS, VCS
  • area: main
  • in suites: jessie, jessie-kfreebsd, wheezy
  • size: 31,904 kB
  • ctags: 28,901
  • sloc: cpp: 378,050; python: 6,718; ansic: 5,507; makefile: 333; sh: 46
file content (130 lines) | stat: -rw-r--r-- 3,516 bytes parent folder | download | duplicates (2)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130

#ifndef __POINT_LOCATOR_H__
#define __POINT_LOCATOR_H__

/*LICENSE_START*/
/*
 *  Copyright 1995-2002 Washington University School of Medicine
 *
 *  http://brainmap.wustl.edu
 *
 *  This file is part of CARET.
 *
 *  CARET is free software; you can redistribute it and/or modify
 *  it under the terms of the GNU General Public License as published by
 *  the Free Software Foundation; either version 2 of the License, or
 *  (at your option) any later version.
 *
 *  CARET is distributed in the hope that it will be useful,
 *  but WITHOUT ANY WARRANTY; without even the implied warranty of
 *  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 *  GNU General Public License for more details.
 *
 *  You should have received a copy of the GNU General Public License
 *  along with CARET; if not, write to the Free Software
 *  Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
 *
 */
/*LICENSE_END*/

#include <vector>

/// This class is a 3D point locator.  Points may be added at any time.
class PointLocator {
   protected:
      /// Information about a point
      class Point {
         public:
            /// Constructor
            Point(const float xyzIn[3], const int idIn = -1);
            
            /// Destructor
            ~Point();
            
            /// point's coordinate
            float xyz[3];
            
            /// point's ID
            int idNum;            
      };
      
   public:
      /// Constructor
      PointLocator(const float boundsIn[6],
                   const int* numBucketsInEachAxis = NULL);
      
      /// Constructor
      ~PointLocator();
      
      /// add a point to the locator
      void addPoint(const float xyz[3], const int idIn);
      
      /// get nearest point
      int getNearestPoint(const float xyz[3]) const;
      
   protected:
      /// Class for storing a bucket
      class Bucket {
         public:
            /// constructor
            Bucket();
            
            /// destructor
            ~Bucket();
            
            /// get nearest point
            int getNearestPoint(const float xyz[3], float& nearbyDistSQ,
                                float nearbyXYZ[3]) const;
            
            /// the bounds of the bucket
            float bounds[6];
            
            /// the points in the bucket
            std::vector<Point> points;
      };
      
      /// get bucket for a point (returns false if not in a bucket - out of bounds)
      bool getBucket(const float xyz[3], int ijk[3]) const;
      
      /// get one dimensional bucket index
      int getBucketIndex(const int ijk[3]) const;
      
      /// get one dimensional bucket index
      int getBucketIndex(const float xyz[3]) const;
      
      /// limit the IJK index to valid buckets
      void limitIJK(int ijk[3]) const;
      
      /// the buckets
      Bucket* buckets;
      
      /// size of buckets in X axis
      float sizeX;
      
      /// size of buckets in X axis
      float sizeY;
      
      /// size of buckets in X axis
      float sizeZ;
      
      /// number of buckets in X axis
      int numX;
      
      /// number of buckets in Y axis
      int numY;
      
      /// number of buckets in Z axis
      int numZ;
      
      /// total number of buckets
      int totalNumBuckets;
      
      /// bounds of the point locator
      float bounds[6];
      
      /// keeps count of points added
      int pointCounter;
};

#endif // __POINT_LOCATOR_H__