
Da-
ta
Fil-
ters
80
The arc is defined in a file whose name must be provided with the file. That file contains pairs of coor-
dinates for the vertices of the arc, one coordinate pair per line. Comments may be included by preceding
them with a '#' character. An arc file looks something like this sample:
# Lima Road/SR3 north of Fort Wayne, Indiana
41.150064468 -85.166207433
41.150064468 -85.165371895
41.149034500 -85.165157318
41.147832870 -85.164771080
41.146631241 -85.164384842
41.144270897 -85.163655281
41.141953468 -85.162882805
An arc file may optionally contain gaps in the arc. You may specify such a gap by inserting a line containing
"#break" either on a line by itself or after the coordinates of the starting point of the new arc segment.
Example 4.3. Using the arc filter
Assuming the arc above is in a file called lima_rd.txt, the following command line would include
only points within one mile of the section of Lima Road covered by the arc.
gpsbabel -i geo -f 1.loc -x arc,file=lima_rd.txt,distance=1 -o mapsend
-F 2.wpt
file option
File containing vertices of arc.
This option is required.
This option specifies the name of the file containing the arc to use for filtering. The format of the file is
as described above.
GPSBabel supports converting any route or track to a file usable by this filter; simply read it in the normal
way and write it using the arc file format.
distance option
Maximum distance from arc.
This option is not required, but if it is not specified the distance defaults to zero miles, which isn't very
useful.
This option specifies the maximum distance a point may be from the arc without being discarded. Points
that are closer to the arc are kept, while points that are further away are discarded.
Distances may be specified in miles (3M) or kilometers (5K). If no units are specified, the distance is
assumed to be in miles.
exclude option
Exclude points close to the arc.
Comentários a estes Manuais