This filter includes or excludes waypoints based on their proximity to a central point. All waypoints more than the specified distance from the specified point will be removed from the dataset.
By default, all remaining points are sorted so that points closer to the center appear earlier in the output file.
Example 4.4. Using the radius filter to find points close to a given point
This example command line would include only points within 1 1/2 miles of N30.000 W 90.000
gpsbabel -i geo -f 1.loc -x radius,distance=1.5M,lat=30.0,lon=-90.0 -o mapsend -F 2.wpt
Latitude for center point (D.DDDDD).
This option is required.
This option specifies the latitude of the central point in decimal degrees. South latitudes should be expressed as a negative number. Valid values for this option are from -90 to 90.
Longitude for center point (D.DDDDD).
This option is required.
This option specifies the longitude of the central point in decimal degrees. West longitudes should be expressed as a negative number. Valid values for this option are from -180 to 180.
Maximum distance from center.
This option is required.
This option specifies the maximum distance a point may be from the central
point in order to remain in the dataset. Points closer than this distance
will be kept and points further away will be removed (unless the
exclude option is specified.)
The units may be specified by appending a suffix to the supplied number:
| 'm' for meters, e.g. 3500.0m |
| 'ft' or 'feet' for feet, e.g. 11483ft |
| 'k' or 'km' for kilometers, e.g 3.5000km |
| 'nm' for nautical miles, e.g. 1.8898nm |
| 'mi' for miles, e.g. 2.1748mi |
| 'fa' for fathoms, e.g. 1913.82fa |
If no units are specified, the units are assumed to be miles.
Exclude points close to center.
If this option is included, the action of the radius filter will be reversed: points within the given distance will be removed, and points further away will be kept.
Inhibit sort by distance to center.
If this option is specified, the radius filter will not sort the remaining points by distance from the center. They will remain in whatever order they were originally.
Output no more than this number of points.
This option specifies the maximum number of points that the radius filter may keep. If there are more than this number of points within the specified distance of the center, the more distant points will be discarded even though they are within the specified distance. If this option is not specified, all points are kept regardless of how many there are.
Note that if the nosort option is also specified, this
option will instead keep points based on their position within the input
file rather than on their distance from the center. This may or may not be
what you want.
Note, too, that this option may be used with the exclude
option, but the results might not be what you expect. In particular, the
results will not be the same as if you had kept all of the points you'd
otherwise throw away. You will still get no more than
maxcount points, but they will all be at least
distance away from the center. (And possibly sorted.)
Put resulting waypoints in route of this name.
This option specifies the name of a route. If this option is specified, the
radius filter puts all points that are kept into a route with the given name.
The order of points in the route is by distance from the center (unless the
nosort option is also specified.)
Note that this route is not necessarily the most efficient route to visit all of the points. In fact, for some data sets, it might be the least efficient route.