.. You can adapt this file completely to your liking, but it should at least contain the root `toctree` directive. GPS FILE STRUCTURES AND REQUIREMENTS ===================================== .. toctree:: :maxdepth: 2 The DNR GPS program looks for specific fields when loading GPS data from a file. Below are lists of fields associated with each GPS data type. The **required fields** are in bold. If these fields are not found, you may be prompted to supply the proper field for these values. Waypoints --------- ============= ======================= ====== ====== ========= Name Description Type Length Precision ============= ======================= ====== ====== ========= **type** WAYPOINT string 10 0 **ident** Identifier string 24 0 **lat** Latitude number 18 8 **long** Longitude number 18 8 **y_proj** Projected Y Coordinate number 18 8 **x_proj** Projected X Coordinate number 18 8 comment User Comment string 254 0 display Display Options string 10 0 symbol Waypoint Symbol string 10 0 dist Proximity Distance number 12 2 proximity Proximity Index string 10 0 color Color string 10 0 altitude Altitude number 12 2 depth Depth number 12 2 temp Temperature number 12 2 time Time/Date string 20 0 wpt_class Waypoint Class string 10 0 sub_class Subclass string 10 0 attrib Attributes string 10 0 link Link to Additional Info string 254 0 state State string 15 0 country Country Code string 15 0 city City Name string 15 0 address Address Number string 15 0 zip Zip Code string 15 0 facility Facility Code string 15 0 crossroad Intersecting Road Label string 15 0 ete Estimate Time Enroute string 10 0 dtype string 10 0 model GPS Model string 20 0 filename Hotlink Filename string 254 0 ltime Local Time string 20 0 magvar Magnetic Variation number 10 2 geoidheight Height Above WGS84 number 10 2 desc Text Description string 254 0 fix Type of GPX Fix string 5 0 sat Number of Satellites number 5 0 hdop Horizontal DOP number 5 2 vdop Vertical DOP number 5 2 pdop Dilution of Precision number 5 2 ageofdgpsdata Age (in seconds) number 10 0 dgpsid ID of DGPS Station number 4 0 ============= ======================= ====== ====== ========= Tracks --------- ============= ======================= ====== ====== ========= Name Description Type Length Precision ============= ======================= ====== ====== ========= **type** TRACK string 10 0 **ident** Identifier string 24 0 **lat** Latitude number 18 8 **long** Longitude number 18 8 **y_proj** Projected Y Coordinate number 18 8 **x_proj** Projected X Coordinate number 18 8 comment User Comment string 254 0 **new_trk** New Track string 10 0 **new_seg** New Track Segment string 10 0 display Display on Map? string 10 0 color Color string 10 0 altitude Altitude number 12 2 depth Depth number 12 2 temp Temperature number 12 2 time UTC Date-Time string 20 0 model GPS Model string 20 0 filename Hotlink Filename string 254 0 ltime Local Time string 20 0 desc Text Description string 254 0 link Link to Additional Info string 254 0 ============= ======================= ====== ====== ========= Routes --------- ============= ======================= ====== ====== ========= Name Description Type Length Precision ============= ======================= ====== ====== ========= **type** ROUTE string 10 0 **ident** Identifier string 24 0 **lat** Latitude number 18 8 **long** Longitude number 18 8 **y_proj** Projected Y Coordinate number 18 8 **x_proj** Projected X Coordinate number 18 8 **new_seg** New Route Segment string 10 0 rnumber Route Number string 12 0 rident Route Identifier string 10 0 rcmnt Route Comment string 10 0 rdesc Route Descrtipion string 10 0 rlink Route Link string 10 0 rtype string 12 0 comment User Comment string 254 0 display Display Options string 10 0 symbol Waypoint Symbol string 10 0 dist Proximity Distance number 12 2 proximity Proximity Index string 10 0 color Color string 10 0 altitude Altitude number 12 2 depth Depth number 12 2 temp Temperature number 12 2 time Time/Date string 20 0 wpt_class Waypoint Class string 10 0 sub_class Subclass string 10 0 attrib Attributes string 10 0 state State string 15 0 country Country Code string 15 0 city City Name string 15 0 address Address Number string 15 0 zip Zip Code string 15 0 facility Facility Code string 15 0 crossroad Intersecting Road Label string 15 0 ete Estimate Time Enroute string 10 0 dtype string 10 0 filename Hotlink Filename string 254 0 ltime Local Time string 20 0 magvar Magnetic Variation number 10 2 geoidheight Height Above WGS84 number 10 2 desc Text Description string 254 0 model GPS Model string 20 0 fix Type of GPX Fix string 5 0 sat Number of Satellites number 5 0 hdop Horizontal DOP number 5 2 vdop Vertical DOP number 5 2 pdop Dilution of Precision number 5 2 ageofdgpsdata Age (in seconds) number 10 0 dgpsid ID of DGPS Station number 4 0 ============= ======================= ====== ====== ========= .. _real_time_file_structure: Real Time ---------- ============= ======================== ====== ====== ========= Name Description Type Length Precision ============= ======================== ====== ====== ========= **type** ROUTE string 10 0 **ident** Identifier string 24 0 **lat** Latitude number 18 8 **long** Longitude number 18 8 **y_proj** Projected Y Coordinate number 18 8 **x_proj** Projected X Coordinate number 18 8 comment string 254 0 altitude Altitude number 12 2 epe Estimated Position Error number 10 2 - 2 sigma eph EPE, but horizontal only number 10 2 epv EPE, but vertical only number 10 2 hdop Horizontal DOP number 5 2 vdop Vertical DOP number 5 2 pdop Dilution of Precision number 5 2 speed Speed Over Ground number 10 2 (knots) course Course Over Ground number 10 2 (degrees) mvar Magnetic Variation number 10 2 (degrees) mdir Magnetic Variation (E/W) number 10 2 datum Datum of coordinates string 20 0 pfix Type of position fix number 10 0 * 0 = Unusable * 1 = Invalid * 2 = 2D * 3 = 3D * 4 = 2D_diff * 5 = 3D_diff east Velocity East string 10 0 north Velocity North string 10 0 up Velocity Up number 10 2 depth Depth Below Transducer number 12 2 temp Temperature (Celcius) number 12 2 time UTC Time string 20 0 filename Hotlink filename string 255 0 ltime Local Time string 20 0 ============= ======================== ====== ====== =========