Added author to all java files with class comments.
[utils] / gps / src / main / java / org / wamblee / gps / track / Track.java
1 /*
2  * Copyright 2006 the original author or authors.
3  * 
4  * Licensed under the Apache License, Version 2.0 (the "License");
5  * you may not use this file except in compliance with the License.
6  * You may obtain a copy of the License at
7  * 
8  *      http://www.apache.org/licenses/LICENSE-2.0
9  * 
10  * Unless required by applicable law or agreed to in writing, software
11  * distributed under the License is distributed on an "AS IS" BASIS,
12  * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13  * See the License for the specific language governing permissions and
14  * limitations under the License.
15  */ 
16
17 package org.wamblee.gps.track;
18
19 import java.io.Serializable;
20 import java.util.ArrayList;
21 import java.util.List;
22
23 import org.wamblee.gps.geometry.Point;
24
25 /**
26  * Represents a GPS track. 
27  *
28  * @author Erik Brakkee
29  */
30 public class Track implements Serializable {
31     
32     private List<TrackPoint> _points; 
33     
34     /**
35      * Constructs an empty track. 
36      *
37      */
38     public Track() { 
39         _points = new ArrayList<TrackPoint>();
40     }
41     
42     /**
43      * Adds a point to a track. 
44      * @param aPoint Point. 
45      */
46     public void addPoint(TrackPoint aPoint) { 
47         _points.add(aPoint);
48     }
49     
50     /**
51      * @return Number of points in the track. 
52      */
53     public int size()  { 
54         return _points.size(); 
55     }
56     
57     public double getMinCoordinate(int i) {
58         if ( size() == 0 ) { 
59             throw new IllegalArgumentException("empty track");
60         }
61         double min = getPoint(0).getCoordinates().getX(i);
62         for (int j = 1; j < size(); j++) { 
63             min = Math.min(min, getPoint(j).getCoordinates().getX(i));
64         }
65         return min;
66     }
67     
68     public double getMaxCoordinate(int i) {
69         if ( size() == 0 ) { 
70             throw new IllegalArgumentException("empty track");
71         }
72         double max = getPoint(0).getCoordinates().getX(i);
73         for (int j = 1; j < size(); j++) { 
74             max = Math.max(max, getPoint(j).getCoordinates().getX(i));
75         }
76         return max;
77     }
78     
79     /**
80      * Gets the point at the given inded. 
81      * @param aIndex 0 &lt;= aIndex &lt; size()
82      * @return Point.
83      */
84     public Point getPoint(int aIndex) { 
85         return _points.get(aIndex);
86     }
87 }