Home

GPS Manager User Manual

1. e to display clear items on from the map e to transfer items to from the receiver or to from a file e for a set of waypoints to apply a renaming method 4 3 to define an average waypoint 4 10 to change their position formats datums or symbols 4 10 to compute clusters 4 10 As groups are also used by GPSMan to present the results of a search as described below 4 11 searching for items is an effective way of creating a group with items that are then operated upon from the group window 37 Groups can also be created for the items that are or are not currently displayed on the map This is done using the Make Group entry of the Items menu button on the map window When getting laps from the receiver runs will be stored as groups A group contains a certain number of data items and is represented internally as set of item names together with their types Operations on a group may fail or only partially succeed if one of its elements is not currently in the data base The names of elements in the group window have different colours depending on their being in the data base The colour of a name is only updated when clicking or double clicking on it and so it can be wrong The group window may have at a certain time more than one selected element When this happens a replace will act on the first selected element from the top of the list deleting will act on all selected elements Inserting a new elemen
2. gt 2 9 e t ae e e tt Oe SE 86 6 3 Plug in code and execution 2 2 86 6 4 Pre defined plug ins sssaaa aa 86 7 Support for Lowrance Magellan and Garmin Receivers 88 7 1 Support for Lowrance receivers ee 88 7 2 Support for Magellan receivers e 88 7 3 Support for Garmin receivers oaoa e ee 88 A Lowrance supplement to the GPSMan Documentation 98 B Support for real time logging variant for the Lowrance 100 C Map Mouse and Keyboard Shortcuts 104 CT By Operations 2 5 2 9 Gwe ged A ee a Se OE 104 G2 By Event prada AS Oe aS ade a a aD 105 C 3 Notation for Events 0 0 00 ee ee 106 D Recent Changes 107 D 1 Versions 6 4 4 2 6 October 2013 and 6 4 4 1 15 July 2013 107 D 2 Version 6 4 4 5 April 2013 20 20 02 0020 22 eee eee 107 D 3 Version 6 4 3 29 April 2M 12 022 eee 107 D 4 Version 6 4 2 19 September 2011 2 0 0 2 020000 108 D 5 Version 6 4 1 30 December 2009 o 2000020000000 108 D 6 Version 6 4 October 2008 ee ee 109 D T Version 6 3 2 June 2000 r r yarani bape A eee ee ee doe Paces 110 D 8 Version 6 3 1 July 2006 sss degawe botia tea me k e he ea E 111 D 9 Version 6 3 May 2006 aa a E ea e ko e ee 111 Index 113 Chapter 1 Introduction GPS Manager GPSMan is a graphical manager of GPS data that makes possible the prepara tion inspection and edition of GPS
3. C available from the Garmin WWW site but not yet covering some new protocols for fitness oriented receivers Unfortunately this document does not describe all the protocols leaving out for instance those used for loading maps Some data fields are not directly accessible to the user but are nevertheless kept by GPSMan as hidden information as described above This is the case with the data on proximity distance facility name city state country code and class GPSMan identifies the receiver model when connecting to it for the first time in a session If the receiver implements the Protocol Capabilities protocol the list of protocols it uses is also obtained This will probably be the case with the more recent models Otherwise a table of protocols is looked up At present there are entries in it for the receiver models in the table below When GPSMan gets a list of protocols for a receiver not yet listed in the table a file is created in the GPSMan user directory and the user is asked to send it to the author of GPSMan This file should not be removed until the table is updated so that GPSMan knows these steps were already taken Some Garmin protocols allow transfers only in one direction for instance from the receiver to the computer In that case GPSMan will do nothing and will not warn if the user asks for a unsupported transfer When getting waypoints not defined by the user from the receiver those with the same name but differ
4. a easting and a northing both in metres by default user defined ones may be in feet The predefined grids are BMN Austrian Bundesmeldenetz BNG British National Grid BWI British West Indies grid CMP Portuguese military maps grid CTR Italian Carta Tecnica Regionale GKK German grid Gauss Krueger Koordinatensystem IcG Iceland grid ITM Irish Transverse Mercator KKJP basic Finnish grid KKJY uniform Finnish grid Lamb93 French Lambert 93 grid LambNTF French Lambert NTF Nouvelle Triangulation de France grid LambNTFe French Lambert NTF Nouvelle Triangulation de France zone II tendue grid LVO3 Swiss grid in the LVO3 frame RDG The Netherlands grid SEG Swedish grid TAlbers Teale Albers grid used in California USA 28 TWG Taiwan grid More details on these grids can be found below 4 15 e MH Maidenhead locator coordinates this is a special kind of grid used mainly for specifying the position of radio stations each smallest subdivision being 5 minutes in longitude and 2 5 minutes in latitude This means that conversions from other position formats to this one will most probably loose accuracy The altitude for a waypoint is given as a possibly signed floating point number in either metres or feet depending on the existing option for this A symbol and a display option are also chosen
5. coordinate positions in UTM UPS have four fields East zone number North zone letter x and y coordinates positions in other coordinates grids have three fields zone possibly empty easting and northing All fields are separated by a tabulation character blank lines are ignored except as terminators of remarks see NB command above file comments ignored by GPSMan start by a character that can be preceded only by spaces and extend to the end of line attribute value pairs that describe hidden information are written as follows the attribute name starts with a capital letter that uniquely identifies the brand of the receiver G for Garmin L for Lowrance M for Magellan the rest of the name depends on the implementation but normally will describe the protocol and the data field the value is a string containing standard ASCII characters excluding all control char acters i e all codes must be gt 32 and lt 127 the codification of the value is also implementation dependent for an example see the comments in proc HiddenCode in file garmin tc1 for compatibility with older versions some attribute value pairs no longer used for coding hidden information are still accepted when reading 64 4 19 2 Image information files These are files containing the following information l a Image P command with P the absolute path of the file containing the image in an accepted graphics format 2 a Datu
6. greater than MAXLONG and MAXLAT the common arguments being FILE the Shapefile to be read and PREFIX that is used for gener ating a file name for each quadrangle Shapefiles with points are not supported and altitudes are not kept The coordinates in the Shapefile are assumed to be in decimal degrees DDD in the WGS 84 datum it can easily be changed in the utility source All items read are saved as GPSMan polylines LNs in DDD format Each quadrangle file will also have a group GR with all its polylines so that it will be easy to display hide all of them at once the file starts with a comment giving the boundaries of the quadrangle The file name is of the form PREFIX_QUAD where QUAD is the quadrangle name each file is created in the current directory destroying any file under the same name 12 2 5 Data and examples The following data and examples are available from the GPSMan site the Waypoints in Portugal data set e data concerning some paragliding sites in Portugal track file for one sample flight computation results for that track and e a map of the same track in GIF or Postscript 2 6 Installation As stated before Tcl Tk preferably version 8 4 or later must be installed to run GPSMan It can be got from the Active State site at http tcl activestate com In Unix and Linux systems access to the serial or USB port is restricted This means that either there is a program to lock the port with
7. 4 Category Aviation Airport Seaplane base Radio beacon 1st approach fix Missed approach point TACAN Controlled Area Parachute Tower tall Heliport Soft field Danger avn Localizer outer marker ND beacon VHF omni range Restricted Area Glider Tower short 71 Private field Landing Take off VOR DME VOR TACAN Intersection Ultralight Chapter 5 Using GPSMan in Command line Mode The command line mode can only be used in operating systems supporting command line argu ments namely Unix Linux systems For the time being only Garmin receivers are supported in commands requiring a receiver In graphical mode GPSMan is launched by invoking gpsman or gpsman tcl with either no arguments or a single argument standing for the serial or USB device while in command line mode there will always be 2 or more arguments This is used to distinguish between the two situations although the graphical mode can be entered from command line mode The general form of invocation is in the usual Unix notation gpsman OPTIONS COMMAND COMMAND_ARGS Some commands accept parameters in the form NAME VALUE The term parameter when used here referring to arguments of a command has always this meaning Care should be taken if the value part is a string with spaces or other characters with special meaning for the shell or system command interpreter in which case quotes or some other form of quoting should be used The possible
8. Double 1 gt lt Shift 3 gt in two positions open waypoint menu if over waypoint Unix lt Control 1 gt non Unix lt Button 3 gt 104 add waypoint to route being edited on map if any delete waypoint from route being edited on map if any edit previous stage of route being edited on map if any edit next stage of route being edited on map if any open route menu if editing it on the map finish edition of route on map cancel edition of route on map lt Button 1 gt lt Shift 1 gt lt Control 3 gt lt Control Shift 3 gt Unix lt Control 1 gt non Unix lt Button 3 gt Unix lt Button 3 gt non Unix lt Control 1 gt lt Shift 2 gt C 2 By Event lt Key Up gt lt Shift Up gt lt Key Down gt lt Shift Down gt lt Key Left gt lt Shift Left gt lt Key Right gt lt Shift Right gt lt Key Delete gt lt Key space gt scroll up move map down slowly scroll NE move map SW slowly scroll down move map up slowly scroll SW move map NE slowly scroll left move map right slowly scroll NW move map SE slowly scroll right move map left slowly scroll SE move map NW slowly scroll up move map down fast scroll down move map up fast lt Return gt create waypoint lt Control Motion gt panning slowly lt Button 1 gt create waypoint or add waypoint to route being edited on map if any lt Double 1 gt open item if over item lt Control 1 gt
9. StreetPilot i2 the eTrex Venture and the Forerunner 305 with thanks to all those who sent protocol lists Philip Hands Rolf Werum Patrick Kik Waldemar de Laurent Jon Niehof Harry Jensen Alberto Ham Hans Peter Nilsson Jorge Sanchez Jeremiah Horner D 8 Version 6 3 1 July 2006 importation of waypoints from Kismet network files with location information asked by Bernd Stuht some new options on this should be configured by editing config tcl map window can now be resized WARNING Garmin USB support for some recent Garmin receivers will need at least version 0 28 of the garmin_gps Linux kernel driver updates to Garmin support following the specifications made available in May 2006 but not yet covering some new protocols for fitness oriented receivers explicit support for several Garmin receivers or their new firmware versions including GPSMAP 60CSX and 76CSX EDGE 205 and 305 GPS 18USB eTrex Legend Cx Fore runner 205 and GPS 60 with thanks to all those who sent protocol lists Doug Larrick Thomas Zumbrunn Jiri Dvorak Daniel Dorau Nenad Elric Milon Beltran Michel Equeter Dominic Hargreaves S bastien Roy Nicolas Brouard Reinhold Pschierer Sven Anders Jon Stockill D 9 Version 6 3 May 2006 new options 111 the information displayed when the pointer goes over a track point on the map can now be the point number or its date depending on a new option suggested by Hans Olzem font an
10. Tracks recorded with no image currently loaded will be saved in Blank trk as Blank n n O to 999 as above The plotting function is started from the GPS receiver Real time track log Get Log menu of GPSMan Use Lowrance protocol not NMEA From the Start log button a window will appear from which the logging interval can be set and the aut file loaded The plotting interval cannot be changed all points received will be plotted To stop plotting logging select GPS Receiver Real time track log STOP Interval defaults to 10 seconds At this setting the 12 hour log mentioned earlier would take approx 220 kb of disk space If disk space is at a premium increase the value of Interval accordingly If NMEA logging is all that is required use the GPSReceiver Real time track log Start Manual plot menu to start the software A map image can be preloaded but need not be If no image is loaded the map scale can be changed whilst plotting Manual loading is a useful way of using slow machines but introduces safety and convenience issues for single manned vehicles The track is automatically saved to disk default name NMEA1 trk when logging is stopped This trackname can be changed from the setup window before starting the log The exerciser tcl test sentence generator BEBO k k kkk k AG ak k ak ak 3k ak 3k ak k I IORI II A I aI Kak I 4 ok Note some Lowrance Eagle models include a Simulator which is preferable to the ex
11. all option for further details see the Tcl manual pages for regsub and re_syntax 10 accept if result is a new name the renaming process is finished if the current result is acceptable otherwise the following operators will be applied 11 generate names using a prefix followed by a number the prefix is the current result and the number has a specified number of digits numbers start from 1 and all possible values are tried until a new name is found if this fails no change is made on the current result 24 Examples of renaming methods are as follows e the following list of operators 1 keep first character 2 keep first character 3 insert 00 at the beginning 4 maximum length is 8 will convert Labrusques into La00brusqu i e the two first characters are preserved 00 is inserted at the beginning of the remaining string and the result of the insertion is cut down to 8 characters e the following list of operators 1 change case to upper 2 delete any AEIOU will convert all letters to upper case and then deletes all vowels e to make sure there are only upper case letters and digits and the length is at most 10 the following list could be used 1 change case to upper 2 apply the regular expression substitution A Z0 9 with an empty string this will delete all characters that are not upper case letters or digits note the after the opening bracket 3 accept if new stop if the current name is new 4 maximum
12. and not in use The operators available are 1 keep first character further operations will preserve the leftmost active character changing only the characters to its right the leftmost active character becomes the character to the right of the previous leftmost active character when starting the leftmost active character is the first character in the original name 2 reset forget the current result and restart with the initial name 3 change case change all letters to lower or to upper case 4 cut to the specified maximum length the current result is chopped at the right end so that it will not have more than the given lentgh 5 insert the given string immediately before the leftmost active character the leftmost active character becomes the first character of the inserted string 6 append insert the given string at the end 7 delete any delete all occurrences of any character in the given string 8 replace characters the two given strings must have the same length all occurrences of each character in the first string will be replaced by the character at the same position in the second string for instance applying this operator with strings AB and zC means that each A will be replaced by a z and each B by a C in this order left to right in each string making AMBOaXA into zMCOaXz 9 apply a regular expression substitution for users knowing what a regular expression is this is a call to the Tcl command regsub with the
13. between consecutive points the Law of Cosines will yield results with large errors and therefore it should only be used on very slow computers Bearings in GPSMan are always geographic True North 55 4 17 Real time logging At present there are two variants of the implementation that will probably be merged in the future Any receiver sending data in the NMEA 0183 v2 0 standard format can be used with GPSMan and can use any of the two variants This also applies to Garmin and Lowrance receivers For the time being there is no support for real time logging if the receiver is declared to be a Magellan Users of Lowrance receivers will want to use the variant for Lowrance Users of Garmin defined protocols be it the serial or USB Garmin protocols or the Simple Text Output Protocol should use the variant for Garmin Both variants implement some sort of simulator that can be helpful for tests and in getting acquainted with the interface before going to real time usage GPSMan will work with the variant corresponding to the receiver brand selected in the options dialogs After changing this option the program must be restarted because different code has to be loaded 4 17 1 Variant for the Lowrance This variant was designed and implemented by Brian Baulch baulchb_at_hotkey net au who has prepared a description of it that can be found in Appendix B The file exerciser tcl used for simulation by this variant can be found in the util d
14. can be got from and put into the GPS receiver while remarks are only kept by the interface and may be saved to and loaded from GPSMan files The characters allowed in a comment as well as its size depend on what the receiver accepts with the exception that GPSMan will replace any newline by a space In remarks the only constraint is that no blank lines are allowed A map background image name can be associated to each data item except for laps and groups so that when the item is displayed on the map window the named image is automatically loaded if the map is empty See below 4 13 for the details Forgetting a data item means deleting it permanently from the data base 21 Input Output operations in GPSMan have the following names see below for the definitions of the GPSMan file formats e loading from and saving to files in GPSMan format e getting from and putting into the GPS receiver this corresponds to the terms downloading and uploading respectively used in other software e importing from and exporting to files in a foreign format Currently recognized formats are given below 4 20 4 3 Names and renaming Data items have names or identifiers that are unique for each type of item no two items of the same type may have the same name There are important issues concerning names which characters can be used in them what is their maximum length and how to rename items either to avoid clashes with existing names or t
15. dates and of lowercase letters in strings In the distribution the values are set for use with a Garmin Quest e for Garmin receivers only whether or not routes should be automatically numbered when they are sent to the receiver default is no e for Garmin receivers only enabling support for laps default is no e for Lowrance receivers only sampling interval in seconds when acquiring tracks e default symbol and default display option to use with waypoints correct names for symbols and display options can be found in file symbols tcl e default for whether items read from a file should be displayed on the map e default line widths for representing routes tracks and polylines on the map e when displaying a track count of track points before showing point number or date 0 means no numbers 1 means all points numbered 2 every other point numbered and so on e what to show when pointer goes over a track point on the map either its number or its date e whether polylines on the map should react to mouse events they should not if they are considered as background information e behaviour when reading a data item with the same name as another item of the same type in the data base either overwrite the existing one or create under a new name e behaviour when a data item with hidden information is changed remove the hidden infor mation keep it or ask the user e distance unit to be used e altitude unit to be use
16. default to the average of the first points being mapped This projection although introducing large errors when used directly with ellipsoidal coordinates is generally used with the WGS 84 datum in map imagery available on the Web such as OpenStreetMap Nasa WMS Yahoo Maps Google Maps an alternative is the Equidistant Cylindrical projection A particular case of the Spherical Mercator is the EPSG 3857 projection also known as EPSG 900913 EPSG 102113 whose central point has latitude and longitude 0 with datum WGS 84 Large distortion is to be expected far from this central point The Stereographic projection is an azimuthal conformal projection used both for large scale and small scale mapping There are 3 possible aspects polar oblique and equatorial which are dealt with automatically by GPSMan A particular case of this projection is the Universal Polar Stereographic 4 15 2 that is used in the UTM UPS The Stereographic projection has three parameters the latitude and the longitude of the centre tangent point and a scale factor By default the scale factor is 1 and the coordinates of the centre are taken as the average of the latitudes of the first points to be mapped The Schreiber double projection is a variant of the Stereographic projection in which each point in the ellipsoid is first projected in a sphere and the resulting point projected in a plane that intersects the sphere This projection must be used with a da
17. e speed in user units e vertical speed in metres second and up down arrow indicators e type of receiver fix Other information only available when navigating e CTS course to steer 59 e TRK CTS indicator with an external compass ring current track pointing up and a CTS arrow e TRN turn difference between course to steer and true track e TRN arrow indicator e To current destination when following a route or track next point in it e From previous point in route or track e distance to current destination e ETA expected time of arrival at current destination e ETE expected time in route to current destination e VMG velocity made good velocity along the line from starting previous point to current destination in user units e XTK cross track error distance from current position to line from starting previous point to current destination in user units Navigation is started from the menu by selecting an objective which can be forgotten naviga tion stops suspended navigation displays are frozen and resumed Navigation to a point is made along a line of constant bearing with no drift wind or stream effects taken into account This means that the transport velocity is assumed to be null and that CTS the course to steer is taken to be the bearing to the point Computations use the so called plane sailing formulas that are commonly accepted as valid for distances up to 600 nautical miles Gardn
18. for each waypoint GPSMan symbols and display options may not all be supported by the receiver When GPSMan is aware of this a tilde will appear before the symbol name in the symbols menu Symbols and display options not supported will be transmitted to the receiver as the default values if these are also not supported the symbol will be transmitted as a waypoint dot and the display option as Symbol amp name User defined symbols of Garmin receivers will be shown as waypoint dots as there is no docu mented way of importing their images from the receivers Their code numbers are kept internally and in GPSMan data files These symbols do not appear in menus and therefore cannot be selected The symbols menu can have a sub menu defined by the user more details below 4 21 Symbols of all the waypoints in a group can be changed in a single operation as described below 4 10 A map background image name can be given for each waypoint so that when the waypoint is displayed on the map window the named image is automatically loaded if the map is empty See below 4 13 for the details Creating a waypoint can be made as for other items from menus and also in the following ways e at a given distance and bearing in relation to an existing waypoint from its window the maximum allowed distance is about 20000km more precisely 7 times the ellipsoid semi major axis if the distance is greater the new point will coincide with the old o
19. in perspective from the route window if there are at least 3 waypoints with a valid altitude field In side view graphs a button displays or hides vertical grid lines and clicking with the mouse left button will draw a line with the numbers of the waypoints at that horizontal coordinate Clicking with the mouse left button with the Control key depressed will show the number of the nearest waypoint its altitude and cumulative distance The Shift key and mouse left button will clear all these lines and information The perspective graph is shown from South but different viewing directions can be obtained by using the N E S W buttons or the Show button after the 15 15 degrees buttons The bearing scale shows the viewing direction in degrees that is the current one only when the Show button is disabled this button updates the graph The scale can also be used to change the viewing direction if the animate button is checked As the animation or a change of viewing direction may lead to a long computation there is an Abort button to stop it The menu from the View button allows for changes in the vertical or horizontal scales and to hiding displaying labels in the graph A N E S W cross is displayed in the graph and can be moved by using the mouse left button Clicking with the left button on a point of the route and then using the mouse middle button or left and right buttons in a two button mouse will move the whole graph Elevation graphs
20. in the log and defaults to 2 This command only works with Garmin receivers 5 8 The getfix Command The getfix command gets the current fix data from the receiver using the real time log and saves it to a file getfix PATH TIMEOUT where e PATH is the path to the output file unless it is stdout in which case output will be to the standard output Existing files will be silently overwritten e TIMEOUT is the number of seconds to wait for a good position fix before giving up If this argument is not given or is 0 the program will not exit before getting a good position fix If a good position fix was read the ouput will consist of the following lines latitude and longitude in decimal degrees separated by one space e datum WGS 84 for Garmin receivers e date and time formatted using the selected date format in the preferences file e bearing in degrees empty if undefined e horizontal speed followed by the units empty if undefined e vertical speed in metre second e expected position error EPE metre empty if undefined e horizontal expected position error EPH metre empty if undefined e vertical expected position error EPV metre empty if undefined e altitude metre empty if undefined This command only works with Garmin receivers 78 5 9 The getalmanac Command The getalmanac command gets the current almanac data from the receiver and saves it to a file getalmanac PATH where e
21. in these formats will not increase the data accuracy whether GPSMan data can be appended to an existing file when saving this should be used with care as a file with conflicting time offsets may result that will not be loaded by GPSMan choice of echo in password style entry boxes none or a character options used when importing Kismet network files which Kismet network types should be converted to waypoints symbols to use for each encryption under each type default symbol for encryption values not described in the previous option which prefix to use for names if the ssid is missing or name repeated initial number to add to the prefix when forming name 19 Jnew Chapter 4 Using GPSMan in graphical mode 4 1 Launching GPSMan If GPSMan was installed from a Debian or RPM package just call gpsman from a shell or from the applications menu of the window manager if it was set up by the package installation program When using a command line like the Unix Linux shell call gpsman tcl or use the shell scriptgpsman sh it must be configured first In this situation there could be a single argument with the path to the serial or USB port device or the call has the form gpsman OPTIONS start travel INTERVAL that will be parsed as if in command line mode 5 but then launches the graphical interface this will only work with Garmin receivers In the case of a single argument a USB port device can be given with the prefix
22. logging information while these operation take place this may be DANGEROUS if the logging information is crucially needed for navigation it is the user s responsability not to initiate such operations in these conditions e both Simple Text and the implemented part of NMEA 0183 are one way protocols infor mation is only sent from the receiver to GPSMan this means that it is not possible for GPSMan to check the connection with the receiver GPSMan will be passively waiting for information to appear on the serial port e Simple Text carries less information than Garmin PVT neither EPE expected position error nor EPV expected position vertical error while NMEA 0183 may carry more infor mation than Garmin PVT it is difficult to say more than this because there is no complete information on which NMEA sentences commands are sent by receivers Selecting the protocol in GPSMan is done in the GPSMan s receiver window using the Protocol menu or the entry with this name of the GPS Receiver menu Note that there is an option that defines the default protocol to be used If GPSMan was invoked by using the start travel command 5 11 the protocol will be either the default in the preferences file or the protocol given by the prot command option Two other entries in these menus start simulators of logging data that will be helpful in getting acquainted with the interface before real time usage e simulator generates random and somewhat
23. may be pairs under the form Attr Val where Attr is an attribute and Val the corresponding value attributes currently in use apart from those for hidden information alt for altitude either as a value in metres or as a list with value in metres value in external unit and external unit symbol possible values GPSMan symbol names see file symbols tcl dispopt possible values GPSMan display option names see file 63 symbols tcl mapback for the map background to load along with the waypoint if the map is empty After such a line there may appear a remark see NB command above A route waypoint must be given in full and not solely by its name as before version 6 1 there is a separate script in the distribution directory util file wpsinfull tcl to convert old files lines describing route stages only one between two consecutive route waypoints start by IRS followed by a tabulation a field with the comment a tabulation and a field with the label Attribute value pairs for hidden information may appear after a new tabulation and separated by tabulations Empty stages should not appear lines describing points in a track a T command appeared before have a tabulation char acter followed by a date the position the altitude and the depth each one either as a value in metres or as a list with value in metres value in external unit and external unit all fields being separated by tabulation characters If the altitude and th
24. points This will be useful for obtaining more precise coordinates for a waypoint by recording a track with the receiver standing still A track can be splitted by taking either each selected track point or segment starter as the first point of a new track extending up to and excluding the next such point Tracks with at least two points obtained in this way are created as well as a group with all of them These new tracks inherit the datum segments unless when splitting by segment starters width colour and map background of the original track but hidden information is discarded They and the new group get names generated automatically The original track is not affected by this operation A track can be converted into other sorts of line items by a simplifying algorithm that keeps a certain number of the track points as points of the new line which can be a route another track or a polyline When converting to a polyline information on segments is only used if all the points are kept 34 The algorithm that was developed for this may be seen as a variant of the Douglas Peucker algorithm for finding critical points in polylines see e g Heckbert and Garland 1997 or Li 1995 It starts from a straight line between the first and the last track points if the number of points to keep is greater than 2 any point that stands furthest from the line will be retained and the line is replaced by two new lines those from the first to the ne
25. see grid coordinates preferences changes 61 file 16 17 problems known 14 15 projection 18 41 48 49 Albers Equal Area 54 American Polyconic 55 associated grid 50 Austrian BMN grid projection 51 Basic Finnish Grid projection 52 British National Grid projection 51 British West Indies projection 51 Carta Tecnica Regionale projection 51 Cassini Soldner 55 confirm parameters 18 41 EPSG 32663 55 EPSG 3857 900913 102113 54 Equidistant Cylindrical 55 Gauss see projection Transverse Mercator Gauss Kruegger see projection Transverse Mercator German Grid projection 51 grid see grid coordinates Hungarian National Projection 52 Iceland Grid 53 Irish Transverse Mercator Grid projection 51 Lambert 93 grid projection 53 Lambert Conic Conformal 52 Lambert Equal Area Conic 53 Lambert NTF see projection Lambert NTF grid projection Lambert NTF tendue grid projection 53 Lambert NTF grid projection 53 Lambert NTF ITlet see projection Lambert NTF tendue grid projection Mercator 54 spherical 54 Netherlands Grid projection see projection Schreiber Plate Carree 55 Portuguese Military Maps 52 116 Schreiber 54 small scale maps 49 Spherical Mercator 54 Stereographic 54 Swedish Grid projection 52 Swiss LV03 Grid projection 52 Swiss Oblique Mercator 52 Taiwan Grid projection 52 Teale Albers grid projection 54 Transverse Mercator 51 particular cases 51 TWG projection see projection
26. systems After unpacking the files use tar xzvf gpsman 6 4 4 2 tgz the GPSMan main file gpsman tcl should be edited for configuration see below 3 and put where it can be executed The other GPSMan files should go into the directory whose path is given at the beginning of gpsman tcl 13 The package includes a file gpsman sh in the util directory that is a shell script to call gpsman tcl in graphical mode with no need to give the serial port as argument This file should be edited for configuration and placed where it can be executed 2 6 3 Launching the program from the command line The program is launched by calling gpsman or gpsman tcl that may have no arguments or a single argument with the path to the serial or USB port device in which case the graphical interface will be used or 2 or more arguments in which case the command line mode will be entered An exception to this is the call gpsman OPTIONS start travel INTERVAL that is parsed as if in command linde mode but then launches the graphical interface this will only work with Garmin receivers In the case of a single argument a USB port device can be given with the prefix usb as in usb dev ttyUSBO to enforce the use of the Garmin USB protocol when this is not the default protocol 2 6 4 MacOS X systems GPSMan can be run under MacOS X systems by installing a suitable Tcl Tk package and by using a USB to serial adapter The following configuration is known to
27. there is the option of reading either the items whose names are not in the list of names GPSMan builds or the items having the names in that list The former is useful for preserving data in the selected groups items that are not in the data base will also be read in The latter is useful for updating or restoring the information in the selected groups without affecting the other data items that are not in the data base will not be read in All items of non selected types will be discarded except waypoints belonging to routes if the route type was selected 39 e when putting to or getting data from the receiver or when exporting or importing informa tion to in any foreign format with a single type per file a single type apart from Group must be chosen e when getting information from the receiver the Track type cannot be used There are two reasons for this there is no point in updating or changing previously recorded tracks and some receivers do not keep names for tracks Examples of using a group when putting are as follow For transferring to the receiver the waypoints that belong to some groups select the type waypoint and then select the relevant groups This will result in an inspection of each selected group for gathering the waypoints in its list that are currently in the data base All these waypoints will be transferred In some cases it is useful to transfer not only the elements of the selected groups but also
28. to 180 cross track error in excess limit user units The configuration of the travel navigation displays warnings arrival distance and parameters for changing goal are kept on the saved state 4 18 Miscellaneous e changes in option values in some cases do not take effect immediately but only after GPSMan is restarted Some care should be taken to avoid inconsistencies due to this In particular changes in the distance unit affect the possible values for the initial map scale so that a change in the latter is normally needed in the next session after changing the former e in order to prevent inconsistencies windows presenting results that depend on the definition of an item such as computations or graphs may be but is not guaranteed to be closed by GPSMan when the item changes after being edited or being replaced when data is read in e anything that looks like a button normally s a button e closing a window from the window manager may cause data to be lost and GPSMan may be unable to create it again e at any time only one waypoint one route one track one polyline and one group may be open for editing other such items may be viewed but not edited 61 e when exiting from the program GPS Manager button or ctrl c in the GPSMan windows unsaved data will be lost unless the interface state is to be saved see above 4 4 As saved state files will be overwritten automatically by GPSMan it is a good idea to save import
29. waypoints of groups This will only happen when reading from a file in GPSMan format having groups in which there are different waypoints under the same name 23 To minimise the problems with these situations GPSMan creates a group containing the items that were renamed and those for which there may be ambiguities after any input operation in which they occur Renaming methods for waypoint names can be defined and inspected by the user from the Definitions menu Each method gives a sequence of operations that are applied to the original name in order to get a new name If the resulting name is not already in use it will be given to the waypoint otherwise GPSMan falls back to its default method of generating names Each renaming method has a name a remark and a textual description of the operators to be applied in order one per line The list of operators is edited from a dialog that opens up by clicking on the text This dialog shows the same text which can be cleared Clear all button and where an operator can be selected and deleted Delete button or moved up or down dragging with the mouse right button The buttons under the Add label correspond to operators that can be added to the list some of them having parameters At the end of the dialog there is an area for experimenting the current definition on a given name clicking on the Apply button the resulting name is shown together with an indication on whether the name is acceptable
30. 0 Chinese XL GPS II _ Plus GPS III _ Pilot Plus GPSCOM 170 190 GPSMAP 60 60C 60CSX 76 76S 76CSX 135 Sounder 162 175 176 180 195 196 205 210 215 220 235 Sounder 276C 295 378 SYS GPSMAP 130 _ Chinese GPSMAP 230 _ Chinese Quest Rino 110 120 130 530HCx StreetPilot 3 I 12 c320 c330 c340 2720 90 Acknowledgements Thanks are due to e Alberto Morales amd77_at_gulic org for contributing the support for Spanish and for his suggestions e Alexander B Preobrazhenskiy modul_at_ihome ru for contributing with translations for Russian e Alessandro Palmas alpalmas_at_tin it for his implementation of elevation graphs for routes and tracks for providing continued support for Italian for contributing the exportation of data in OziExplorer format and for his help in debugging and his suggestions for improve ments e Anders Lennartsson anders lennartsson_at_sto foa se for permission to translate code in GPStrans for the Swedish grid coordinates e Andreas Lange Andreas C Lange_at _GMX de for providing continued support for German and the description of the GKK projection e Andy Walls cwalls_at_radix net who provided pointers to Gamin protocol specifications available in different documents on the Garmin site e Asbj rn Djupdal asbjoern_at_djupdal org who provided invaluable help including remote access to his desktop and receiver in making experiments with a first imple
31. BGA MS E Goede ersten a Be Ee a A ol 30 di Tracks da fe Kt yy Sa a Gah BGA Dh ule fe Doe Aaa BE eR AA ol 32 AS PONS ase eek ba A Pe O da a ee o EA ads gS 35 AQ Taps t a eee eb eal ee Ro Ee at eee eo Rae G 37 AMO CLOUDS tendo A a ae A ee ah ee ee ea Ba M aa 37 41 Searching for data tes sw 4 2d fe a a le ee he HE ak 40 AZ Mapes aie a Ste ah em eee eed aly hae we At ath edie ey a Se IAEA A 41 4 13 Map background Images 44 4 13 1 Geo referencing an image 000 000 eee ee 45 4 13 2 Coordinates transformations 0 e 46 4 13 3 After geo referencing an image 00002 eee eee 48 4 14 Datums and ellipsoids e 49 4 15 Projections and coordinate grids o a 49 4 15 1 Selecting and defining projections o e 49 4 15 2 Predefined projections and grids o o o 0 20000 51 4 16 Distances and bearings e e o 55 4 17 Real time logging o ea a a ee a ee ea ae 56 4 17 1 Variant for the Lowrance 2 20 e 56 4 17 2 Variant for the Garmin 20 0000 00000000000 56 4418 Miscellaneous w o EEE ie dea BE koe ead de 61 ATONGPS Man Files 2 Ac e aha Soe Bat RPE e SG Ss Sy NE A ee ce aed 62 4 19 1 Item information files 2000000000000 0000004 62 4 19 2 Image information files o 0000000000000 65 4 19 3 Least Squares files s o e e e e 65 4 19 4 Map information f
32. D Christensen Gracjan Ziolek Louis Mandelstam Dan Hobner Peter Van Loock Aapo Rista Chuck Cox Alexander Damyanov Joel Staker Pierre Thibaudeau Russell Nel son William D Hamblen Jerry Walker Vlatko Kosturjak Alan Rogers Peter MacDonald Luca Marletta Ariel Garcia Cliff Dugal Imre Simon Jos Maria Alonso Dennis Langen feld Eric Smith Simon Wood Al Nikolov Oliver Theis Chris Smith Jan Arne Fagertun Marques Johansson Dan Bluestein Steven Kollmansberger David Bannon Harry Palmer Wes Johnston Frank Sommer Doug Larrick Thomas Zumbrunn Jiri Dvorak Daniel Do rau Nenad Elric Milon Beltran Michel Equeter Dominic Hargreaves S bastien Roy Nico las Brouard Reinhold Pschierer Sven Anders Jon Stockill Philip Hands Rolf Werum Patrick Kik Waldemar de Laurent Jon Niehof Harry Jensen Alberto Ham Hans Peter Nilsson Jorge Sanchez Jeremiah Horner Wouter Amsterdam Facundo Ariel Perez David W Capella Hiroshi Iwamoto Andr s Veres Szentkir lyi Steven Winikoff Stefan Heller Greg McQuat Andy Walls Jeff Hanson Gerry Creager Paul B Hoch Johann Spies Bruce Dawson Bogdan Hlevca Ralf Kleineisel David Antliff Slaven Rezic Matthias Wenzel Lovro Palaversa Adrian Lawrence Oliver Hegner David P Brown M Gutman Jean Yves Sage Damien Porquet Vincent Arkesteijn Patrice Arnal Zvi Grauer James B Mehl Ken Stephens Elven Decker Bill Rainey Thomas D Dean Mark N Reihart Pekka Ahoi Alexander B Preo
33. GPS Manager User Manual Miguel Filgueiras migfilg t online de 6 October 2013 Contents 1 Introduction EL S OntributOrs 4 260644 diri eb gle a A ed aa 1 27 Main teatre AS E ae eee E A A Programs 21 Current Version e d did dra a ir rd he E Ai 2 2 Downloading GPSMan src a ee a hk ee 2 3 External utilities cr dona wale SE See GAS ee Ab oo eee 2 4 Separate GPSMan utilities 2 2 ee 2 4 1 MapBlast waypoints e 2 4 2 MapsOnUS routes e 2 43 GreenFlag routes ee ee ee 2 4 4 BGA DOS turnpoints 0 0 0 0 0 0000000000004 2 4 5 Splitting a Shapefile into quadrants 0004 2 5 Data and examples 0 0 0 eee ee 2 60 Esta lltIO LAA a A A A E AA a ee 2 6 1 Debian and other Linux distribution packages o 2 6 2 Other Unix and Linux systems e 2 6 3 Launching the program from the command line 204 MacOSX systems midi pb a a Pu hs 26 5 Other systems eiii a wee doe a a Gad ar ld 217 Known problems 0 aora a a da 3 Configuration 16 4 Using GPSMan in graphical mode 20 4 1 Launching GPSMan o 64 4405 deb do o A e Od ew kh a de 20 4 2 Basic CONCED S fb oh dd de a a at Ale a ew ee Hes 20 4 3 Names and renaming corea a ee nh ele a A 22 dde Data os geese eG A AR ae ats eG ae ees AE atte oo ee RD A ee a 25 4 5 Waypoints id ee ae ae OE EA ata a BA e 27 AG ROUTES 0 caps ds he GS sae al chats ga
34. Least Squares fit method They follow the same conventions as other GPSMan files and contain the following in the given order 1 optional Format P T D Position P and or Datum D commands 4 19 1 in any order describing the position format and datum to use WGS 84 and DDD being the defaults 2 lines for each point with fields separated by tabulations in one of the formats a the position in the selected default datum and format and the pixel coordinates b the command W a waypoint name and the pixel coordinates the pixel coordinates given in the order horizontal vertical with vertical coordinates in creasing downwards There must be at least 3 points and waypoints referred in the file must be defined beforehand 65 4 19 4 Map information files These are files currently used only for saving the state of the map when there is no background image They follow the same conventions as the image information files and contain the following commands a Map command a Datum D command with D the datum name for the coordinates a Projection NP As command with NP the name of the projection to use and As a sequence of attribute value pairs under the form Atr Val describing projection parameters the tabulation is used as separator for NP and each pair a Transf NT As command with NT the name of the coordinate transformation to use and As a sequence of attribute value pairs as in the previous c
35. M coordinates for the WGS84 datum note that a Shapefile set can only have items of a single type The command translate gpsman data myWPRTs gpsman WP data myWPs creates from the same input file a GPSMan file data myWPs that only has the waypoints With translate gpsman data myData itoffset 1 gpsman TR data myTRs does a similar thing with tracks but assumes the time offset of the input file is 1 1 hour less than UTC overriding the value given in the file 5 13 The project Command The project command that can have no options writes to the standard output the projection of a point project LATD LONGD DATUM PROJECTION PARAMS where e LATD LONGD DATUM are the latitude and longitude in signed decimal degrees and the datum of the point to project e PROJECTION PARAMS defines the projection to use and its parameters if no datum X pa rameter is given the datum of the point is used use show projections 5 3 for a list of the available projections and their parameters The result consists in two numbers corresponding to the x and y coordinates of the projected point In the case of projections related to grids except for UTM no false easting or northing is added Information on zones is not given 5 14 The georef Command The georef command that cannot have options writes to the standard output a GPSMan map information file 4 19 4 containing geo referencing information for an image georef IMGPATH TRANSF LATD LONGD LATD LO
36. NGD LATD LONGD DATUM X Y X Y X Y PROJECTION PARAMS 81 where e IMGPATH is the path to the image file e TRANSF is the coordinates transformation to use the command show transfs 5 3 produces a list of the available transformations e the LATD LONGD pairs and DATUM are the latitude and longitude in signed decimal degrees and the datum of the 2 or 3 control points whose pixel coordinates are the X Y pairs in the same order the origin of the pixel coordinates is the top left corner of the image and the y coordinates increase downwards e PROJECTION PARAMS defines the projection and its parameters if no datum X parameter is given the datum of the points is used the command show projections 5 3 gives a list of the available projections and their parameters 5 15 The geopicts Command The geopicts command geo references files e g picture files from a digital camera either based on their time stamps and a given track or by using the sequence of waypoints in a group The result is a file with waypoints at present in GPX format that can be suitable for use with World Wide Web applications geopicts IN FORMAT IN PARAMS IN TYPE IN PATH PROC PARAMS OUT FORMAT OUT PARAMS OUT PATH PICT PATHS where e IN FORMAT IN PARAMS and IN PATH are the input file format its parameters if any and path use show formats 5 3 for a list of the currently accepted formats e IN TYPE is the data type to read the possible t
37. Ostermann Aachen University of Technology It translates HTML pages produced at the MapBlast site in answer to queries under the Directions section the pages should be saved locally and then opened from the program 2 4 2 MapsOnUS routes mou2gmn tcl converts the routes listed in HTML pages of the MapsOnUS site into GPSMan files At its core is code contributed by Frank Kujawski Frank_at_Kujawski org It translates HTML pages created at the MapsOnUS site as follows go to the General Options under the Tools menu select Show Latitude amp Longitude plan a route jump to turn by turn directions hit the non tabular format link and save locally the HTML page These files are then opened from the program and the resulting files will contain the routes and their waypoints The remark fields of the waypoints will have the directions in the HTML pages 2 4 3 GreenFlag routes gf2gmn tcl converts the routes listed in HTML pages of the GreenFlag site into GPSMan files At its core is code contributed by Nigel Orr gps_at_river view freeserve co uk It translates HTML pages produced at the GreenF lag site link not working on June 2007 as follows e enter the route details e select Step by step maps under directions style down on the page 11 e select Get Directions e save the page you get HTML only the maps are not needed The saved pages are then opened from gf2gmn tcl 2 4 4 BGA DOS turnpoint
38. PATH is the path to the output file unless it is stdout in which case output will be to the standard output Existing files will be silently overwritten The output will consist of a line with the field titles separated by commas and a line for each satellite with the field values separated by a single space If the satellite identification numbers are missing the order of the lines is the one provided by the receiver and is expected to follow the satellite numbers from 1 to 32 This command only works with Garmin receivers 5 10 The read Command The read command reads a data file and launches the graphical interface for its meaning in GPSMan scripts see the exec command 5 17 read FORMAT PARAMS TYPES PATH where e FORMAT IN PARAMS is the input file format and its parameters if any use show formats 5 3 for a list of the currently accepted formats e IN TYPES are the data types to read the possible types depend on the format and some formats impose that there is a single data type per file they may be absent if the format requires a unique data type or if the files can have items of different types all can be used as an abbreviation of WP RT TR e PATH is the path to the file to read from or in the case of the Shapefile format the path to the Shapefiles basename file extensions will be discarded If the PATH is stdin input will be from the standard input unless the format is the Shapefile format in which case t
39. Taiwan Grid projection Uniform Finnish Grid projection 52 user defined 50 UTM UPS 51 world maps 49 protocol Garmin 56 88 PVT 56 Simple Text 56 USB 88 Lowrance 98 Magellan 88 NMEA 0183 56 88 100 put 22 real time log 56 61 Garmin variant 56 61 animation 57 control 57 create TR 58 information 58 protocols 56 57 simulators 57 time interval 58 travel navigation 59 Lowrance variant 56 100 simulator 56 Magellan 56 receiver brand 17 22 23 56 Garmin 88 Lowrance 98 Magellan 88 comments 17 dates 17 lowercase 17 22 model 89 names 17 no of items 17 parameters 17 protocols 17 57 sampling interval 17 restore saved state 26 route 20 30 32 area enclosed by 32 change on map 43 colour 30 create 25 34 43 deleted WP 30 elevation graph 31 MapsOnUs 11 name 23 numbering 17 23 operations on 30 splitting 31 stage 21 30 comment 21 label 21 to TR 31 width 17 30 RT see route sample data 13 save 22 38 62 state 18 26 61 62 to PS 18 31 41 search 40 41 by distance 40 domain 40 pattern 40 results 41 serial port 16 20 Simple Text protocol see protocol Garmin Sim ple Text speed graph 34 symbols 29 68 71 change in group 39 custom menu 68 default 17 of general use 69 of use in aviation 71 of use in land 70 of use in water 70 symbols tcl 17 Tcl Tk 10 15 89 time offset 18 62 80 TP see track point s
40. a previous replacement name in the current input operation there is no check on whether the name is listed in a route or a group The user can also choose to cancel the renaming in which case the waypoint is ignored This will cause an inconsistency if it belongs to a route A renaming method 4 3 can also be applied to waypoint names from 22 e the waypoint sub menu under Data in the map window e the waypoint menu in the lists window e a group window Use WPs gt Change Name gt Allowed characters in route names also depend on the brand of the receiver Although some receivers require route names to be numbers there are others accepting letters and other characters as well GPSMan does not check the characters in the route name but will refuse to output a route with a non numeric name to a receiver or file if the receiver protocol or the file format disallow it When working with Garmin receivers GPSMan will if the option on this is selected au tomatically give numbers to routes with non numeric names when putting them on the receiver avoiding numbers already in use for routes and without affecting the data base There is a counter for this initially set to 1 and that can be reset from the receiver window or the receiver menu Put gt Route gt Set counter to 1 A unique name is used for each item of each type When a new item is read in and it has the name of an item of the same type in the data base the latter is forgotten
41. a suitable format will yield correct values When reading a polyline from a file positions may also be shown as undefined in which case the position format should be changed Each polyline point has a position and possibly its altitude in either metres or feet depending on the existing option for this A point can be changed by double clicking on the corresponding line in the list of points of the polyline edit window A polyline can be subdivided into segments and the segments will be drawn unconnected when the polyline is displayed on the map The first point always starts a segment and any other point can be marked as a segment starter from the polyline edit window by using the mouse right button on the last column of the points list A polyline can be created from a track see above 4 7 A polyline can be created by drawing on the map as explained below 4 12 The edit window for polylines allows some operations on polylines that may be useful to clean uninteresting start or end parts or to compose a single polyline from others They are e Chop head all polyline points from the first to and including the first one selected are deleted if there is no selection the first point is deleted e Chop tail all points from and including the last one selected to the last are deleted if there is no selection the last point is deleted e Include before or Append the points of a polyline are put before the firs
42. ach of these lines When the mouse is moved the 2 wayponts will move on these lines until the user clicks the left button to place them both at the same time The operation is finished by clicking on the Ok or Cancel buttons of the dialog window It is a fact that for the affine conformal no rotation transformation 2 waypoints would be sufficient However GPSMan asks for 3 to be placed so that the user may place 2 of them at the same time in this way having more control on positioning errors The 3 waypoints should form an almost equilateral triangle that can be shown in the map window The order of the 3 waypoints is important as the first one cannot be moved after being placed This waypoint then should be such that there are no doubts on where it should go It will be shown together with lines that will contain the other two and will be placed by clicking the left button The other two will be placed as a pair in the same way scale changes being displayed The affine conformal and affine conformal no rotation transformations are particular cases of the affine transformation If possible the latter should be used as it is more accurate Using a transformation file is an alternative way of fixing the coordinates transformation and its parameters At present there is support for the following formats e TFW file Tiff World file e Ozi map file e GPSMan Least Squares file Files of the first two formats contain pa
43. ame comment and or remark distance to a given waypoint or location given by its coordinates for waypoints and tracks symbol for waypoints waypoints for routes start date for tracks e GPSMan provides conversion between different position formats latitude longitude in DMS DMM DDD or grades and several grid coordinates including UTM UPS and or differ ent datums there is support for user defined datums ellipsoids projections and related coordinate grids e GPSMan allows the user to change its configuration providing a choice of languages Dutch English French German Indonesian Italian Russian Spanish and Portuguese in the cur rent distribution and accepting new values for parameters related to the GPS receiver default settings and concerning interface appearance colours dimensions positions e GPSMan can be extended through pre and user defined plug ins coded in Tcl Tk What GPSMan does when in command line mode e GPSMan makes availability and connection checks GPSMan provides information on its version the supported protocols data file formats projections coordinates transformations datums symbols and available commands GPSMan connects to the receiver gets data the real time log the current fix or almanac data and stores them in a file GPSMan reads data from a file in a user selected format connects to the receiver and transfers the loaded information to it GPSMan
44. and if no name is given one is automatically generated If they are defined beforehand it is a good idea to use either no symbol or to use the Mark x symbol so that later on they can be placed exactly where they should be on the image If the transformation is the affine conformal one 2 waypoints will be needed and the other transformations 3 In the latter case the waypoints should be chosen so as to form an almost equilateral triangle in order to minimise positioning errors After defining any control waypoints either the entry Map gt Background gt Load from the Map menu button if the main window is the map window or the entry Load of the Background menu button if the main window is the lists window should be selected The image file to be loaded is then chosen Dialog windows will allow for the selection of the transformation to be used and the waypoints that will serve as control points The image is then presented in the map window In the case of the affine and affine conformal transformations or the Least Squares method each waypoint is placed by the user over the image where it should be and its name and position entered if it did not exist If the affine conformal no rotation transformation was selected the user is asked for the names and positions of the control waypoints to be defined if there are any One of the waypoints is placed first and 2 lines will de drawn Each of the other 2 waypoints must be on e
45. and overwritten Exceptions to this are waypoints with the same name and different positions 1 if the renaming option was previously selected by the user 2 when getting data from a Garmin receiver if the waypoints were not defined by the user in which case automatically generated names will be used for them It should be noted that 1 all input operations with the exception just mentioned are destructive new items will replace data base items having the same name This is the behaviour of most GPS receivers and avoids having obsolete information in the data base 2 the test for the equality of waypoint positions may fail because of rounding errors at least when the comparison implies a change of position format or a change of datum Renaming raises the problem of generating a new suitable name for the item Currently GPSMan will try to keep the first part of the old name following it by digits If the constraints on name length and uniqueness cannot be met the new name will be a two letter code for the item type and a hyphen followed by a number When an item is renamed its previous name is kept in the remark field When generating a name for a new item or for replacing names with unacceptable characters GPSMan will use a name with a two letter code for the item type and a hyphen followed by a number except in the case of routes for which a number will be used Renaming waypoints can lead to ambiguities in what are the actual
46. ant data to a file before quitting the program e operations that can take a long time are either subject to confirmation if they can not be interrupted or can be controlled from a slow operation dialog window if the option on this is selected This window has an Abort button for cancelling the operation and a text box where all the error messages during the operation are collected When the operation ends the window is closed automatically if there are no messages otherwise it must be closed manually 4 19 GPSMan Files GPSMan uses text files to store data The Load Save options in the menus deal with files in GPSMan format The Import Export options deal with files in foreign formats In the GPStrans format described in the documentation of GPStrans all positions are exported in DDD format although any available position format is accepted in imported files Files in GPSMan format can be either item information files with data of different types waypoints routes tracks polylines laps and or groups or image information files for saving information on background images for the map These file formats are independent of the language used That is there will not be commands in Tobagonian even if a lang tcl file was provided for it and GPSMan was set to use that language 4 19 1 Item information files Item information files in GPSMan format based on the GPStrans format are as follows e lines whose first character i
47. ap with time stamp T After the name and a tabula tion fields separated by tabulations give the duration hours minutes seconds minutes seconds or seconds total distance metre begin position end position calories track index A position may be empty and if not has its sub fields sepa rated by a space After such a line there may appear a remark see NB command below These lines are ignored if the support for laps is not active G M definition of a group named M After such a line there may appear a remark see NB command below Next lines up to another data command format definition command or end of file describe the group elements NB T text remark T for waypoint route track line or group must appear after a R T G or LN command or after a line describing a waypoint The text is terminated by a blank line Ancillary commands used to describe route stages RS to define the type of group elements see below GW GR GT GL GLAP and GG to begin a different segment of a track except the first one TS to begin a different segment of a polyline except the first one LS lines describing waypoints a W or R command appeared before have a name a comment a creation date but see the Creation command and a position all these fields are separated by tabulation characters After these fields in the same line and also separated by tabulations there
48. at the waypoint belongs to the quadrangle of given latitude and longitude ranges whose middle point is the centre It is obvious that the first condition will be much slower to evaluate than the second and therefore making clusters based on quadrangles should be preferred when the number of waypoints currently defined is large Each cluster will be created as a group its name is of the form Cluster n and its remark has the name of the centre and either the quadrangle dimensions or the distance range Input output operations on the elements of a group allow for selecting which items of which types to read or write In general the user will choose the groups and the item types for the operation Then GPSMan collects in a list the names of the items of the given types that belong to the selected groups and that are currently in the data base This list of names is used to perform the I O operation Selecting the Group type means that the search for items will be done in the groups that are elements of the selected groups recursively In more technical terms the resulting list may be seen as a flattening of the group structure In no case the list of names will contain names of groups Details of each specific operation are as follows e in output operations the All menu entry means that all groups will be considered When writing elements to a file this also means that all suitable types should be considered e in input operations
49. ated on the map by using e the Edit on map button from the route edit window there must be at least one waypoint in the route or e the Start RT entry of the menu corresponding to a mapped waypoint when no route is being edited the route edit window will be opened and the waypoint becomes the route starting point In either case changes made on the route on the map will appear in the route window The cursor will show the current insertion point that at first is the end point of the route but that can be moved to in between any two waypoints of the route if there are as many this may be seen as changing the corresponding route stage Edit operations are performed by using the mouse buttons and the Shift and Control keys and or by using a menu that will appear by pressing the Control key and clicking the mouse left button not on a waypoint Clicking with the mouse e left button on a waypoint adds it to the route a waypoint cannot follow itself in a route e left button where there is no waypoint creates a new waypoint and adds it to the route if the operation is cancelled the waypoints created this way will be discarded e left button together with the Shift key removes the previous waypoint from the route unless there is only one e right button in Unix Linux systems or Control key and the mouse left button in other systems stops the route definition from the map if there is a waypoint under the cursor it will be adde
50. aving exporting or displaying a route with undefined waypoints will be prevented with a warning Routes have a colour and a width in pixels used in displaying it in the map A map background image name can be given for each route so that when the route is displayed on the map window the named image is automatically loaded if the map is empty See below 4 13 for the details A route can be created from a track see below 4 7 A route can be changed or created by drawing on the map as explained below 4 12 To change a route stage a double click with the mouse left button should be made on one of the stage fields in the route edit window An edit window will pop up that must be used and closed before going on Changes in a waypoint belonging to a route being edited inspected will be reflected in the route window When modifying a route the coherence of its waypoints and its stages cannot be checked by GPSMan For instance when adding a new waypoint after another one the stage starting from the latter is not affected and when replacing a waypoint by another one the stages ending on and starting from it are not affected The edit window for routes allows some operations on routes that may be useful They are e Delete delete all selected waypoints 30 Insert before or Insert after insert a waypoint before or after the respectively first or last selected waypoint if there is no selection the insertion wi
51. barometric pressure altitude positions in 2D fixes are discarded if the latitude and longitude are 0 and there was no previously accepted fix or if there is a change of more than 5 degrees either in latitude or longitude from the 66 previous fix a valid fix after a discarded one will be marked as a segment starter in the track the track name will be that of the file without any extension unless the name is in use the remark field indicates that barometric altitudes were used if that is the case and the file name if it is not the track name a datum number of 999 is taken to mean WGS 84 Kismet network files with location information networks with valid position information and of pre configured types are imported as waypoints whose symbols will depend on the network type and encryption mode each waypoint will have the average coordinates of the maximum and minimum locations of the corresponding network names will be either the SSID name or if that is not acceptable or is in use a generated name generated names and channel information will appear in the remark fields some options can be changed by editing the file config tcl and redefining the KISMETOPT array elements there is a single parameter for enabling the creation of a group with the imported waypoints for each type of network KML files for use with Goggle map products for exportation of waypoints routes and tracks and importation of waypoints MapEdit Polish for
52. brazhenskiy Fred Weijs Mario Borgnia Justin Arundell Julian Barragan Martin Espinoza and anonymous those who sent screenshots of GPSMan use Eric Spierings Luca de Alfaro Mathias Her berts Tim Jacobs Wolfgang Rupprecht Tony Mollica Andrey Semiuglov Ron Thomas John Madore Kevin Geiss Russell Senior Urs Forster Scot E Wilcoxon David Fletcher Dragan Milicic Anto Veldre Slaven Rezic Ronaldo Reis Jr Tomasz R Surmacz Andreas Hiinnebeck Kenneth Ingham Gianluca Interbartolo Victor Yip Siegfried Leisen Christian Hubbauer David Klotz Paulo Quaresma Christian Potthoff Ron Schmars Paul Makepeace Louis Mandel stam Dan Hobner Chuck Cox Paolo Cavallini Meinolf Braeutigam Pascal Brisset Stefan Nickl Joakim Majander Graham Meadows Frank Mohr John Francis Lee Jens C Ras mussen Balazs Lengyak Daniele Scarselli Delbert D Franz Wes Johnston Johannes Bit terling Juraj Lehuta Matthias Prinke Bert Lange John Martin Mark Boal Tim Jacobs 95 Simon Wood Menashay Tomasz Motylewski Franz J Polster Greg Metcalfe Kevin R Bat tersby Josh Freeman Matt Wilkie Kari Likovuori Cvetan Ivanov S bastien Roy Bernd Stuht Marc van der Sluys Terry Feldman Jon Niehof Jeremy Dinsel Tomi Ollila Leonardo Boselli Steve Brown Carlo Dietl Stephen Berryman Peter Fiserloh Hans P Stroebel Rob Gom Rogier Wolff lan Gibbs Martin Lthi Wilhelm Spickermann Ute Platzer Han Holl Richard Zidlicky Miguel Pauli
53. can be displayed from their edit show windows a button for this is created only when such information exists Saving the program state when exiting is controlled by an option that may inhibit this feature do the saving if the user confirms it or do it without asking When saving the state files in the user data directory are created that contain the current data base the map state and information on which edit show windows are currently being used No information is kept on 1 the state of the communication with the receiver 2 the changes in pending edit operations or items partially defined 3 the state of computation elevation and real time log windows The saved state is automatically loaded when GPSMan is launched and finds a saved state file in the user directory There is an option to control whether to delete saved state files after the state being restored it can be set in the same way as the save state option In any case GPSMan automatically overwrites saved state files when saving a new state and it is therefore a good idea to save important data to a file before quitting the program 26 Note that in command line mode the saved state is not restored and the state is not saved Other information can be retrieved from the receiver and displayed as text that can then be saved to a file without being stored in the data base At present this is the case with GPS almanac data only implemented for Garmin receivers The foll
54. can be saved as a Postscript file or further processed e g printed in Postscript cf the print command option 3 or saved in other graphics formats if the Img Tcl Tk library is available This library has two problems when saving an image 31 e any window or icon over it will also be part of the saved image and e depending on the format errors can occur if the image has too many colours The area enclosed by a route can be computed under the following conditions badly wrong values will result if they are not met The route stages are taken as sides of a polygon and if the last waypoint is not the same as the first a virtual side from the first to the last waypoint is considered The polygon must be non intersecting there can be no multiple occurrences of waypoints apart from the first one being also the last and no intersections of the polygon sides GPSMan will only check for multiple occurrences of waypoints The method for computing areas is an approximate method that is not reliable when there are sides of the polygon too small when compared to others or there are very small angles between the sides Results of area computations should be used with care and if possible checked against results of other forms of area measurement The details of the area computation are as follows An algorithm for computing the area of a non self intersecting polygon on the sphere is first tried out If there are very small inte
55. connected exits with 0 if a connection check with the receiver succeeds 5 2 show WHAT writes help information to the standard output 5 3 haslib LIBRARY checks availability of library 5 4 getwrite IN TYPES FORMAT OUT PARAMS OUT TYPES PATH transfers data from the receiver to a file 5 5 readput FORMAT IN PARAMS IN TYPES PATH OUT TYPES transfers data from a file to the receiver 5 6 getrtimelog PATH INTERVAL gets the real time log from the receiver and saves it to a file 5 7 getfix PATH TIMEOUT gets the current fix data and saves it to a file 5 8 getalmanac PATH gets the current almanac data and saves it to a file 5 9 read FORMAT PARAMS TYPES PATH reads a data file and launches the graphical interface 5 10 translate IN FORMAT IN PARAMS IN TYPES IN PATH HOW PARAMS OUT FORMAT OUT PARAMS OUT TYPES OUT PATH translates from a file format to another one 5 12 start travel INTERVAL launches the graphical mode and starts real time logging animation and travelling 5 11 unless the connection to the receiver could not be established project LATD LONGD DATUM PROJECTION PARAMS writes to the standard output the projection of a point 5 13 georef IMGPATH TRANSF LATD LONGD LATD LONGD LATD LONGD DATUM X Y X Y X Y PROJECTION PARAMS writes to the standard output a map information file 5 14 geopicts IN FORMAT IN PARAMS IN TYPE IN PATH PROC PARAMS OUT FORMAT OUT PARAMS OUT PATH PICT PATHS ge
56. current image loaded and are in GPSMan standard format If a track crosses a specific mapsheet more than once such tracks will be appended to the original file Each such track will have a unique 100 name mapname n wher n is a number O to 999 With the Manual plot function the track name is user selectable defaulting to NMEA1 kkk Warning kkk The performance of this software is dependent on computer speed GPS Receivers that output a full string of NMEA sentences without the ability to turn off those not required may cause buffer overflow when using slower computers This is a Tcl feature and beyond my control at the moment This bug may limit the size of map images that can be loaded For example an a3 image appears to be the limit with all sentences turned on in the Lowrance receiver amp using a ThinkPad 380 A more powerful machine will handle larger images test with exerciser details are given below Feedback to baulchb hotkey net au will help us in deciding on future development Use of the software is straightforward The Map images required should have been prepared and georeferenced in the normal GPSMan fashion All NMEA sentences are to the WGS 84 datum so set GPSMan to WGS 84 in the options menu for georeferencing However the georeferencing waypoints should of course be to the same datum as the mapsheet being referenced When this has been done an aut file has to be prepared to show the bounding box fo
57. d show symbols prints for each waypoint symbol the name to be used in commands followed by the name in the user selected language show transfs prints the list of available coordinates transformations with their names to be used in commands and longer names 5 4 The haslib Command The haslib command checks whether a certain library is available 75 haslib LIBRARY where LIBRARY is gpsmanshp Img or TclCurl The command exits with 0 if the library can be loaded 5 5 The getwrite Command The getwrite command gets information from the receiver and writes it to a file getwrite IN TYPES FORMAT OUT PARAMS OUT TYPES PATH where e IN TYPES are the data types to get the possible types are WP RT and TR all can be used as an abbreviation of WP RT TR e FORMAT OUT PARAMS is the output file format and its parameters if any use show formats 5 3 for a list of the currently accepted formats e OUT TYPES may be absent in which case they are taken to be IN TYPES what is valid only when they are all valid for the selected output format if RT occurs in IN TYPES then WP can appear in OUT TYPES but no other type conversions are allowed some file formats impose that there is a single data type per file all can be used as an abbreviation of WP RT TR e PATH is the path to the output file or in the case of the Shapefile format the path to the Shapefiles basename file extensions will be discarded If the PATH is stdout outp
58. d School Amusement park Skiing Ice skating Drinking water Recreational Vehicle park Horn Mile marker Freeway US highway Truck stop Parachute Tower short Geo name land Civil location Exit Border National highway Street intersection Weight station Glider Take off Geo name man made Military location 4 21 3 Category Water Anchor Boat Light Wreck Buoy white Buoy green Buoy red Buoy white Diver down 1 Open 24 hours Bottom conditions Beacon Dropoff Fuel Boat ramp Man over board Dam Buoy amber Buoy green red Buoy red green Buoy white green Diver down 2 City large Car repair Building Police Dam Summit Tracks Fish Lodging Church Theater Airport Mug Shopping Beach Golf Fitness Geocache Fuel Exit no services Toll Highway Ramp intersection Ultralight Landing Geo name water Fish Beach Mile marker Buoy black Buoy green white Buoy red white Buoy white red Stump Fishing Hot Spots TM facility Tide current pred station Coast guard Dock Reef Marina City star Tow truck Pharmacy Water hydrant Levee Many tracks Fish bank Park Chapel Casino Mine Pizza Store Swimming Bowling Picnic Geocache found Fuel amp store Exit no serv large State highway Ramp int large Tower tall Fish bank Swimming Radio beacon Buoy blue Buoy orange Buoy violet Anchor prohibited Weedbed Bait and tackle 4 21
59. d GPS receivers The Lambert 93 grid has a false easting of 700km and a false northing of 6600km The Lambert NTF grid projection has 4 zones named I II III and IV each corresponding to a particular case of the Lambert Conic Conformal projection with 2 standard parallels with the following parameters in degrees zone I II III IV 1st parallel 50 3959116667 45 8989188889 43 1992913889 41 5603877778 2nd parallel 48 5985227778 47 6960144444 44 9960938889 42 0000593542 lat f origin 49 5 46 8 44 1 42 165 the longitude of the false origin being that of the Paris meridian at E2 3372083333 degrees and the NTF Nouvelle Triangulation de France datum The Lambert NTF grid has for zones I to III a false easting of 600km and a false northing of 200km and for zone IV a false easting of 234 358m and false northing of 185861 369m The Lambert NTF tendue grid projection is the same as the projection for zone II of the Lambert NTF grid projection The Lambert NTF tendue grid has a false easting of 600km and a false northing of 2200km Lambert Equal Area Conic projection is a conic equal area projection It has four pa rameters the latitude of a standard parallel the polar aspect either north or south and the latitude and longitude of the centre 53 The Albers Equal Area projection is a conic equal area projection It has four parameters the latitudes of the two standard parallels and the latitude and longitud
60. d icon sizes can now be configured for better usage in high definition displays the command line mode is no longer restricted to Unix Linux systems in answer to a request from Wes Johnston short names of user projections can no longer have blanks items may be associated with a map background image that will be displayed when the item is displayed on an empty map suggested by Paulo Quaresma last directories visited when reading writing files for each file type are now remembered and kept in the saved state suggested by Paul Scorer time stamp and distance are now displayed in the TR animation dialog asked by Tim Jacobs in travel mode it is now possible to follow a LN enhanced support for the GPX format including exportation of WP altitudes suggested by Matt Wilkie with thanks to Val re Robin better support for Ozi map files thanks to Paulo Quaresma and Kari Likovuori new datum Deutsches Hauptdreiecksnetz from the Frida data set available from the Free Vector Geodata Osnabr ck http frida intevation org several menu buttons that could create long menus of items replaced by buttons launching dialogs with listboxes new layout of the WP edit show window support for the Garmin USB protocol in Linux kernels having the garmin_gps kernel driver with thanks to the author of the kernel driver Hermann Kneissel for guidance on using it thanks are also due to Ron Schmars and Asbj rn Djupdal for their help when try
61. d in data items this option has no effect in altitude values displayed in real time log or navigation windows of the Garmin variant 17 altitude threshold in user units needed when computing cumulative ascent descent any altitude change below this value is discarded it should be set to around 11m the default for normal GPS receivers and to around 2m for receivers having a barometric altimeter Computed values will not be displayed if inconsistent with this value format of positions default datum and time offset 1 meaning 1 hour less than UTC date format default map projection and cursor position format when starting with an empty map accurate formulas for computing distances and bearings they should be selected except on very slow computers whether to ask for confirmation of projection parameters whether to use a window to control slow operations and help balloons MapGuide text format default version Operating system command to print or to further process a Postscript file generated by GPSMan in the user GPSMan temporary directory or empty if unavailable the file path will be appended to the command operating system command to display the image in a file or empty if unavailable the file path will be appended to the command operating system command to open a terminal command line window or empty if unavail able map dimensions length of line for displaying a scale and initial map scale given as the dis
62. d to the route otherwise a new waypoint is created and added to the route the route defined so far can now be further edited in its window e right button with the Control key changes the insertion point to the previous stage if there is one e right button with both the Control and the Shift keys change the insertion point to the next stage if there is one or when changing the last stage to the end of the route e middle button or left and right buttons with the Shift key cancels the definition the same can be achieved by using the Cancel button of the route edition window The operations available from the menu Control key and the mouse left button in Unix and Linux systems or only the mouse right button in other systems not on a waypoint are the following only those that are meaningful will be shown at any given moment the corresponding shortcut using the mouse keyboard is shown if there is any e stop editing on the map and either include the current point under the cursor right click or do not add any more points e cancel the whole edit operation Shift and middle click e delete either the previous waypoint the one before the current insertion point Shift and left click or the first waypoint of the route 43 e edit previous stage i e change the insertion point to the previous stage Control and right click e edit next stage i e change the insertion point to the next stage if there is one other
63. d with tests e support for the EOV Hungarian National projection and grid kindly contributed by Sandor Laky laky sandor_at_freemail hu asked by Attila Berenyi berenyi attila_at_gmail com with thanks for his help 109 e the time offset defining a time zone in GPSMan files is now taken into account when loading them this may affect waypoint creation dates track points time stamps and lap start times in answer to a question by Stephen Berryman berrymansj_at_optusnet com au e data items can now be opened from the Data sub menus and the list menus e a single type of items apart from Group must be chosen when putting to or getting from the receiver this is avoids synchronization problems that may occur if the connection is slow e the translate command accepts parameters for overrriding the time offsets in GPSMan files e the geopicts command can now use EXIF files as produced for instance by exif or metacam instead of picture files and can deal with different time zones for track and pictures time stamps e importation and exportation of KML format contributed by Val re Robin asked by Zvi Grauer e better support for GPX files concerning the treatment of waypoint names and of character encoding e importation of OziExplorer waypoint files e examples of some commands in the section about the command line mode in the user manual e Garmin support when getting waypoints not defined by the user fro
64. data in a friendly environment GPSMan supports communi cation and real time logging with Garmin Lowrance and Magellan receivers and accepts real time logging information in NMEA 0183 from any GPS receiver GPSMan can also be used in command mode with no graphical interface GPSMan is a stand alone Tcl Tk program Its use in real time is at the sole risk of the user Software copyright notice The GPSMan version available on 6 October 2013 is number 6 4 4 2 This software is under copyright 1998 2013 by Miguel Filgueiras with the contribu tions listed below under copyright by their authors This software as stated in the source files is distributed under the GNU General Public License a copy of which can be found in the distribu tion with absolutely no warranties Documentation copyright notice This manual is under copyright 1998 2013 by Miguel Filgueiras with two Appendices under copyright by Brian Baulch see their copyright notices The manual is distributed in PDF and in HTML under the following license This work is licensed under the Creative Commons Attribution NonCommercial NoDerivs 3 0 Unported License To view a copy of this license visit http creativecommons org licenses by nc nd 3 0 or send a letter to Creative Commons 444 Castro Street Suite 900 Mountain View California 94041 USA Logos and other images copyright notice The two logos used in the HTML version of this manual and in the GPSMan pages and all other i
65. ds With the UTM UPS Universal Transverse Mercator Universal Polar Stereographic projec tion a single UTM zone is used that of the first point displayed Points in different zones will be projected into the same zone what may produce some deformation There are no parameters that can be changed by the user The Transverse Mercator projection also known as Gauss or Gauss Kruegger projection is used with large scale maps and is not suitable for longitude ranges larger than about 6 degrees It has 3 parameters the latitude and longitude of the centre and the scale factor at the central meridian The first two are computed by GPSMan as the averages of the latitudes longitudes of the first points being mapped while the third one has the default value of 0 9996 used for UTM Particular cases of the Transverse Mercator projection are used in several maps usually for a certain country or region Besides UTM GPSMan predefines the following ones e the Austrian Bundesmeldenetz BMN projection Parameters central latitude 0 central longitude in three zones of 3 degrees named M28 M31 and M34 and centred at 10 3333333 13 3333333 and 16 3333333E scale factor 1 The datum to be used is called Austrian MGI Coordinates in the BMN grid have a false northing of 0 and a false easting that depends on the zone 150km in zone M28 460km in M31 and 750km in M34 e the British National Grid BNG projection Parameters central latitude 49 ce
66. e created and leaves If the preferences file does not exist it forces it to be created All the temporary directory files will be deleted when GPSMan starts up This means that problems may occur if GPSMan is launched when it is already running and using temporary files Users wanting to load their own Tcl Tk code at their own risk can do so by putting it ina file named patch tcl in the GPSMan user directory This file will be loaded immediately after all the GPSMan source files If GPSMan has been installed from the Debian or other Linux Unix distribution packages no changes are mandatory Otherwise on Unix systems the information on the program source files directory user directory and default preferences file must be correctly set A default serial port device can be defined and will be used if no argument is passed to the main program On other systems the same applies to the information on the serial port Parameters that should be configured in gpsman tcl are e for non Unix systems serial or USB device to which the receiver will be connected users of GPSMan must have read write permission e path to the directory containing the program source files e path to the user GPSMan directory that will contain the preferences file and other files for user definitions like user defined projections this directory is normally not to be used explicitly by the user In MS Windows for users not logged in as administrator it may be usefu
67. e depth are undefined both fields are omitted if only the depth is undefined its field is omitted otherwise the altitude field must be present and should be void if the altitude is undefined GPSMan accepts track point positions in any available format but will convert them to DMS lines describing points in a polyline a L command appeared before have a tabulation character followed by the position and the altitude each one either as a value in metres or as a list with value in metres value in external unit and external unit all fields being separated by tabulation characters The positions must all be given in the same datum and format there can be no commands to change the format position format or datum between the L command and the last point lines describing elements of a group a G command appeared before have a first field followed by a tabulation character followed by a name up to end of line The first field is either empty or of the form GW GR GT GL GLAP or GG that stand for group waypoint route track polyline lap and group respectively and describes the type of the element laps will be discarded if support for them is not selected If this field is empty the type is the same as that of the previous element A group is assumed to be well founded it cannot be an element of itself even in an indirect way positions given by latitude longitude are given as two fields each as a DMS DMM DDD or GRA
68. e meaning the track time is later than the files times useful when the camera and the GPS receiver are not set to the same time zone e OUT FORMAT and OUT PATH are the output file format and path at present the only supported format is GPX e OUT PARAMS are the parameters for OUT FORMAT but may also contain the following ones used when generating the resulting waypoints datum DATUM sy SYMBOL with SYMBOL the internal name of the symbol use show symbols 5 3 for a list of the symbol names prefix STRING gives the prefix of the waypoint names the default being P each name starts with the prefix and is followed by a 5 digit number e PICT PATHS are the paths to the files to be geo referenced A file with a time stamp already found will be discarded Example the following command gpsman tcl geopicts gpsman TR data Esp trk date exif dh 1 gpx lacpicts gpx photo exifs LaC uses the track in GPSMan format in file data Esp trk and the EXIF files photo exifs LaC which have time stamps 1 hour later than the time stamps in the track in producing the GPX file lacpicts gpx 5 16 The source Command The source command executes a source Tcl command on the file whose path is given as argument source PATH 5 17 The exec Command The exec command executes the GPSMan commands in the file whose path is given as argument exec PATH 83 Blank lines and lines whose first non blank is ft are discarded without f
69. e of the centre The Teale Albers grid projection is a particular case of the Albers Equal Area projection with standard parallels at 34 and 40 5 degrees North and centre at the equator 120 degrees West The Teale Albers grid uses this projection with the NAD27 CONUS datum false easting of 0 and false northing of 4000km Note that coordinate values may be negative The Mercator projection can be defined as a Lambert Conic Conformal projection either with the equator as its single standard parallel or with two standard parallels at equal North and South latitudes i e symmetrical with respect to the equator This leads to two variants single standard parallel named in GPSMan Mercator 1 and two standard parallels named in GPSMan Mercator 2 The former has 2 parameters the longitude of the centre and the scale factor at the natural origin They are taken as the average of the longitudes of the first points being mapped and as 1 respectively The latter has 3 parameters the latitudes of one of the two standard parallels and of the false origin and longitude of the false origin The first default to the maximum of the absolute values of the latitudes of the first points being mapped the position of the false origin defaults to the average of the positions of these points Yet another variant is the spherical case where latitude and longitude are taken to be in a sphere It has 2 parameters the central latitude and longitude that
70. e search is based on either an allowable maximum distance or a distance interval A bearing for the search can also be given together with an angle that will be centred along it 40 Results if any are presented as elements of a new group with a name of the form FOUND n where n is a number The remark of the group gives a succint description of the constraints used in the search A dialog window will be presented giving the choice between ending the search or making a new one in any case while keeping the group with the results Ok or Another buttons or forgetting it Cancel or verb Change buttons 4 12 Map The map window will contain a graphical representation of data Several operations on the map can be made using the mouse or the keyboard and a summary of these can be found Appendix C The map window can be resized but resizing is independent of rescaling zooming that is controlled by the Change menu button Its contents can be saved as a Postscript file or further processed e g printed in Postscript cf the print command option 3 It is assumed that the user has chosen the relevant datum and projection before asking for some data to be displayed Some information that may be relevant for choosing a datum is given when describing how to define new datums 4 14 The available projections and the way new projections can be defined are described below 4 15 Projections may have parameters in which case the
71. ee track point TR see track track 20 82 35 animation 35 colour 32 computation 33 create 25 from LN 35 from real time log 58 117 from RT 35 graph climb rate 34 elevation 33 elevation gnuplot 33 position change 29 42 position format 28 change in group 39 renaming method 22 24 23 37 waypoint renaming method 27 speed 34 window operations on 32 closing from window manager 61 point see track point main 17 segment 21 32 67 positions 18 simplification 34 sizes 18 splitting 34 slow operation 18 62 to RT 34 WP see waypoint to WP 34 width 17 32 track point 20 32 altitude 21 32 depth 21 32 info to show 17 number 17 34 position 32 time stamp 32 to WP 34 trail see track travel window 59 font 18 travel navigation see real time log Universal Polar Stereographic see UTM UPS Universal Transverse Mercator see UTM UPS utilities external 11 GPSMan 11 UTM UPS coordinates 28 projection see projection UTM UPS waypoint 20 27 30 altitude 29 BGA turnpoint 12 clusters 39 create 25 34 39 42 59 at distance bearing from another 29 when geo referencing 47 48 datum 28 change in group 39 display option 29 default 17 GreenFlag 11 in route 22 30 MapBlast 11 MapsOnUS 11 menu on map 42 name 22 position 34 118
72. efine change a projection there are the appropriate entries under the Definitions menu button When defining a new projection which is necessarily a particular case of a general projection the user must select first the general projection to use along with a name and short name The short name that can not have blanks is for internal use and will also serve as the coordinates grid name if the user associates one to the new projection The values of the projection parameters must be then given The user may either associate to the new projection an existing grid or create a new grid by selecting a distance unit currently either metres or feet by giving the values for the false easting and northing for some projections these parameters are in fact the easting northing of the false origin or of the projection centre sensible bounds to the coordinates and by choosing whether or not a fixed datum must be used with the grid The bounds given will be used to check that the grid is not used outside its intended scope All values of latitudes and longitudes must 50 be given either in the datum of the grid if there is a fixed one or in the datum being used for the map An user defined grid cannot be forgotten if it is currently associated to another projection or in use for displaying the map coordinates Changing the definition of a user defined grid may cause inconsistencies in previously projected data 4 15 2 Predefined projections and gri
73. en the cursor moves the use of the keyboard for scrolling is also a means for finely positioning the cursor Reading items that are on the map will update the map so that the items are shown according to their newly read definitions 4 13 Map background images A map background image can be loaded by selecting either a file or a map background image name In the case of a file it can be either a file containing an image in a recognized graphics format in which case it must be geo referenced or an image information file see 4 19 2 for its format that contains geo referencing information together with the path of the files containing images Preparing an image information file can be done by using GPSMan in command line mode see the description of the georef command 5 14 A map background image name is a user selected identifier for an image information file These names are defined or edited from the Definitions menu and can also be defined when saving a 44 new image information file Along with the name and the path to the file a remark can also be saved The path to the file is only checked when trying to use the name GPSMan will automatically detect the kind of file it has to load from when one selects either the entry Map gt Background gt Load gt from file from the Map menu button if the main window is the map window or the entry Load gt from file of the Background menu button if the main window is the lists window Tf t
74. ent positions will be renamed instead of overwritten The baud rate of the serial communication not USB with some Garmin receivers can be changed from the GPSMan receiver window or menu The implementation is based on the de scription of a protocol in the manual Garmin provides for the GPS 15H and 15L receivers and it is in an experimental state To change the baud rate the serial communication must be reset and for safety reasons this will not be allowed when real time logging is in effect If the selected new baud rate is invalid the change request will be ignored silently When a baud rate change fails either the serial port is kept at 9600 the default used by Garmin or the connection is closed GPSMan now uses the option for the default baud rate as follows if its value is different from 9600 whenever connecting in serial mode to a receiver supporting this protocol there will be an attempt to change the baud rate to the selected value 89 EDGE 205 305 eMap eTrex Euro H Legend _ C Cx J H HC HCx Mariner Summit _ HC Venture _ HC Vista _ C HCx ForeRunner 205 301 305 ForeTrex Geko 201 301 GPS 5 48 65 72 75 76 89 90 125 Sounder 126 128 GPS 12 _ Arabic XL Chinese Japanese CX Map GPS 18 USB GPS 20x USB GPS 38 _ Chinese Japanese GPS 40 Chinese Japanese GPS 45 Chinese XL GPS 50 GPS 55 AVD GPS 60 GPS 72 _H GPS 85 GPS 92 GPS 96 _ AVD XL GPS 12
75. equired a single data type is kept in a file as described in the gpsmanshp documentation data can be stored in 2 or 3 dimensions and GPSMan needs the following parameters when reading writing a file in this format dimension position format that must consist of a single number for each coordinate zone for grids datum distance unit and altitude unit Warning use of a UTM zone with points belonging to another zone may produce conversion errors that are not reported In GPSMan versions before 6 1 there were two different names for 2 and 3 dimensions the position format the datum and altitude unit were assumed to be decimal degrees DDD WGS 84 and metre The information on track or polyline segments is saved to Shapefile files With gpsmanshp versions 1 1 or later routes tracks and polylines can be read from Shapefile polylines or polygons With version 1 2 items read in from a file not written by gpsmanshp will have in their remarks any fields of the dbf file There is also a separate utility 2 4 for splitting the polylines in a Shapefile into different GPSMan files according to their coordinates 67 e Simple Text for importation and exportation of tracks only this is a format based on the Garmin Simple Text Output protocol and the following rules for exportation the position status is either g or G for 2D or 3D depending on altitude being defined EPH is always undefined the altitude is if undefined position status
76. er and Creelman 1965 Moore 1964 Macfarlane 1963 A point is arrived at when the distance to it is less than a user defined arrival distance Navigation along a route track or polyline can be configured to be made e either exactly meaning that each point must be arrived at before the next is selected as current goal or approximately in the sense that the current goal is abandoned in favour of the next when a certain criterion is met even if the point is not yet arrived at see below e either starting from one end of the route or track or from its nearest point relative to the current position e either in the normal direction or in reverse At any moment the user can force a change to the next goal from the travel menu Following a route track or polyline in an approximate way is implemented by considering only the current position and the next two points the current destination and the point after it if there is one because of efficiency issues This means that navigation will be blind to all other points in the route track or polyline even when the current position is closer to any of them than to the next two points The criterion for changing the goal has a looseness parameter that can be changed from the menu When a change to the next goal is about to be made a second CTS arrow in a different colour will be shown in the TRK CTS indicator giving the bearing to it Tracks and polylines will be simplified to a certai
77. erciser Follow the instructions in the Lowrance manual This program can be used for stationary testing of the autoMapic function It requires the use of another computer and a null modem cable or adaptor e g a breakout box Exerciser tcl will send a series of NMEA sentences at preset intervals Initial settings are controlled by the set statements at the top of the program change with a text editor An explanation is given below but make the changes in the program not here set SRLPORT dev ttySO set serial port correctly set BaudRate 4800 NMEA Standard set Hours 0 Do not change set Minutes 0 ditto set Seconds 0 ditto Set Interval to 1000 1 sec for Lowrance 2000 for Garmin set Interval 1000 Latitude of the desired starting point set LatDeg 27 set LatMin 54 30 set LatSign 5 N or S as applicable 102 Longitude of the desired starting point set LongDeg 153 set LongMin 19 334 set LongSign E E or W as applicable Size and direction of steps The units are minutes set LatIncr 0 03 set LongIncr 0 05 Change to 1 true to send the entire Lowrance series of sentences 0 false sends only the required GGA sentence set SendDummies 0 To use the exerciser first copy exerciser tcl to the dummy computer which must have Tcl tk loaded Start exerciser tcl then start GPSMan on the Primary computer The two computers should have had serial ports already connected with the n
78. ert Conic Conformal projection has two variants single standard parallel under the name Lambert Conic Conf 1 in GPSMan and two standard parallels called in GPSMan Lambert Conic Conf 2 52 The former has 3 parameters the latitude and longitude of the centre and the scale factor at the natural origin The first two are computed as the averages of the latitudes longitudes of the first points being mapped while the third one has the default value of 1 corresponding to a tangent cone a value of less than 1 stands for a secant cone The latter has 4 parameters latitudes of the two standard parallels along which the cone intersects the geoid and of the false origin and longitude of the false origin The first two default to the extremes of latitudes of the first points being mapped and the position of the false origin defaults to the average of the positions of these points The Iceland Grid projection is a particular case of the Lambert Conic Conformal projection with 2 standard parallels at N64 75 and N64 25 degrees a false origin at N65 W19 degrees and the WGS 84 datum The Iceland grid has a false easting and a false northing of 500km The Lambert 93 grid projection is a particular case of the Lambert Conic Conformal pro jection with 2 standard parallels at N44 and N49 degrees a false origin at N46 5 E3 degrees and a datum based on the GRS 80 ellipsoid The WGS 84 datum can be used for applications with handhel
79. et there may be more than one and the resulting values togeteher with the parameter names are passed as optional arguments to the procedure PlugInExec used as call back This procedure starts by setting up the plug in parameters by assigning to each parameter name the corresponding value If a name does not start with _ underscore the procedure returns after issuing an error message Otherwise the plug in code is executed by using Tcl eval This way of dealing with parameters makes it possible for the plug in code to access variables in the procedures that create the widgets thus avoiding the need to recompute information that is available there The plug in code may of course access global variables by declaring them as such It should refrain to set global variables and in order to avoid clashes with GPSMan procedures gt and local variables of the call back procedure it should use names starting by underscore if procedures or local variables are defined 6 4 Pre defined plug ins The definitions of plug ins that are part of the GPSMan distribution can be found as elements of the array PLUGIN initialised in the file plugins tc1 The following conventions should be observed 86 when creating a new pre defined plug in 1 each element of PLUGIN is a list with the remark the not available condition the code and the list describing widgets 2 the unique name and the remark should be elements of the TXT array in
80. everal at least 3 control points with known coordinates whose geodetic coordinates and placement in the image are known If the number of control points is large it may be preferable to create and use a GPSMan Least Squares file 4 19 3 instead of placing the points in the image by hand This method will change the placement of the control points in the image in order to minimise the deviations for the whole set of points The following information on the resulting deviations is shown as an option when a GPSMan Least Squares file is used 1 for each control point name if it is a waypoint terrain coordinates horizontal and vertical deviations total deviation 2 root mean square deviation s 2n where s is the sum of the squared deviations also known as residuals or errors 3 standard residual error a statistical measure of how good is the fit s f where f is the number of degrees of freedom given by twice the number of points minus the number of parameters It is suggested that this data is taken into account in trying to increase the quality of the fit by eliminating control points whose deviation is too large 46 Geo referencing can also be done with a certain number of control waypoints that will be placed at fixed positions in the image These waypoints can either be selected from the ones already defined or be defined when geo referencing the image in the latter case only the name and position will be asked for
81. formation 44 62 65 Lambert 93 grid 53 item information 62 62 64 Lambert 93 grid France 28 Least Squares file 65 Lambert NTF tendue grid 53 map information 66 Lambert NTF tendue grid France 28 not saved on exit 62 Lambert NTF grid 53 permissions 18 Lambert NTF grid France 28 translator LambNTF 28 53 BGA 12 LambNTFe 28 53 GreenFlag 11 LV03 28 MapBlast 11 Netherlands Grid 55 MapsOnUS 11 Netherlands grid 28 Shapefile 12 Portuguese Military Maps grid 28 52 font 18 RDG 28 55 SEG 28 52 Garmin Swedish Grid 28 52 baud rate 89 Swiss LV03 grid 28 protocol see protocol Garmin Taiwan Grid 29 52 receiver see receiver brand Garmin TAlbers 28 54 get 22 Teale Albers 28 54 GKK projection see projection German Grid TWG 29 52 projection Uniform Finnish grid 28 52 gnuplot 11 33 user defined 50 GPS see receiver UTM UPS 28 gpsman 14 20 72 map background image 48 gpsman sh 14 20 group 21 37 40 gpsman tcl 13 14 16 20 72 as search domain 40 GRA 28 clusters of WPs 39 graphics formats 31 45 create 25 GreenFlag 11 datum of WPs 39 grid elements 38 coordinates 28 49 for a run 37 38 Swiss LV03 Grid 52 forget 38 Austrian BMN grid 28 51 forget elements 38 Basic Finnish grid 28 52 generated WPs 35 114 on map 38 position format of WPs 39 read write 39 save 38 search results 41 symbol of WPs 39 to WP 39 usage 37 hidden information 17 hidden infor
82. g the horizontal and vertical speeds are computed from the previous point if any or undefined two consecutive tracks are separated by two sentences with all fields as undefined and two consecutive segments in a track are separated by a sentence with all fields undefined for importation lines with position status different from g or G are discarded a single discarded line not at the beginning of the file is taken as a segment start marker and two or more discarded lines in sequence not at the beginning of the file are taken as starting a new track 4 21 GPSMan Symbols GPSMan defines a set of symbols for waypoints that is described below under four categories not mutually exclusive general use land water and aviation This set is based on the symbols described in the Garmin GPS Interface Specification Revision A but extends it including for instance the symbols used by Lowrance receivers contributed by Brian Baulch The GIF files for these symbols provided in the distribution were produced expressly for use with GPSMan with some by Brian Baulch and Robert Joop It is recognized that both these images and the set of symbols can be improved and any help will be appreciated As the set of symbols is large and some symbols may be of no use with the receiver a custom symbol menu can be created and edited There is an entry for this in the Definitions menu button A description of the custom menu is automatically saved in a fi
83. g the corresponding waypoints More information on datums can be found below 4 14 After having selected the projection and datum as described above geo referencing proceeds by choosing the coordinates transformation and by giving information from which the parameters of the transformation and possibly of the projection can be computed 4 13 2 Coordinates transformations The transformations presently available in GPSman are e affine This is the more general transformation the central vertical of the image can have any orientation and there may be distortion in different directions It should be used unless one is sure that the conditions given below for the other transformations are met It is used if geo referencing is done with a TFW or a OziExplorer map file e affine conformal To be used when there is no distortion in different directions in other words in each point the map scale is the same irrespective of the direction that is considered e affine conformal with no rotation The central vertical line of the map image must be oriented North South geographic not magnetic and there is no distortion in different di rections In case of doubt about any of these conditions it is safer to use any of the previous transformations The Least Squares fit method can be used to compute the parameters of any of these transformations Normally this is the method of choice for large scale maps when the projection is not known and there are s
84. gestions Stefan Heinen Stefan Heinen_at_synopsys com who tested the communication with the Garmin eTrex Summit contributed new data structures for datums the procedure to access them and changes to improve the focus policy and bindings under MS Windos as well as for his worked out suggestions 94 Steve Brown for his help in debugging the communication with the Lowrance Globalmap 100 receiver Thomas Trauber for testing the communication with the Garmin eTrex receiver Thomas Zumbrunn t zumbrunn_at_unibas ch for his help in debugging the support for the Garmin GPSMAP 76CSX Tri Agus Prayitno acuss_at_bk or id who provided the support for Indonesian Val re Robin valere robin_at_wanadoo fr who contributed the support for French and the importation of the EasyGPS export and GPX formats the exportation in GPX and KML formats and for his suggestions Wes Johnston wes_at_kd4rdb com for the tests of the command line mode under Cygwin William D Hamblen william d hamblen_at_dartmouth edu for his help in debugging the communication with the Garmmin Forerunner Zvi Grauer zvi grauer_at_gmail com for creating a site with documentation on GPSMan for his PHP script to post information to Twitter for his help in debugging and his sugges tions those who sent lists of protocols for Garmin receivers John Matthews Christoph Dworzak Sabine Sagner Weigl Matthias M Weber David Klotz Gerrit Huizenga Hugo Trippaers Eric
85. gestions and for testing the communication with the Garmin eTrex Euro Heiko Thede Heiko Thede_at_gmx de that contributed a shell and Tcl scripts to convert export files from Map amp Guide 2002 and 2003 2004 text formats to GPSMan format Herbert Tammer H E Tammer_at_DNB NL for the tests with the GPSMAP 76 Hermann Kneissel the author of the Garmin USB Linux kernel driver for making it available his help on how to use it and his availability to correct bugs James B Mehl jmehl_at_rockisland com who provided the formulas for the Least Squares fit method and helped with tests and detailed suggestions Jan Max Krueger University of Konstanz for making available sample IGC files and infor mation on their use 92 Janne Sinkkonen janne_at_iki fi for permission to translate code in GPStrans for the Finnish KKJY grid coordinates Jean H Theoret ve2za_at_rac ca who contributed the code for changing the symbol of each waypoint in a group Jim McGuire jxmcguirel_at_ualr edu who provided information on TFW files Jim Wang who tested the communication with the Garmin GPSMAP 295 Jo o Pedro Pedroso Universidade do Porto for his help with the criteria to change goals when navigating a route in an approximate way John Hay jhay_at_icomtek csir co za for his suggestions and tests John M Quinn U S Geological Survey for making available the GEOMAG algorithm for estimating the magnetic declination Jonathan Penningt
86. group but also all its elements recursively i e including the elements of groups in the group The group is deleted even if some of its elements cannot be cleared from the map and are therefore not deleted Saving a group to a GPSMan file will save all the information on the group and on its elements 38 Creating an average waypoint from the waypoints in a group can be made from the group window The coordinates of the new waypoint will be the averages of the latitudes longi tudes and altitudes of waypoints in the group and its descendants recursively Changing the data of waypoints in a group can also be made from the group window in what concerns e the symbol e the position format or e the datum All the waypoints in the group and its descendants recursively will change to the same selected value If one of the waypoints is being edited the edit window will also be changed In the case of the position format or the datum the position will revert to its initial value when the edit window was created In the case of the symbol the change will be reflected on the map if necessary Clusters of waypoints can be created from a group by taking the waypoints in it and its descendants recursively as centres of the clusters and searching the data base for waypoints that fulfil a selected condition for each centre The conditions that can be tested are that the waypoint is within a given distance range of the centre or th
87. gt 27 A position format and a datum for presenting the position of each waypoint are chosen by the user Changing the format or the datum may be made at will but too many conversions may degrade the accuracy of the data The symbols position formats and datums of all the waypoints in a group can be changed in a single operation as described below 4 10 Some information that may be relevant for choosing a datum is given when describing how to define new datums 4 14 The following position formats can be used e DMS for degrees followed by minutes both as integers followed by seconds as a floating point number the degrees value can be preceeded by a minus sign or one of the letters N S E or W examples are 2 3 4 5 8 34 10 S8 34 10 160 59 58 7 W160 59 58 7 e DMM for degrees as integer followed by minutes as a floating point number the degrees value can be preceeded by a minus sign or one of the letters N S E or W examples are 12 58 997 W93 34 33 S56 34 e DDD for degrees as a floating point number this value can be preceeded by a minus sign or one of the letters N S E or W e GRA for centesimal degrees as a signed floating point number e UTM UPS for easting zone number northing zone letter easting and northing of Universal Transverse Mercator or Universal Polar Stereographic coordinates e one of the available grid systems either predefined or user defined with a zone identifier void for some grids
88. h updated with thanks to Rob Buitenhuis Va re Robin Alessandro Palmas and Alberto Morales e altitude threshold may now be a floating point number e cumulative ascent descent values not shown if inconsistent with warning about altitude threshold suggested by Han Holl han holl_at_pobox com 107 D 4 Version 6 4 2 19 September 2011 e elevation graphs for tracks using gnuplot implemented by plug ins contributed by Rudolf Martin rudolf martin_at_gmx de e for tracks improved computation of total or cumulative ascent descent computation of rest periods total resting time and average speed in motion estimated time for a hiking trail contributed by Rudolf Martin e new configuration parameter user temporary files directory must be set correctly for GPS Man to work it defaults to tmp under the user GPSMan directory e new user options altitude threshold when computing cumulative ascent descent operating system commands to display an image file and open a terminal command line window default of altitude threshold is appropriate for GPS receivers with non barometric altimeter e change in default for user option was a configuration parameter the print command starts now by being empty meaning unavailable e new projections Mercator spherical case Equidistant Cylindrical and their particular cases EPSG 3857 also known as EPSG 900913 EPSG 102113 and EPSG 32663 Plate Carree with WGS 84 datum asked by Rudo
89. he command fails 5 11 The start travel Command The start travel command launches the graphical interface and starts real time logging ani mation and travelling unless the connection to the receiver could not be established 79 start travel INTERVAL where e INTERVAL is the number of seconds between two consecutive entries in the log and defaults to 2 This command only works with Garmin receivers 5 12 The translate Command The translate command reads information from a file in a given format and writes it to another file in another given format translate IN FORMAT IN PARAMS IN TYPES IN PATH HOW PARAMS OUT FORMAT OUT PARAMS OUT TYPES OUT PATH where e IN FORMAT IN PARAMS and OUT FORMAT OUT PARAMS are the input file format and the output file format and their parameters if any use show formats 5 3 for a list of the currently accepted formats e IN TYPES are the data types to read the possible types depend on the input format and some formats impose that there is a single data type per file they may be absent if the format requires a unique data type or if the files can have items of different types all can be used as an abbreviation of WP RT TR LN e IN PATH is the path to the file to read from or in the case of the Shapefile format the path to the Shapefiles basename file extensions will be discarded If the IN PATH is stdin input will be from the standard input unless the format is the Shapefi
90. he datum and the geodetic and pixel coordinates of control points Three control points are chosen by finding the triangle whose side with minimum length is maximum Information on the projection as found in the file is displayed in a window to help in selecting the projection and in setting the projection parameters 4 13 3 After geo referencing an image The map scale cannot be changed if there is a background image and an image can only be loaded to an empty map After geo referencing an image the information on it can should be saved through the entry Save geo ref info under either Map gt Background or Background menus so that the next time it can be loaded with no need for geo referencing A TFW file can also be produced with the parameters for the current coordinates transformation Other background images can be loaded after having one image geo referenced by using the Change option of the map Background menu All images must have the same datum projection and coordinates transformation as the first image Each image will be described by the path of its file In order to load different sheets of a map to the background images assumed to have exactly the same size as the first image can be loaded to a slot in a grid This is done by selecting the grid slot in the diagram that is shown and using the Load button Selecting a non empty slot will show the file path of the corresponding image For loading images that cannot be take
91. he file is an image information file loading the image and setting up the map window is done without user intervention It only makes sense to have as background images maps in one of the projections 4 15 that GPSMan implements Tcl Tk accepts both the GIF and PNM graphics formats GPSMan tries to load the Img Tcl Tk library that provides support also for JPEG TIFF and other formats This library has two problems when saving an image e any window or icon over it will also be part of the saved image and e depending on the format errors can occur if the image has too many colours 4 13 1 Geo referencing an image In order to use a background image GPSMan needs to know how to convert from Earth coordinates latitude and longitude or grid coordinates to map image coordinates in screen pixels This conversion is done in two steps corresponding to the application of 1 a projection that from geodetic coordinates computes Cartesian plane coordinates and 2 a coordinates transformation that from Cartesian plane coordinates computes pixel coordi nates This is needed because the image can be rotated or distorted Going from map image coordinates to geodetic coordinates is done by inverting this process As most projections and transformations have parameters they cannot be used before the values of these parameters are known The usual way to provide them is to place control way points on the image so that the parameters can be compu
92. her there is an indication that the format is invalid because for instance a library as missing or there is incompatibility with the receiver brand or there is information on the possible read write operations and item types which will be followed by Data if a file may contain items of different types Parameters may appear followed by their default values if any show help prints the accepted commands and options show projections prints information on the available projections For each projection there is the name to be used as argument to commands a long name and the list of accepted parameters For each parameter the name to be used in a command a type and a short explanation are given An example of output is Stereogr Stereographic Parameters datum lato lat Lat of centre longO long Long of centre KO float gt 0 Scale factor meaning that the stereographic projection should be spelt Stereogr in commands may have a datum NAME parameter and must have 3 other parameters under the names lat0 long0 and KO respectively a latitude a longitude and a positive floating point number standing for the coordinates of the centre of the projection and for the scale factor show protocols prints a list of known protocols that can be used with the prot option A possible list is Garmin Garmin Garmin_USB Garmin NMEA Garmin simul Garmin SText Garmin showing at the end the receiver brand with which they must be use
93. iate value e when initializing a map projection the default value for the central false longitude in GPS Man is the average of longitudes of the points that are to be displayed then if the option on asking for confirmation of projection parameters is set the user will have the opportunity to change it e measuring distances on a small scale map as explained above 4 12 can yield wrong values for points too distant from each other Projections can be either predefined or user defined There are a small set of predefined projec tions Some of them admit particular cases in the sense that they have parameters whose values can be fixed The user may define such particular cases along with a coordinates grid associated to it Each projection has an associated coordinates grid that will be used as default position format for displaying the map cursor coordinates and when a waypoint is created from the map This position format and the associated datum can be changed from the map window menu buttons near the cursor coordinates If the position format is a grid requiring a fixed datum the datum will be set automatically when the format is changed and cannot be changed When defining a projection the user may also define a new coordinates grid User defined grids cannot have more than one zone User defined projections and grids are automatically saved in a file in the GPSMan user direc tory and will be loaded when GPSMan is started To d
94. iles o e 66 4 20 Files in Other Formats e e 66 4 21 GPSMan Symbols a a o a a Ge EC Se at 68 4 21 1 Category General use 69 421 2 Category Land mas Pa E A e a 70 421 3 Category Water ia nia a dto a 70 4 21 4 Category Aviation e 71 5 Using GPSMan in Command line Mode 72 5 1 Theis available Command e e e 74 5 2 The is connected Command e ee ee ee ee 74 5 3 The show WHAT Command sasaaa aaa 0 0 00 0000 eee eee 74 54 The haslib Command pe se s edate kiera a ee AA 75 30 The getwrite Command ss s os yb ae a a a ae a ee Y 76 5 6 The readput Command 0 0000002 eee ee 77 5 7 The getrtimelog Command 0 000000000000 0008 77 5 8 The getfix Command epi pesca a ew Re beg as 78 5 9 The getalmanac Command 0 0000000000000 008 4 79 5 10 Ehesread Command s oe so a rt ke ee a a Oey 79 5 11 The start travel Command 79 5 12 The translate Command 0 0 0 00 ee eee ee eee 80 5 13 The project Command 0 0 0 0000000000000 2 ee 81 5 14 The georef Command 2 2 2 0 0 00 ee 81 5 15 The geopicts Command os yeta rasy EEEE AAE E a a e 82 5 16 The source Command ee ee 83 5 17 The exec Command cis gee vals A A RA eh ee ee 83 6 Extending GPSMan Plug ins 85 6 1 The graphical interface for plug in definitions 00 85 6 2 Pligsin widgets
95. in answer to a suggestion from Paul Gogan pgmail_at_gogan org e user defined methods for renaming waypoints after a suggestion by Zvi Grauer 108 e changes in group window suggested by Zvi Grauer element names are coloured depending on being in the data base only updated when clicking or double clicking on them more than one element can be selected e tentative support for importation of waypoints from points of interest in MapEdit Polish format files asked by Zvi Grauer e information on a waypoint can be sent to a Twitter account if the Tc1Curl library is available with thanks to Zvi Grauer for his PHP script to do a similar thing e GPSMan can now be extended through pre and user defined plug ins coded in Tcl Tk e patch files may now change the procedures that set up the interface and initialise global variables e explicit support for some new Garmin receivers with thanks to Ken Stephens Geoff Elven Decker Bill Rainey Thomas D Dean Mark N Reihart Pekka Ahoi Alex Preobrazhenskiy and Mario Borgnia who sent protocol lists D 6 Version 6 4 October 2008 e support for the Russian language kindly contributed by Nikolai Kosyakoff priroda net_at_ gmail com e new option for default on displaying items on map when reading a file asked by Valere Robin e changes in the edit show windows for routes tracks and polylines new way of selecting points affecting the way some edit operations work and new Split
96. inconsistent data e driving simulator provides an interface for the user to drive starting from a waypoint and in this way generate logging data A simulator will be switched off only when a different protocol is selected Controlling the real time logging is done with the three buttons Get Log or Stop Record and Animation in the receiver window or the corresponding entries of the receiver menu under Real time track log The first starts and stops the input of logging information the second launches a window that records that information and the third starts the animation on the map These buttons entries can be actuated independently of each other but it is obvious that the recording or the animation cannot start or go on if the input has not started or has been stopped In this way the user may select when to record or when to have the animation The recording window or the animation control window must be used to stop recording or the animation respectively 97 If GPSMan was invoked by using the start travel command 5 11 the animation is started unless the connection to the receiver could not be established The control buttons in the recording window and in the animation control window affect only the recording and the animation respectively except in what concerns the logging time interval which is the same for the recording and the animation The minimum value for the time interval depends on the rate at which the rece
97. ing to make an implementation based on the libusb library other updates to Garmin support following the specifications made available in September 2004 almanac data can be retrieved from Garmin receivers and displayed if in graphical mode or saved to a file if in command line mode explicit support for several Garmin receivers or their new firmware versions including eTrex Legend C eTrex Vista C Forerunner 301 GPS 60 Quest Rino 130 with thanks for all those who sent protocol lists Jerry Walker Vlatko Kosturjak Alan Rogers Peter MacDonald Luca Marletta Ariel Garcia Cliff Dugal Imre Simon Jos Maria Alonso Dennis Langenfeld Eric Smith Simon Wood Al Nikolov Oliver Theis Chris Smith Robert Joop Jan Arne Fagertun Marques Johansson Dan Bluestein Steven Kollmansberger David Bannon Harry Palmer Wes Johnston Frank Sommer 112 Index accurate formulas 18 55 almanac data 27 altitude 21 29 threshold 18 unit 17 animation real time see real time log track 35 area see route area enclosed by animation bearing 55 BGA 12 character set 17 characters in names RT 23 WP 22 climb rate graph 34 colours interface 18 command mode exec 83 geopicts 82 georef 81 getalmanac 79 getfix 78 getrtimelog 77 getwrite 76 haslib 75 is available 74 is connected 74 parameters 72 project 81 read 79 readput 77 show datums 74 formats 74 show help 75 projections 75 protoco
98. irectory It must be edited for configuration before use 4 17 2 Variant for the Garmin This variant implements e Garmin and NMEA 0183 protocols e recording of logging data that can be saved to file at a certain moment or continuously and converted to a track e real time animation in the map window moving map e a travel navigation interface and e a driving simulator and a random generator that produce fake logging data to be used in training testing Protocols supported by this variant are the following e Garmin PVT position velocity and time Data Protocol which is a part of the Garmin GRMN GRMN or Garmin protocol e Garmin Simple Text Output Protocol Text Out and e part of NMEA 0183 v2 0 56 Some receivers must be configured to use one of these protocols this is done in some receivers in a Interface display under Setup Not all Garmin receivers support the first two in which case NMEA 0183 should be selected and the variant for the Lowrance may also be used If the selected protocol is not supported either GPSMan knows about that and issues a warning or there will be no information captured by GPSMan Facts that may help in choosing among the available protocols e Garmin PVT can be used along the rest of the Garmin serial or USB protocol meaning that getting and putting other information from into the receiver can be done while real time logging is on the receiver will temporarily stop sending
99. is geo_at_btnhs nl who contributed the support for Dutch the definition of the Schreiber projection and of the Netherlands grid and helped in debugging Robert Joop rj_at_rainbow in berlin de who contributed new symbols provided valuable suggestions and information on the Garmin eTrex Vista C and helped in debugging Rog rio Reis Universidade do Porto for an algorithm for simplifying tracks for his ideas on the interface functionality help in debugging and his work on creating and maintaining a Linux Debian GPSMan package Rolf Hatt rolf_at_hatt com who tested the communication with the Garmin GPSMAP 180 Ron Schmars ron_at _schmars com who helped with tests of a first implementation of the Garmin USB protocol Rudolf Martin rudolf martin_at_gmx de who contributed plug ins and code that use gnuplot in producing elevation graphs for tracks and compute new values related to tracks suggested a great number of changes to GPSMan and corrected or helped in correcting a number of bugs Russell Nelson nelson_at_crynwr com for his help in debugging the communication with the Garmmin Forerunner Sabine Broda Universidade do Porto who contributed the support for German since version 6 0 Sandor Laky laky sandor_at_freemail hu for his contribution implementing the EOV Hun garian National projection and grid Stefan Hauser etienne_at_imp ch who made the tests of the communication with the Garmin eMap 2 71 and for his sug
100. ith the mouse left button on an empty place or by using the Return or Enter key This can only be done when no waypoint is being edited When a route is being edited on the map the Return key has no effect and the left button on an empty place creates a waypoint that is added to the route see below 4 12 The position format and datum for the new waypoint will be the one in use for the map cursor coordinates Decimal degrees DDD will be used instead when the position is out of the range of the selected grid To finely position the cursor the arrow keys for scrolling the map and the Return key should be used instead of the mouse A menu button for a waypoint on the map will be created by pressing the Control key and clicking on the waypoint with the mouse left button in Unix Linux systems or only the mouse right button in other systems It will allow for moving the waypoint i e changing its position starting the definition of a route see next paragraph or for displaying or clearing e all waypoints within a certain distance e all waypoints in the rectangle having as opposite corners this waypoint and a waypoint chosen from the menu e all routes containing this waypoint e all routes containing waypoints on the map A waypoint that is being moved is placed in its new position by using the mouse left button The right button cancels the operation A balloon will show the possible actions 42 A route can be changed or cre
101. iver sends information The initial value for it is 2 seconds The recording window and the animation control window will appear only after the first valid logging information is received and this means at least 2 seconds from the clicking on the buttons entries If GPSMan is invoked by using the start travel command 5 11 the time interval can be given as the last argument to the command The recording window shows several columns with the logging information These are from left to right e number of the fix e local date and time e the latitude and the longitude datum WGS 84 e altitude in metres the existing option on user unit for altitude is not considered e quality of the position fix e EPE estimated position error EPH expected position horizontal error EPV expected position vertical error in metres e the 3 coordinates of the velocity vector in metres second e TRK the true track or bearing CMG course made good track made good true North Columns for which there is no information for the very first fix will be hidden automatically The title of a column is a button that hides the column This will be wanted for columns that are not being used or needed The information in a hidden column is not lost and is updated At any time a hidden column can be shown again by selecting its name from the Show menu The Restart button will destroy all the recorded information and restart recording The entrie
102. l to have this directory under the user s Application Data directory what is obtained by the following Tcl instruction set USERDIR env APPDATA gpmandir 16 e name of the preferences file the user directory is searched for it only if there is not a file under the same name in the current directory e user temporary files directory it defaults to tmp under the user directory The following list gives a description of all the options that can be configured in the file config tcl e the language to be used by GPSMan new languages can be included by translating the lang tcl files that contain the text and messages in Dutch English French German Indonesian Italian Russian Spanish and Portuguese help here will be acknowledged and inserting new abbreviations for month names in the ALLMONTH array e use of character composition accents cedilla using Western European isolatin1 mode and of Delete key to delete last character e choice of main window there are three permanent windows for the map lists and receiver connection either the map or the lists window can be selected as being the main window e GPS receiver dependent values GPS brand baud rate of serial communication default receiver protocol only for Garmin receivers whether all characters should be accepted in names and comments length of names comments maximum numbers of waypoints routes waypoints in routes and track points use of creation
103. le format in which case the command fails e HOW PARAMS specify how to translate the file for the time being they are only used for overriding the time offset of GPSMan files and take the form itoffset DHOUR time offset 1 meaning 1 hour less than UTC to use in input file in GPSMan format defaults to time offset given in file otoffset DHOUR time offset to use in output file in GPSMan format defaults to time offset selected in the options e OUT TYPES may be absent in which case they are taken to be IN TYPES what is valid only when they are all valid for the selected output format if RT occurs in IN TYPES then WP can appear in OUT TYPES but no other type conversions are allowed some file formats impose that there is a single data type per file all can be used as an abbreviation of WP RT TR LN e OUT PATH is the path to the output file or in the case of the Shapefile format the path to the Shapefiles basename file extensions will be discarded If the OUT PATH is stdout output will be to the standard output unless the format is the Shapefile format in which case the command fails Existing files will be silently overwritten 80 Examples the following command translate gpsman data myWPRTs Shapefile dim 2 pformat UTM datum WGS 84 RT sroutes reads the data in the GPSMan file data myWPRTs and writes the routes in it to Shapefiles with basename sroutes with no altitude information 2 dimensions and using UT
104. le in the GPSMan user directory and will be loaded when GPSMan is started 68 4 21 1 Category General use WP Danger Flag Trace back transparent Ball Diamond blue Square blue Box blue Pin blue Circle blue Block red Triangle blue A red A green A blue 0 red 4 red 8 red 0 green 4 green 8 green 0 blue 4 blue 8 blue Smiley Goatee Female 1 Ranger Biker Bug Skull Flag pin blue Dollar void Dot Diamond green Square green Box green Pin green Circle green Block green Triangle green B red C green B blue 1 red 5 red 9 red 1 green 5 green 9 green 1 blue 5 blue 9 blue Ball cap Afro Female 2 Kung fu Alien Cat Bell Flag pin green Mark x Diamond red Square red Box red Pin red Circle red Block blue Triangle red C red B green C blue 2 red 6 red 2 green 6 green 2 blue 6 blue Big ear Dreads Female 3 Sumo Dog 69 Flag pin red Circled X D red D green D blue 3 red 7 red 3 green 7 green 3 blue 7 blue Spike Pirate Pig 4 21 2 Category Land First aid City small Car Biker WC Phone Tunnel Mountains Ladder Deer Tree Castle Cemetery Zoo Oil field Food Movie Stadium Showers Snow skiing Camp site Info City medium Rent a car House Post office Bridge Elevation Trail head Duck Parking Monument Museum Scenic Fast foo
105. length is 7 keep only the first 7 characters 5 append number with 3 digits until new this last step may fail in giving an acceptable name but as already mentioned if the renaming method fails GPSMan will generate a new name using its default method 4 4 Data The contents of the GPSMan data base are shown in lists one per each item type Item names which are unique are presented in alphabetical order List menus contain the actions allowed on the list like creating a new item opening an existing one clearing the list reading writing items and counting the number of items in the list The menu for the groups list is a little different and is described below 4 10 Loading operations read all the data in a GPSMan file irrespective of from what menu the operation was launched Laps in a file will be ignored unless the support for laps is active 25 To open an item for editing only possible when no other item of the same kind is being edited or viewing its data use the appropriate menu entries in the sub menus of the Data menu or in the list menus or double click on the item name with the mouse left button Double clicking also works with the same meaning on other lists of item names as well as on graphical representations of items except polylines in the map window An edit show window for an item will be closed and re opened in case there is a read operation redefining it To display clear an item on from the map click o
106. lf Martin e in order to avoid ill formed or inconsistent data files appending to a file is no longer an option when writing to an existing file except in the case of results of computations real time logs and contents of information windows e windows presenting results that depend on the definition of a route or track such as compu tations or graphs may be closed when the item changes after being edited or being replaced when data is read in based on a change suggested by Rudolf Martin e unavailable expression of plug ins are now evaluated at top level so that global variables can be used e explicit support for the Garmin GPS 72H receiver with thanks to Justin Arundell and Julian Barragan who sent protocol lists D 5 Version 6 4 1 30 December 2009 e complete revision to avoid problems in dealing with toplevel windows caused by a bug in the Gnome Metacity window manager thanks to Sergei Golovan e accurate formulas for computing distances and bearings are now the default and should be used except on very slow computers most users should select them when upgrading thanks to Valere Robin e full support for TFW files following the description available from the ESRI site with the help of Jim McGuire jxmcguirel_at_ualr edu e fonts can now be fully configured with real time configuration for map and plots fonts font sizes selected in previous versions will not be considered when upgrading and manual selection is needed
107. ll be done before the first or after the last waypoint respectively e Replace by replaces the first selected waypoint by another one e Invert take the route from the last to the first waypoint e Chop head all waypoints from the first to and including the first one selected are deleted if there is no selection the first waypoint is deleted e Chop tail all waypoints from and including the last one selected to the last are deleted if there is no selection the last waypoint is deleted e Include before or Include after include the route whose number was selected in the sub menu before or after the respectively first or last selected waypoint if there is no selection the inclusion will be done before the first or after the last waypoint respectively e Clear delete all waypoints A route can be splitted by taking each selected waypoint as the first point of a new route extending up to and excluding the next selected point Routes with at least two points obtained in this way are created as well as a group with all of them These new routes inherit the stages width colour and map background of the original route but hidden information is discarded They and the new group get names generated automatically The original route is not affected by this operation A route can be converted into a track from the route window An elevation graph for a route can be plotted as a side view or
108. ls 75 symbols 75 transfs 75 show 74 source 83 start travel 79 translate 80 configuration 16 19 temporary directory 16 user code 16 user directory 16 coordinates 20 grid see grid coordinates Maidenhead see MH coordinates current version 10 dangerous use 5 57 59 data item see item 21 data base 21 23 25 40 date format 18 datum 49 change 23 default 18 map see map datum user defined 49 variant 49 waypoint 28 DDD 28 depth 21 distance computation 55 unit 17 18 61 coordinates grid 50 DMM 28 DMS 28 edge see route stage elevation graph font 18 for RT 31 for TR 33 for TR gnuplot 33 ellipsoid 49 EOV projection see projection Hungarian Na tional Projection export 22 62 file 22 62 66 displaying items 17 foreign format BGA 66 113 EasyGPS 66 BMN 28 51 Falk 67 BNG 28 51 Fugawi 66 British National Grid 28 51 GD2 66 British West Indies Grid 51 GPStrans 62 66 British West Indies grid 28 GPX 66 BWI 28 51 GTrackMaker 66 Carta Tecnica Regionale Italy 28 IGC 66 CMP 28 52 Kismet 19 67 CTR 28 51 KML 67 EOV 52 MapEdit 67 German grid 28 51 MapGuide 67 GKK 28 51 MapSend 67 Iceland Grid 53 Meridian 67 Iceland grid 28 NMEA log 67 IcG 28 53 OziExplorer 67 Irish Transverse Mercator grid 28 51 Power Route 67 ITM 28 51 Shapefile 67 KKJP 28 52 Simple Text 68 KKJY 28 52 GPSMan formats 22 62 Lamb93 28 53 image in
109. m D command with D the datum name for the coordinates 3 a Projection NP As command with NP the name of the projection to use and As a sequence of attribute value pairs under the form Atr Val describing projection parameters the tabulation is used as separator for NP and each pair 4 a Transf NT As command with NT the name of the coordinate transformation to use and As a sequence of attribute value pairs as in the previous command 5 a Scale S command with S the floating point value of the map scale in pixel metre After this there may be one or more lines with a Image at XG YG P command where P is the absolute path of the file containing the image in an accepted graphics format and XG YG are the grid coordinates of the image The grid coordinates of the first loaded image are 0 0 GX changes by 1 1 for each image to the right left and GY changes by 1 1 for each image down up No newlines are allowed within these commands and arguments are separated by spaces or tabulation characters unless otherwise stated Paths must use the slash as separator Preparing an image information file can be done by using GPSMan in command line mode see the description of the georef command 5 14 4 19 3 Least Squares files These are files giving either waypoint names or the geodetic coordinates of control points as well as their pixel coordinates to be used in computing the parameters of any kind of transformation by the
110. m the receiver those with the same name but different positions will be renamed instead of overwritten experimental support for changing the baud rate of a serial communication with some receivers GPSMan now uses the option for the default baud rate in a different way With thanks to Andy Walls cwalls_at_radix net who found out a specification of the corresponding protocol and to Klaus Ethgen for his help with tests explicit support for some new receivers with thanks to all those who sent protocol lists Wouter Amsterdam Facundo Ariel Perez David W Capella Hiroshi Iwamoto Andras Veres Szentkir lyi Steven Winikoff Stefan Heller Greg McQuat Andy Walls Jeff Hanson Gerry Creager Paul B Hoch Johann Spies Bruce Dawson Bogdan Hlevca Ralf Kleineisel David Antliff Slaven Rezic Matthias Wenzel Lovro Palaversa Adrian Lawrence Oliver Hegner David P Brown M Gutman Jean Yves Sage Damien Por quet Vincent Arkesteijn Patrice Arnal Zvi Grauer James B Mehl D 7 Version 6 3 2 June 2007 e Least Squares fit for geo referencing images either by placing control points on the image or by giving a file of coordinates of control points asked by James B Mehl mehl_at_rockisland com who kindly provided the formulas e the track computation window now displays for each track point its date and position there was a change in the order of the fields both in the window and in saved results asked by Victor Yip e e
111. m the standard input unless the format is the Shapefile format in which case the command fails e OUT TYPES are the data types to put the possible types are WP RT and TR and may be absent in which case they are taken to be IN TYPES this is valid only when the receiver has support for all of them if RT occurs in IN TYPES then WP can appear in OUT TYPES but no other type conversions are allowed all can be used as an abbreviation of WP RT TR As usual putting information into the receiver can cause data stored in it to be overwritten This command only works with Garmin receivers Examples the command readput gpsman data myWPRTs WP RT reads the data in the file data myWPRTs in GPSMan format and uploads the waypoints and routes to the receiver while the command readput Shapefile dim 3 pformat UTM datum WGS 84 TR shp myTRs reads the tracks in the Shapefiles with basename myTRs in the directory shp with altitude infor mation 3 dimensions and using UTM coordinates for the WGS84 datum and uploads them to the receiver 5 7 The getrtimelog Command The getrtimelog command gets the real time log from the receiver and saves it to a file until the process is killed TT getrtimelog PATH INTERVAL where e PATH is the path to the output file unless it is stdout in which case output will be to the standard output Existing files will be silently overwritten e INTERVAL is the number of seconds between two consecutive entries
112. mages in the GPSMan distribution are under copy right 1998 2013 by Miguel Filgueiras The logos are under the following license This work is li censed under the Creative Commons Attribution NonCommercial NoDerivs 3 0 Unported License To view a copy of this license visit http creativecommons org licenses by nc nd 3 0 or send a letter to Creative Commons 444 Castro Street Suite 900 Mountain View Califor nia 94041 USA The other images are under the following license This work is licensed under the Creative Commons Attribution ShareAlike 3 0 Unported License To view a copy of this li cense visit http creativecommons org licenses by sa 3 0 or send a letter to Creative Commons 444 Castro Street Suite 900 Mountain View California 94041 USA Other documentation on GPSMan can be found in 1 1 Benoit Steiner gpsman pages at http doc ubuntu fr org gpsman in French the detailed and extensive Zvi Grauer GPSMan pages at http www words2u net pmwiki n GPSMAN HomePage Contributors GPSMan incorporates code contributed by Brian Baulch baulchb_at_hotkey net au communication with Lowrance receivers support for the wheelmouse real time logging variant for the Lowrance Rog rio Reis Universidade do Porto Debian Linux package and the utilities to configure and lock the serial port Andreas Lange Andreas C Lange at_GMX de support for German versions before 6 0 Alessandro Palmas alpalmas_at_tin i
113. mat files for importation of points of interest as waypoints as no de scription was found the implementation is based on observation of sample files and may therefore fail coordinates of each waypoint are taken as the average of the coordinates of the corresponding point of interest repeated names are replaced by automatically generated ones MapGuide text not XML export formats from 2002 or 03 04 versions Warning unde tected errors may occur if the version given when opening the file does not correspond to that of the file This format is only for importation of routes each file corresponds to a single route that will be split in several ones according to the maximum number of waypoints in a route a number or identifier for the first route can be given when opening the file as well as a comment and a remark if the original route yields more than one route a suitable remark will be added to each route after the first one MapSend Meridian only in the Magellan variant NMEA real time log only in the Garmin variant and only for for importation of tracks each file is taken as a track OziExplorer waypoints and tracks files can be used for exportation of waypoints not more than 1000 per file and tracks one per file and for importation of waypoints the fields that are kept being the name the position the altitude the comment and the date Shapefile if the gpsmanshp Tcl Tk library is available version 1 1 or later is r
114. mation 21 26 64 how to change datum of WPs 39 item see how to open item position format of WPs 39 RT stage 30 symbol of WPs 39 control real time logging 57 create clusters of WPs 39 item 25 LN from TR 34 LN on map 41 RT from TR 34 RT on map 43 simplified TR 34 WP during travel 59 WP from GR 39 WP from TP 34 WP from TR 34 WP on map 42 WP when geo referencing 47 48 define change coordinates grid 50 datum 49 ellipsoid 49 projection 50 edit RT on map 43 geo reference image 45 load background image 44 more than one 48 map un map item 26 41 42 open item 26 position map cursor 44 read write filtering with GR 39 item 25 scroll pan map 44 search items see search select real time protocol 57 start real time simulator 57 import 22 62 input output operations 22 installing GPSMan 13 14 item 21 comment 21 count 25 create 25 38 forget 17 21 23 38 name 23 25 allowed characters 22 23 on map 26 41 open 26 constraint 61 overwrite 17 23 read write 25 39 remark 21 23 rename 17 23 same name 17 23 search see search language 17 18 62 LAP see lap lap 21 37 loading 25 37 run 21 37 support 17 launching GPSMan 20 leg see route stage link see route stage list 25 clear 25 menus 25 scroll 26 LN see polyline load 22 25 62 log see real time log Lowrance real time log see real time log receiver see recei
115. mentation of the Garmin USB protocol e Ashutosh Dutta dutta_at_cs columbia edu for testing the communication with the Garmin GPS 72 receiver and for his suggestions e Attila Berenyi berenyi attila_at_gmail com for his suggestions and help concerning the support for the Hungarian Datum and projection e Barry Samuels bjsamuels_at_beenthere donethat org uk for his help in debugging e Benoit Steiner benetsteph_at_free fr who contributed code for displaying information on points of 2D elevation graphs and computing the cummulative ascent height of climbing for tracks and who prepared documentation on GPSMan e Brian Baulch baulchb_at_hotkey net au for his work on adapting GPSMan for Lowrance receivers for his ideas on improvements to GPSMan for the wheelmouse support real time logging variant for the Lowrance and help on finding and destroying bugs e Brice Olivier Demory brice olivier demory_at_epfl ch who did the tests leading to the ex plicit support of the Garmin GPS 76 receiver 91 Carsten Tschach tschach_at_zedat fu berlin de for making available GPStrans Dan Jacobson jidanni_at_yahoo com tw for his help in debugging his suggestions and the information on the Taiwan grid Daniel Dorau daniel dorau_at_alumni tu berlin de for his help in debugging the support for the Garmin GPSMAP 60CSX David Gardner djgardner_at_users sourceforge net for contributing code that creates a group from un displayed i
116. mentation purposes a Tcl expression that evaluates to non zero if the plug in cannot be used for instance when a needed library or external program is missing the evaluation is done at top level so that global variables can be used a sequence with alternating parameter names and Tcl expressions used for setting up initial values needed by the plug in code parameter names must be valid Tcl variable names starting with underscore the Tcl code to be evaluated in order to execute the plug in as the text box has only basic editing features it may be wise to edit the code in a separate editor and paste it in the box when finished a Tcl list with information on widgets to be created for launching the plug in each element is a list with a Tcl glob pattern for paths of GPSMan toplevel windows only some toplevel win dows have support for plug ins cf the array PLGSWelcomed in the GPSMan source file plugins tcl a widget type either button or menu a widget path from the matching window path 85 Care must be taken when defining a new plug in as it is difficult or even impossible to auto matically check the correctness of the given information The best way to start writing plug ins is to change an existing definition Information on user defined plug ins is kept on a file in the GPSMan user directory Advanced users may wish to edit this file instead of using the graphical interface 6 2 Plug in widgets Plug in
117. n Anthony Mascola for their help in detecting and tracking down bugs and or for their suggestions Until December 2010 the work presented here has been partially supported by funds granted to the Laborat rio de Intelig ncia Artificial e Ci ncia de Computadores da Universidade do Porto through the Programa de Financiamento Plurianual Fundacao para a Ci ncia e a Tecnologia and Programa POSI 96 Bibliography Gardner and Creelman 1965 A C Gardner and W G Creelman Navigation Pergamon Press 1965 Heckbert and Garland 1997 Paul S Heckbert and Michael Garland Survey of Polygonal Surface Simplification Algorithms Technical report draft School of Computer Science Carnegie Mellon University 1997 Li 1995 Zhilin Li An examination of algorithms for the detection of critical points on digital cartographic lines The Cartographic Journal 32 121 125 1995 Macfarlane 1963 William Macfarlane Home Trade Navigation Guide Brown Son and Ferguson 1963 Moore 1964 D A Moore Basic Principles of Navigation Kandy Publications 1964 97 Appendix A Lowrance supplement to the GPSMan Documentation Lowrance supplement to the GPSMan Documentation FEA kk k k k A ACI I I I k 1 21 21 k k k k 3k A A AC K K k K k k K K a EE 1 GPS receiver setup Follow the instructions given in your Lowrance manual Set the Com Port to 19200 bps 8 data bits and no parity Use the correct Lowrance accessory data cable for y
118. n and shift key lt Control n gt mouse button and control key lt Control Shift n gt mouse button control and shift keys lt Alt n gt mouse button and alt key lt Control Motion gt control key and mouse motion Keyboard lt Key Up gt up arrow key lt Shift Up gt shift and up arrow keys lt Key Down gt down arrow key lt Shift Down gt shift and down arrow keys lt Key Left gt left arrow key lt Shift Left gt shift and left arrow keys lt Key Right gt right arrow key lt Shift Right gt shift and right arrow keys lt Key Delete gt delete or backspace key lt Key space gt space key lt Return gt return or enter key 106 Appendix D Recent Changes The following is a summary of the more important changes made recently no mention being made of bug corrections D 1 Versions 6 4 4 2 6 October 2013 and 6 4 4 1 15 July 2013 e Change of email address for reporting bugs D 2 Version 6 4 4 5 April 2013 e new option in file config tcl indicating whether GPSMan data can be appended to an existing file when saving to be used with care as a file with conflicting time offsets can result that will not be loaded by GPSMan asked by Zvi Grauer e explicit support for the Garmin Street Pilot I with thanks to Martin Espinoza who sent the protocols list D 3 Version 6 4 3 29 April 2012 e support for more ISO8601 date formats contributed by Val re Robin e support for Dutch French Italian and Spanis
119. n as being in a grid overlapping other images or having different sizes the Load button in the right panel of the dialog should be used A single control waypoint is needed to be placed over the new image and can be either selected from the data base or defined before being placed The list of file paths for the images loaded in this way is shown in a list Selecting one of them will create a representation of the image in the diagram of the left 48 panel It will appear only when the cursor is on the right panel and it may be too far away to be seen The Clear buttons in the dialog will remove the selected images in either panel The first image cannot be removed 4 14 Datums and ellipsoids A horizontal or geodetic datum defines the form and the position relative to the Earth axis of the geometric reference surface of the Earth used for locating points and in projections The form is an ellipsoid which is usually defined by giving its semi major axis a and its flattening f or its inverse i e the quotient of the difference between its semi major and semi minor axes by its semi major axis Its relative position is described by the shift in Cartesian coordinates dx dy dz with respect to a reference datum usually the WGS 84 GPSMan contains comprehensive sets of datums and ellipsoids Their definitions have a remark field used for documenting them whenever possible as well as fields for the error estimate in metres ex ey e
120. n graphical mode e GPSMan keeps lists of data items waypoints routes tracks polylines laps and groups whose information can be written to and read from text files or except for polylines got from and put into supported GPS receivers e GPSMan lets the user create new data items as well as modify or delete those already defined groups sets of data items are very helpful in keeping and classifying the existing information as well as in the selection of information to be processed e GPSMan makes conversions of routes into tracks tracks into routes tracks or polylines by keeping a certain number fixed by the user of track points polylines into tracks tracks into a waypoint taking the averages of the latitudes longitudes and altitudes of the track points waypoints in a group into a waypoint taking the averages of their latitudes longitudes and altitudes routes tracks and polylines into similar items by splitting at certain points e GPSMan records real time track logging information that can be displayed on a moving map and used to create a track that may be then converted into a route or a polyline e GPSMan retrieves GPS almanac data from the receiver e GPSMan makes computations of for waypoints distance and bearing to another waypoint nearest waypoints in fact distances and bearings to all other waypoints ordered from nearest to furthest clusters of waypoints with gi
121. n number of points before being followed in an approximate way In this case numbers identifying track points will be preceded by an asterisk indicating that the numbers are different from those in the track 60 Going back is implemented as following exactly the travelling log in reverse This log is started when travelling begins and cleared only when restarting travelling upon user confirmation As a copy of it is used in going back such a navigation will not be affected by clearing it Warnings will be issued as messages at the left upper corner of the map Different colours are used for different priorities User warnings can also be issued after configuration from the menu and warnings except those standing for danger can be disabled without loosing the configuration In case a warning is issued when another one is still being displayed it will either replace the previous one or be discarded depending on their relative priorities There are the following classes of priority in decreasing order owner usage important GPSMan possibly dangerous situations high user medium user normal GPSMan arrivals errors low user info GPSMan other information User warnings may be any of when needs proximity to WP approaching WP distance user units leaving anchor WP distance user units speed in excess limit user units vertical speed out of range minimun may be lt 0 maximum m s turn in excess limit degrees in 180
122. n the item name in the corresponding list with the mouse right button or use the Display on map or Clear entries in the Items menu button on the map window The Make Group entry allows for the creation of a group with all the items on the map or with all the items not on the map A read operation redefining items that are currently on the map will cause the map to be updated in order to keep it consistent with the new definitions Pressing a key on a list will scroll it to make visible the first element whose initial character is the same or higher in ASCII order than the key character Note that this is case sensitive i e a is not A This also works on lists presented for choosing items Lists can be scrolled by moving the wheel of a wheelmouse Hidden information is kept in the data base and in files associated to an item data that has been read in from a file or from the receiver when that information cannot be edited using GPSMan This is done mainly with data fields that are not of general use and provides a means of restoring the data item back to any receiver that works with the same communication protocols without loosing information When the item data is modified its hidden information is either deleted or kept or acted upon as the user sees fit according to an option Keeping the hidden information may cause incoherent items to be created and therefore should be used with care Hidden information in a waypoint or a track
123. n turn differs from the Mercator and Transverse Mercator projections in that the central line with true scale is neither the equator as in the Mercator nor a meridian as in the Transverse Mercator and is chosen to suit the region to be mapped In the Swiss Oblique Mer cator this line has an azimuth of 90 degrees and contains the centre of the projection There are three parameters the latitude and longitude of the centre and the scale factor the default values in GPSMan being the averages of latitudes and of longitudes of the first points to be projected and 1 respectively The Swiss LV03 Grid projection is a particular case of the Swiss Oblique Mercator projection with centre at Bern N46 9524055556 E7 43958333333 degrees in the CH 1903 datum and a scale factor of 1 The Swiss LV03 grid has false easting and northing of 600km and 200km and use the CH 1903 datum The Uniform Hungarian National projection EOV Egys ges orsz gos vetiilet is a re duced oblique Mercator projection that has no parameters and should be used with the Hun garian Datum 1972 Coordinates in the associated grid are by definition presented in the order northing then easting but this convention is not followed here They correspond to a false easting of 650km and a false northing of 200km Acceptable ranges of values are 400000 950000m for easting 0 400000m for northing 45 49 degrees for latitude and 16 23 degrees for longitude The Lamb
124. ne e from the map if the map has been geo referenced see below 4 12 e from a track either as one of its points or by taking an average of the coordinates see below 4 7 e from the waypoints in a group by taking an average of the coordinates see below 4 10 e Garmin variant only from the travel menu by taking the coordinates of the last point in the real time log if there is one see below 4 17 2 The position of a waypoint displayed on the map can be changed there through a menu as described below 4 12 29 Clusters of waypoints can be created by giving a group of waypoints to be used as centres see below 4 10 Information on a waypoint can be sent to a Twitter account if the TclCur1 library is available and the waypoint has a valid position A pre defined message is presented with tags GPSMan and waypoint followed by the latitude and longitude in decimal degrees the altitude if defined the datum and if defined the name and the comment This message may be edited and will be truncated to 140 characters if longer than that Login information may be remembered during the current session but is not saved to disk There are no error messages when the TclCurl library calls fail 4 6 Routes Routes may happen to have waypoints that were permanently deleted by the user Forget button in waypoint window In this case the values of distances and bearings for such points and the total distance will not be shown S
125. nhanced support for GPX files contributed by Val re Robin e dealing with track segments in GPX files asked by Tomi Ollila 110 importing and exporting tracks using a file format similar to the Garmin Simple Text Output protocol getfix command now also produces the altitude if in a 3D fix asked by Marc van der Sluys new geopicts command geo references files e g picture files from a digital camera either based on their time stamps and a given track or by using the sequence of waypoints in a group The result is a file with waypoints at present in GPX format that can be suitable for use with Web applications Implemented using as model a Python script kindly contributed by Val re Robin new show symbols command prints for each waypoint symbol its internal name followed by the name in the user selected language symbol internal names may be needed in the geopicts command the read command that was only to be used in GPSMan scripts can now be used from the command line in which case it reads a data file and launches the graphical interface suggested by Val re Robin names of file formats in commands can now be given all in lower case letters for MS Windows users the manual now explains how to set the user directory under the user s Application Data directory contributed by Harald Stauss harald stauss_at_web de explicit support for some more Garmin receivers or their new firmware versions including the GPSMap 60 the
126. ning projections Selecting the map projection is done by using the second from the left menu buttons on the bottom of the map window if the map window is the main window or the Projection menu button if the lists window is the main window If a background image is to be loaded the projection and the datum should be set to the projection and datum used in the image see above 4 13 1 for the details on this If there is no image the map projection should be selected according to the map scale and the geometry of the region to be covered 49 World maps and small scale maps need suitable projections such as Mercator Using pro jections that were developed for large scale maps such as the Transverse Mercator will give strange results or even errors With small scale maps the following should also be noted e a map cannot have overlapping parts this implies that for each point on the Earth the projection procedure will give a single projected point e for projections having a central longitude or false longitude parameter GPSMan converts any longitude value to the range from 180 to 180 inclusive centred on that central false longitude this means that it may happen that a point created too far to the West or East of this longitude will be mapped to the East or West of it causing lines routes tracks or polylines to be displayed in a wrong way it is therefore very important that the central or false longitude be given an appropr
127. ntral lon gitude 2 scale factor 0 9996012717 The datum to be used is called Ordnance Survey Great Britain Coordinates in this grid correspond to a false easting of 400km and a false northing of 100km e the British West Indies projection Parameters central latitude O central longitude 62 scale factor 0 9995 The datum to be used should be based on the Clarke 1880 ellipsoid Coordinates in this grid correspond to a false easting of 400km e the projection used in the Italian Carta Tecnica Regionale CTR Parameters central latitude O central longitude in two zones of 6 degrees centred at 9 and 15E scale factor 0 9996 Coordinates in the CTR grid have a false northing of O and a false easting that depends on the zone 1500km in the first zone and 2520km in the second one e the German Grid projection GKK Gauss Krueger Koordinatensystem Parameters cen tral latitude 0 central longitude in zones of 6 degrees centred at 0 3 6 9 12 and 15E scale factor 1 Coordinates in the GKK grid have a false easting of z x 1000 500 km where z is the zone number e the Irish Transverse Mercator Grid ITM projection Parameters central latitude 53 5 central longitude 8 scale factor 1 000035 The datum to be used is called Ireland 1965 Coordinates in this grid correspond to a false easting of 200km and a false northing of 250km 51 the Portuguese Military Maps projection used in 1 25000 maps published by the Port
128. nts list When displaying a track with segments on the map the segments will not be connected The edit window for tracks allows some operations on tracks that may be useful to clean uninteresting start or end parts of a track or to compose a single track from several others They are 32 e Chop head all track points from the first to and including the first one selected are deleted if there is no selection the first track point is deleted e Chop tail all track points from and including the last one selected to the last are deleted if there is no selection the last track point is deleted e Include before or Append the track points of another track are put before the first or after the last track point To ensure sensible values for speed between track points their dates may have to be changed GPSMan will show the distance between the last point in the first track to the first point in the second and will propose a new date for this one This date is computed assuming a constant speed and may be changed by the user All dates in the second track will be adjusted according to the chosen date keeping the original differences e Delete deletes all selected track points The computation results are the following e for each point point number time stamp latitude DMS longitude DMS altitude in the unit selected by the user distance to next point cumulative distance to next point time to next
129. nu referred to as the menu in the remainder of this subsection to control travelling navigation and giving access to the receiver menu WARNING use of this interface is at the sole risk of the user In particular the use of a laptop computer while driving alone is extremely dangerous The user may also want to read the safety alert at http www uscg mil hq g m moa docs sa0496 htm from the United States Coast Guard regarding the use of GPS equipment in boats A distinction is made here between travelling and navigating in the sense that the latter implies that there is a destination when going to a waypoint or following a route while the former does not Starting a travel changes the map window top replacing the buttons by the travel navigation displays Stopping travelling restores the map window and will suspend but not forget current navigation objectives which will be resumed if travelling is again selected If GPSMan was invoked by using the start travel command 5 11 travelling is started unless the connection to the receiver could not be established The following information from the real time log can be shown when travelling e local time e position latitude and longitude WGS 84 datum e altitude in metres the existing option on user unit for altitude is not considered e TRK true track current bearing COG course over ground CMG course made good track made good true North e quality of the position fix
130. o follow the constraints on acceptable characters or length Allowed characters and length depend on the receiver brand and model GPSMan behaviour is controlled by some user options 3 on this There should be some caution in setting these options For instance if data files are to be shared among users with receivers of different brands the more strict rules should be followed In particular using a large maximum length may result in data loss if names are truncated and then become equal to existing names Waypoint names obey the following rules e Garmin names should only have uppercase letters and digits even if Garmin receivers may use others see the Garmin specification GPSMan also accepts either lowercase letters and hyphens or any character depending on the options e Lowrance names can have uppercase letters digits hyphen single quote period parentheses slash and also space e There are no constraints on Magellan names When a waypoint name with characters not allowed or exceeding the maximum length is read from a file or from the receiver the user is asked for a new name but has the choice between applying a renaming method 4 3 to it or letting GPSMan automatically generate a new name for it This can be done not only for the present name but also for any forthcoming unacceptable name in the current input operation The replacement name can neither be in use by other waypoint in the data base nor be the same as
131. o load along with the route if the map is empty After such a line there may appear a remark see NB command below Next lines up to another data command or end of file describe the route waypoints and the route stages if any T N definition of track named N After the name and a tabulation character fields separated by tabulations may occur that have attribute value pairs under the form Attr Val The possible attributes are width colour and mapbak for the width in pixels and the colour of lines on the map window and the map background to load along with the track if the map is empty After such a line there may appear a remark see NB command below Next lines up to another data command format definition command or end of file describe the track points and the beginnings of segments TS command L N definition of polyline named N After the name and a tabulation character fields separated by tabulations may occur that have attribute value pairs under the form Attr Val The possible attributes are width colour and mapbak for the width in pixels and the colour of lines on the map window and the map background to load along with the track if the map is empty After such a line there may appear a remark see NB command below Next lines up to another data command format definition command or end of file describe the polyline points and the beginnings of segments LS command LAP T definition of a l
132. o references files using either their time stamps and a given track or the sequence of waypoints in a group 5 15 source PATH executes a Tcl Tk script 5 16 exec PATH executes a GPSMan script 5 17 File format names should be given as they appear in the output of the show formats command or using only lowercase letters 73 5 1 The is available Command This command exits with 0 and is intended for a quick check on the availability of GPSMan in command line mode 5 2 The is connected Command The connection with the receiver is checked and the command exits with 0 if it succeeds Only works with Garmin receivers 5 3 The show WHAT Command This command sends help information to the standard output according to its argument one of datums formats help projections protocols symbols trans s show datums prints the names of and existing comments on the available datums show formats prints a table of the data file formats known to GPSMan and that can be used in other commands An partial example of output is BGA Read WP Parameters Read feature findability air_activity EasyGPS Read WP Fugawi Read WP GD2 Read WP RT TR GPSMan Read Write WP RT TR LN LAP GR Data GPStrans Read Write WP RT TR GPX Read Write WP RT TR Data GTrackMaker Read WP RT TR Data IGC Read TR Parameters Read alt gps Kismet Read WP Parameters Read group 0 KML Read WP Data Write WP RT TR Data 74 For each known format eit
133. ommand Position P where P is the position format one of DMS DMM DDD GRA UTM UPS or a coordinates grid name a PFDatum Dpf command where Dpf is the datum name for the map cursor coordinates a Scale S command with S the floating point value of the map scale in pixel metre 4 20 Files in Other Formats GPSMan can import and or export data in the following formats BGA for importation of British Glider Association DOS turnpoints files as waypoints there are three optional parameters that filter which turnpoints to import feature also called place that must be given exactly as it occurs in the file findability as one of the letters A to D or G and air activity as a 1 or 2 characters string There is also a separate utility 2 4 for converting BGA DOS files to GPSMan format EasyGPS export format only for importation of waypoints Fugawi export format only for importation of waypoints GD2 for importation only GPStrans GPX for importation and exportation empty names for tracks and routes are accepted and replaced by generated names The XML character encoding tag is supported but not Byte Order Marks BOMs the default encoding being UTF 8 GTrackMaker for importation only all waypoints routes and tracks will be read from the file the other information being discarded IGC for importation of tracks only each file corresponds to a single track there is a pa rameter for selecting either GPS altitude or
134. on john_at_coastalgeology org who tested the communication with the Garmin GPS III Jos Paulo Leal and Lu s Damas Universidade do Porto who keep solving my problems with Tcl Tk Klaus Ethgen Klaus_at_Ethgen de for his great help in testing the communication with the Garmin GPSMAP 76S and in debugging the low level communication with Garmin receivers and for sending information on the Garmin GPSMAP 60C Kyle Grieser yuf_at_phoenixdsl com for all the work in testing the communication with the Garmin 12Map Lance DeVooght devooght_at_comcast net for the tests of the communication with the Garmin Forerunner 301 Laurent Bonnaud bonnaud_at_lis inpg fr for sending a list of protocols and corrections on language support files Luisa Bastos Universidade do Porto Gil Goncalves Universidade de Coimbra Jos Al berto Goncalves Universidade do Porto and S rgio Cunha Universidade do Porto for their help with geodetic formulas and information Mariusz Dabrowski mgd4_at_poczta onet pl who corrected a bug in reading GPX files with geocache names Marko Hyvarinen mth_at_sun3 oulu fi for testing the communication with the Garmin 12CX Martin Buck m_at_rtin buck de who contributed the resizing of 2D graphs and a change to track edit window Martin Ostermann Aachen University of Technology who contributed code for converting waypoint information in MapBlast HTML format into GPSMan format Mathias Herberts Ma
135. open waypoint menu if over waypoint otherwise Unix open route menu if editing it on the map non Unix finish edition of route on map lt Shift 1 gt delete waypoint from route being edited on map if any lt B2 Motion gt panning fast lt Shift 2 gt cancel edition of route on map lt Button 3 gt stop motion of waypoint if one moving Unix finish edition of route on map non Unix open waypoint menu if over waypoint otherwise non Unix open route menu if editing it on the map lt Shift 3 gt mark positions to measure distance and compute azimuth lt Control 3 gt lt Control Shift 3 gt not when loading an image or editing a route on map edit previous stage of route being edited on map if any edit next stage of route being edited on map if any lt Button 4 gt lt Shift 4 gt lt Control 4 gt lt A1t 4 gt lt Button 5 gt lt Shift 5 gt lt Control 5 gt lt A1t 5 gt scroll up move map down scroll up move map down fast scroll left move map right fast scroll left move map right scroll down move map up scroll down move map up fast scroll right move map left fast scroll right move map left 105 C 3 Notation for Events Mouse lt Button n gt mouse button 1 left 2 middle 3 right n gt 3 used for wheel mouses lt Bn Motion gt mouse button n and mouse motion lt Double n gt double click with mouse button n Mouse and keyboard lt Shift n gt mouse butto
136. operation that creates new items of the same type by cutting the original item at certain points in answer to suggestions by Zvi Grauer zvi grauer_at_gmail com e side view elevation graphs now answer to Control key and mouse left button showing the number of the nearest point its altitude and cumulative distance or time contributed by Benoit Steiner benetsteph_at_tfree fr There is a new button for displaying hiding vertical grid lines asked by Rudolf Martin rudolf martin_at_gmx de Distances in the horizontal axis are now shown and gaps between segments are displayed as interrupted lines e new values in computation of track parameters cummulative ascent height of climbing contributed by Benoit Steiner cummulative descent maximum and minimum altitudes asked by Rudolf Martin total distance and time not considering gaps between segments the average speed is now computed not considering gaps between segments Altitude related parameters only shown if there is altitude information and total distance and time not considering gaps only shown if different from totals including gaps e enhanced support for the least squares fit geo referencing method that can now be used with the affine affine conformal and affine conformal with no rotation transformations and produce information on the deviations of control points after a least squares fit with the kind assistance of J B Mehl who provided the formulas and helpe
137. options are dev DEVICE gives the serial device path log creates a log file of the serial communication named logfile in the GPSMan user directory rec Garmin Lowrance Magellan changes the brand of the receiver NOTE at present will only work with Garmin this option can be useful to override the options in the preferences file cannot be used with the readput command nor with the prefs option and cannot occur after the prot option prefs PREFSFILE gives the path for an alternative preferences file read after the user preferences file cannot be used with the rec option prot PROTOCOL selects the protocol to be used overriding the default protocol given in the pref erences file cannot occur before the rec option the show protocols 5 3 command can be used to find out which protocols are available 72 Options not related with COMMAND will be silently ignored GPSMan exits with either a 0 if the command was successfully executed or a 1 if not Some commands will write information to the standard output channel Error messages can possibly be written to the standard error channel but most of the errors will not be explained In case of doubt the graphical mode should be used to see if there are problems with files or the receiver Note that in command line mode the saved state is not restored and the state is not saved unless the graphical mode is entered Available commands are is available exits with 0 5 1 is
138. order to be translated to the user selected language 3 when the code is large it should be replaced by a call to a procedure whose arguments are the plug in parameters 4 procedures needed by plug ins should have names starting with PCode_ and their definitions should appear at the end of the plugins tcl The pre defined plug ins can also be inspected from the Definitions menu button along with the user defined ones 87 Chapter 7 Support for Lowrance Magellan and Garmin Receivers 7 1 Support for Lowrance receivers Support for Lowrance receivers was developed by Brian Baulch baulchb_at_hotkey net au who has written a draft supplement for the present document that can be found in Appendix A 7 2 Support for Magellan receivers The support for Magellan receivers is a contribution of Matt Martin matt martin_at_ieee org 7 3 Support for Garmin receivers Most Garmin receivers including recent models using only the Garmin USB protocol in a Linux system should connect with no problems to GPSMan Known exceptions are the following models GNC 250 250 XL 300 and 300 XL and GPS 150 GPSMan supports the Garmin USB protocol in Linux systems with a kernel having the Garmin USB driver written by Hermann Kneissel that is standard in kernels 2 6 after at least 2 6 11 see the section on installation 2 6 for information on compiling a custom kernel WARNING some recent Garmin receivers will need at least version 0 28 of this d
139. our particular unit 2 Getting Waypoints from the GPS unit The Lowrance GlobalNav 212 receiver stores up to 999 Waypoints internally GPSMan downloads all 999 whether valid or not The indices of invalid Unallocated Waypoints are listed by GPSMan and unused index numbers allocated when new Routes are made or new Waypoints are created by GPSMan For this reason all Waypoints and Routes are read into buffers on initialisation of the serial interface This read operation can take nearly two minutes at 19200 baud please be patient The buffer mentioned above is not read into GPSMan memory until the Get WPoint and Get Route buttons in the GPSMan GPS Receiver window are clicked This should be done before creating any Waypoints or Routes with GPSMan all Waypoints and or Routes should then be saved to the receiver before exiting GPSMan 3 Waypoint Names GPSMan is now able to handle Waypoint names containing spaces so spaces are no longer automatically deleted Note that the ASCII characters 7 and can also occur in Lowrance along with the ASCII space character 98 4 Lowrance Trails The terms trail and track are used interchangeably by GPSMan 5 Time Offset GPSMan for Lowrance does not use the Time Offset setting under the options menu However it is recommended that this variable be correctly set for compatibility reasons All times are displayed in local time not UTC This p
140. owing is a list of all the possible fields the actual set used by each receiver depending on the protocol it uses e satellite identification number PRN e GPS week number 0 1023 since 22 August 1999 in fact since 6 January 1980 but goes back to 0 every 1024 weeks e data reference time or time of applicability number of seconds in orbit when almanac was generated e clock bias in seconds af 0 e clock drift in seconds per seconds af 1 e eccentricity of orbit e square root of the orbit semi major axis e mean anomaly im degrees angle travelled past the longitude of ascending node negative when going from the apogee to the perigee e argument of perigee angle along the orbital path from the ascending node to the perigee in the direction of the satellite motion e right ascension at the time of almanac geograpic longitude of the ascending node of the orbit plane at the weekly epoch e rate of change of right ascension e orbital inclination angle between orbit plane and the equator e satellite health 0 meaning usable If the satellite identification numbers are missing the order of the lines is the one provided by the receiver and is expected to follow the satellite numbers from 1 to 32 4 5 Waypoints Waypoint names can be changed using a renaming method 4 3 from e the waypoint sub menu under Data in the map window e the waypoint menu in the lists window e a group window Use WPs gt Change Name
141. point speed in the line to the next point and bearing to the next point e total distance and time e total distance and time without considering gaps between segments only shown if different from the previous ones e average speed not considering gaps distance from first to last point maximum distance from first point to any track point e if altitude information is available cummulative ascent and descent only if consistent with the selected altitude threshold and maximum and minimum altitudes e from the More menu button other results can be obtained estimated times for a hiking trail according to the Deutscher Alpenverein formulas and rest periods An elevation graph for a track can be plotted as a side view or a perspective from the track computation window if there are at least 3 track points with a valid altitude field They are similar to the elevation graphs for routes 4 6 although the side view graph can be plotted against time instead of total distance if there is valid time information Another difference is that gaps between segments are shown as interrupted lines Elevation graphs by gnuplot can also be obtained from the same window if gnuplot is avail able and there are at least 3 track points with a valid altitude field In Linux Unix systems the perspective 3D graph also needs that the user option giving the operating system command to open a terminal command line window is defined not empty Paramete
142. r each georeferenced sheet needed This file has to be manually prepared and has five or six tab separated fields in each record one record per line The fields required are Image file path The full path of the img file created during georeferencing Latitude of the bottom of the image quadrangle signed DDD format Latitide of the top of the image quad likewise Longitude of the left side Longitude of the right side Optional image name or number Can include any ASCII character including space There is no header required or permitted A simple example file example aut Images SE5401 img 17 16 138 139 5 CHARTERS TOWERS Images SE5402 img 17 16 139 5 141 MOUNT ISA For portability of recorded logs the image filename may need to be upper case only Check your GPS receiver specifications However I have not yet ever needed to re load a recorded track into the GPS GPSMan capability is fully adequate and can handle lower case The images must be specified in degrees If working with UTM or national grids convert the co ordinates to DDD positions with GPSMan Adjacent images can overlap in fact this is preferable If a point falls into a space between adjacent images a warning will be posted by GPSMan the same warning will be posted if no aut file is loaded or the position 101 falls off the edge of the world As soon as the position falls within an image s bounds again then that image will be loaded
143. rameters for the affine transformation The support for TFW files follows the description available from the ESRI ArcGIS 9 2 Desktop Help pages 47 http webhelp esri com arcgisdesktop 9 2 Data support in ArcGIS Raster data Prop erties of raster data World files for raster datasets Unfortunately there is no publicly available description of the Ozi map file so that the implementation is based on a popular guess of the meaning of the values in it and on observing sample files A GPSMan Least Squares file 4 19 3 contains either waypoint names or the geodetic coordi nates of control points as well as their pixel coordinates to be used in computing the parameters of any kind of transformation When using a transformation file the only thing to be done is to select either the entry Map gt Background gt Load from the Map menu button if the main window is the map window or the entry Load of the Background menu button if the main window is the lists window select the appropriate file method and choose the file In the case of a TFW or a OziExplorer map file GPSMan checks if there is a file with the same base name as the image file and the extension TFW tfw or MAP map and uses it if there is After this the projection and the datum are selected changed and a dialog window may appear if there are projection parameters that can be changed With a OziExplorer map file only part of the information in the file is used namely t
144. reads data from a file in a user selected format and writes it to another file in another selected format GPSMan prints the projected coordinates of a point using a given projection GPSMan reads a data file and launches the graphical interface GPSMan launches the graphical interface and enters the travel mode GPSMan produces an image information file from geo referencing data GPSMan produces a file of waypoints obtained by geo referencing files based on their time stamps GPSMan executes Tcl Tk scripts and scripts made up of GPSMan commands Chapter 2 Programs 2 1 Current version The current version is GPSMan version 6 4 4 2 a stand alone Tcl Tk program that communicates directly with the GPS receiver See Appendix D for a list of new features 2 2 Downloading GPSMan The GPSMan site at http gpsman sourceforge net makes available GPSMan version 6 4 4 2 for downloading Debian Fedora and RPM from deb packages as well as a FreeBSD port are also available for easy installation in Linux GPSMan can also be retrieved as part of the Debian Ubuntu and Fedora official Linux distri butions FreeBSD Unix and of the Linux Live CDs AI9NL and GIS Knoppix In order to run GPSMan Tcl Tk preferably version 8 4 or later must be previously installed It can be got from the Active State site at http tcl activestate com The following Tcl Tk libraries will be used if they are installed e gpsmanshp a library that provide
145. river This driver also implements the Garmin serial protocol so that a receiver connected to the USB port can also use it The serial protocol will be much slower than the USB protocol GPSMan must be set to use one of them by selecting the appropriate entry in the protocol menus of the receiver window or the receiver menu The receiver must be set to use one of the Garmin USB or serial protocols in case this can be configured In some receivers there is a Interface display under Setup where the Garmin Garmin or Garmin option must be selected Alternatively for real time logging only it can be set to use the NMEA 0183 protocol by selecting the NMEA option For the use of this protocol see the description of real time support 4 17 88 When using a Garmin protocol GPSMan may need to convert between bytes and floating point numbers Tcl Tk has no machine independent way to do these conversions and GPSMan only implements them for little or big endian architectures that follow the IEEE floating point standard this will cover most personal computers and workstations Some Garmin receivers do not use protocols having floating point numbers and are not affected by this In any case when connecting to the receiver GPSMan tests whether there are problems with the conversions in which case the user is asked to confirm or cancel the operation GPSMan follows closely the Garmin GPS Interface Specification dated 19 May 2006 001 000063 00 Rev
146. rmediate values that may indicate approximation errors the area is computed by first projecting the polygon onto the plane using the Transverse Mercator projection centred at the first point of the polygon and applying then an algorithm for computing the area of a non self intersecting polygon on the plane A warning message is issued if this happens 4 7 Tracks A track has a datum for all its points a colour and a width in pixels used in displaying it on the map The colour will be sent to the GPS receivers supporting it in which process a colour matching algorithm will be applied if the original colour is not in the set of colours accepted by the receiver Any colour matching algorithm may give unexpected results and the one used in GPSMan is no exception A map background image name can be given for each track so that when the track is displayed on the map window the named image is automatically loaded if the map is empty See below 4 13 for the details Each track point has the following information time stamp position always shown in the DMS format altitude and depth in either metres or feet depending on the existing option for this A track can be subdivided into segments by some receivers at points in which the GPS fix was lost The first track point always starts a segment and any other track point can be marked as a segment starter from the track edit window by using the mouse right button on the last column of the poi
147. rminal window is used to run gnuplot a Return or Enter key on it makes gnuplot exit normally while an interrupt usually Control c or destroying the window will abort the operation A speed graph for a track can be plotted from the track computation window if there are at least 3 track points with valid time information It is similar to the side view elevation graph and can also be plotted against time instead of total distance but does not answer to Control key plus mouse left button A climb rate graph for a track can be plotted from the track computation window if there are at least 3 track points with valid time information The graph is plotted against time the vertical units being user selected altitude unit per second Tf there is enough points a noise reducing filter kindly provided by Paul Scorer is applied to the data Creating a waypoint from a track point can be done by double clicking with the mouse left button on a track point listed in a track window This will open for edition a new waypoint having the same coordinates unless there is already a waypoint being edited If the track is currently on the map the number of each track point together with the track name will appear in the help balloon when the cursor is over the point A waypoint with average coordinates can be created from a track window Its latitude longitude and altitude will be computed as the averages of the latitudes longitudes and altitudes of the track
148. rogram uses the Lowrance LSI 100 interface protocol rev 1 1 Copies of this protocol are available from www lowrance com c 1999 2000 Brian Baulch baulchb hotkey net au Feedback welcomed 99 Appendix B Support for real time logging variant for the Lowrance WARNING Use of a laptop computer by the driver of a moving vehicle incurs risk Use this program at your own peril Do not attempt keyboard or mouse input whilst moving FKK KK KK KK FK K FK K K FK K FK K FK FK FK FK K FK K K K K Welcome to GPSMan autoMapic FE AC k kkk k kkk k kkk k GPSMan autoMapic is beta software designed to give moving map real time plotting It is not receiver specific and should work with any GPS receiver that has the ability to output a standard NMEA 0183 v2 0 GGA sentence It has been developed on a ThinkPad 380 150Mhz Pentium using a Lowrance GlobalNav 212 receiver GPSMan autoMapic has been tested with both the Auslig RASTER250K map series 150 dpi original margins cropped map sliced into three sheets 1 degree latitude by 0 5 degree longitude by the author and with a4 scans 150 amp 120 dpi such as city street maps It also has operated sessions in excess of 12 hours and 980 km travelled without any operator input required Track log files The software writes a log file to disk in the current directory for each map image loaded These files have the name mapname trk derived from the mapname img of the
149. rs are first selected and if waypoints are to be displayed in the graph a group with waypoints must be selected cancelling this selection means no waypoints are required The graph images are written to a file in the current directory whose name is one of the parameters if the file exists it will be silently overwritten For the side view 2D graph the parameters define how some values total values rest periods time speed should appear the output file the maximum minimum distance from the track that a 33 waypoint should be to be displayed in the graph and the graph dimensions in pixels For efficiency distances of waypoints to the track are computed in a inaccurate way If the Img Tcl Tk library is available the graph will be displayed in a GPSMan window Otherwise if the user option giving the operating system command to display an image file is defined not empty this command is executed to display the graph The perspective 3D graph has parameters for the direction in which to take the track the output file and the graph dimensions in pixels Selecting a group with waypoints makes all of them to be displayed irrespective of their distance to the track After these steps gnuplot is run to display the graph allowing for it to be changed the mouse left button rotates it and the middle button changes the altitude scale Exiting normally from gnuplot will make it write the image to the output file and finish In Linux Unix systems a te
150. s dos2gpsman tcl converts BGA British Gliding Association DOS turnpoints files to GPSMan It was contributed by Paul Scorer p scorer_at_leedsmet ac uk It reads from and writes to the standard input and standard output unless otherwise specified by the arguments which are p feature f findability a air_activity Ti in_file o out_file h help where findability is a letter in A to D or G and air_activity is a 1 or 2 characters string 2 4 5 Splitting a Shapefile into quadrants shape2quadr tcl reads a Shapefile and from a list of quadrangles defined by extreme latitude and longitude produces GPSMan files one for the set of items in the file that belong to each quadrangle Quadrangles may overlap Items may belong to more than one quadrangle This utility may prove helpful for dealing with large Shapefiles It can be called in two ways e giving a name and the extreme coordinates of each quadrangle the arguments in call being FILE PREFIX NAME LONGMIN LONGMAX LATMIN LATMAX where NAME is the name of each quadrangle e defining a grid of quadrangles the arguments being FILE PREFIX d QPREFIX LONG LONGRANGE STEPLONG MAXLONG LAT LATRANGE STEPLAT MAXLAT where QPREFIX is used in generating names for the quadrangles each quadrangle having an extent of LONGRANGE by LATRANGE the first has the southwest corner at LONG LAT and the southwest corners of the others follow at steps of LONGSTEP and LATSTEP and will not be
151. s a character are commands Format definition commands used to describe the format used thereafter before the definition of waypoints routes polylines and tracks a position format and a datum must be given Format P T D where P is the position format DMS DMM DDD GRA UTM UPS or a coordinates grid name T is the time offset relative to UTC a floating point number between 12 and 12 1 meaning 1 hour less than UTC and D is the datum name to end of line The time offset must be given in files having waypoints with creation dates tracks or laps Different time offsets are not allowed in the same file beware of concatenating data files Position P where P is the position format DMS DMM DDD GRA UTM UPS or a coordinates grid name Datum D where D is the datum name to end of line Creation B where B one of yes or no states whether creation date fields are used Data commands used to start a data section 62 W next lines up to another data command or end of file describe waypoints R N definition of route name or number N After the name and a tabulation character a comment will appear After the comment a new tabulation may appear followed by fields separated by tabulations giving attribute value pairs under the form Attr Val The possible attributes are width colour and mapbak for the width in pixels and the colour of lines on the map window and the map background t
152. s in the Save menu save as text the contents of the columns either in a one shot fashion Existing log or writing the current contents and writing each new information when it comes up continuously In the latter case the file will be closed when this menu entry is deselected or when real time logging is stopped The text obtained with this menu cannot be re loaded by GPSMan To save the information in a format readable by GPSMan the Make TR button should be clicked to create a track which can then be saved and loaded in the normal way The moving map works as the animation for a track described above 4 7 The main difference is in the scale that instead of setting the animation speed sets the logging interval For the time being there is no automatic loading of background images a feature present in the variant for the Lowrance 58 The travel navigation interface provides e two alternative displays configurable by the user to show real time logging data and navi gation information e navigation information including warnings to record the current position and return to it MOB man over board create a waypoint whose coordinates are those of the last point in the real time log this fails if the waypoint edit window already exists go to a selected waypoint follow a selected route track or polyline go back following in reverse the real time track since travelling was started e a Change me
153. s may be launched from buttons and or menu entries that are created for them in certain toplevel windows Information on these windows and where the widgets can be created is kept on the global array PLGSWelcomed defined in file plugins tcl Each index is a Tcl glob pattern for the paths of windows this allows for similar windows to be dealt with in the same way Each element is a list of lists whose heads are widget types button or menu and whose rests are sub window paths relative to the path matching the glob pattern where the plug in widgets or entries will be inserted For a button the sub window is a frame managed by grid and the button is created at the right of the lower right corner For a menu entry the sub window is a menu and the entry will be the last one The widget will be disabled if the plug in cannot be used according to the evaluation of the corresponding expression A GPSMan procedure that creates a toplevel window having support for plug ins calls the procedure AttachPlugIns that in turn creates the widgets for all plug ins that can be called from the window This creation fails silently for any widget whose sub window does not exist 6 3 Plug in code and execution Each plug in definition has a list of alternating parameter names and Tcl expressions Parameter names must be valid Tcl variable names and start with underscore The expressions are evaluated in the context of the procedure that creates each plug in widg
154. s the means for creating and reading files in the ESRI Shapefile format it is available from its page at http gpsmanshp sourceforge net e Img a library implementing enhanced support for graphics and graphic formats it is part of recent Tcl Tk distributions exif a Tcl Tk package that is part of the standard Tcl Tk distribution used here for trying to know the time stamp of picture files when geo referencing them e TclCurl a library with bindings to libcurl that gives support for accessing World Wide Web servers it is provided by the Debian Linux package tclcurl 10 2 3 External utilities The following external utilities might be used if available e gnuplot to produce elevation graphs for tracks e which or whereis to check whether a program is available e exif and or metacam to get the time stamp of picture files when geo referencing them 2 4 Separate GPSMan utilities The GPSMan distribution includes in the util directory some other utilities that can also be downloaded from the GPSMan site The first three below were not integrated into GPSMan because the format of the HTML pages they read does not follow any known specification and may change at any time They must be edited for configuration and GPSMan must be installed before they can be used 2 4 1 MapBlast waypoints mb2gmn tcl converts the waypoints listed in HTML pages of the MapBlast site into GPSMan files At its core is code contributed by Martin
155. show window A control window will appear that allows for re starting pausing or aborting the animation for skipping to the next track point for setting the speed the scale changes are exponential and for choosing whether the last point shown will be centred on the map window The default speed is that in the track the delay between the presentation of two consecutive points is the difference between their time stamps Ifa time stamp is not defined the default delay is 30 seconds The state of the animation the total real time since the beginning if defined the time stamp if defined and total distance along the track are displayed A track can be created from a route or a polyline from the route window or the polyline window 4 8 Polylines Polylines have a datum and a position format for all its points a colour and a width in pixels used in displaying it on the map A map background image name can be given for each polyline so that when the polyline is displayed on the map window the named image is automatically loaded if the map is empty See below 4 13 for the details Changing the position format to grid coordinates may produce the following effects e the polyline datum is changed to the datum required by the grid 35 e some all positions are shown as undefined either O 0 or 0 if they are out of the scope of the grid this however will not affect the internal representation of the position and a change to
156. super user privileges or the permissions of the port are changed to give read write access to a group of users or to all users The latter is dangerous in that it creates security problems In any case super user privileges are needed to install the software or to give access to the serial or USB port group For security reasons in Unix Linux systems the program cannot be run by the super user This constraint can be overcome by editing the source file main tc1 finding the line that contains cantexecasroot and doing the change described in the comment before it Support for the Garmin USB protocol needs a Linux kernel with the garmin_gps kernel driver which is part of the official kernels since version 2 6 11 WARNING some recent Garmin receivers will need at least version 0 34 of this driver To include the driver when compiling a custom kernel the option under USB support USB Serial Converter support Garmin GPS driver in the kernel configuration interface should be checked The name of this option is USB_SERIAL_GARMIN The system administrator may have to intervene if any installed application requires this driver to be blacklisted making it unusable 2 6 1 Debian and other Linux distribution packages The installation is done as with other such packages and there is no need for manual configuration Users of GPSMan must belong to the group that owns the serial port to be used normally dialout 2 6 2 Other Unix and Linux
157. t implementation of elevation graphs for tracks and routes both in 2 and 3 dimensions support for Italian and exportation of data in OziEx plorer format Niki Hammler http www nobaq net Perl script for reading waypoint data in Fugawi export format which was translated into Tcl and incorporated in GPSMan Martin Ostermann Aachen University of Technology conversion of waypoints listed in HTML pages of the MapBlast site into GPSMan data Val re Robin valere robin_at_wanadoo fr support for French importation of EasyGPS export format and importation and exportation of GPX and KML formats David Wolfskill david_at_catwhisker org FreeBSD package Rob Buitenhuis geo_at_btnhs nl support for Dutch Frank Kujawski Frank_at_Kujawski org conversion of routes listed in HTML pages of the MapsOnUS site into GPSMan data Tri Agus Prayitno acuss_at_bk or id support for Indonesian Matt Martin matt martin_at_ieee org communication with Magellan receivers Stefan Heinen Stefan Heinen_at_synopsys com new data structures for datums the pro cedure to access them and changes to improve the focus policy and bindings under MS Windows Heiko Thede Heiko Thede_at_gmx de shell and Tcl scripts that convert export files from Map amp Guide and related software Falk Power Route to files in GPSMan format and which were incorporated in GPSMan Sabine Broda sbb_at_dcc fc up pt support for German since version 6 0 Alber
158. t or after the last point e Loop a copy of the first point is added to the end of the polyline e Delete deletes all the selected points e Clear deletes all points A polyline can be splitted by taking either each selected point or segment starter as the first point of a new line extending up to and excluding the next such point Lines with at least two points obtained in this way are created as well as a group with all of them These new lines inherit the datum the position format segments unless when splitting by segment starters width colour and map background of the original line They and the new group get names generated automatically The original line is not affected by this operation A polyline can be converted into a track from the polyline window keeping the information on segments 36 4 9 Laps Laps are only supported for Garmin receivers most of which do not use them and if the corre sponding option under receiver parameters is selected Laps have a time stamp for its start a duration the total distance the calories spent the start and stop positions and an associated track The only fields that can be edited are the remark the position format and the datum Further information is computed by GPSMan namely the time stamp for the end point and the average speed Some of these fields may be undefined and will be left blank The associated track is only meaningful if its number is less
159. t will always put it after all the elements of the same type Groups can have other groups as elements but one group cannot be an element of itself even if indirectly in technical terms groups are well founded sets This property can be explained as follows Groups that are elements of a group G can be seen as its sons These groups may have their own sons which are called the grand sons of G and that in turn may have sons the grand grand sons of G and so on All the sons grand sons grand grand sons and so on of a group form the set of its descendants A group is well founded by not being its own descendant Some operations on a group will act not only on its elements but also on the elements of all its descendants In this case the first step is to collect all these elements by a recursive inspection of the group descendants Clearing from the map an item that belongs to a group that has been displayed will not affect the display state of the group To be sure that all the elements of a group are actually displayed the user should clear the group from the map and then display it again Deleting from or adding items to a group will not affect their display state Forgetting a group will delete permanently the group from the data base but not its elements This operation is not prevented by the fact that any of its elements cannot be cleared from the map Forgetting a group and all its elements will delete permanently not only the
160. tance corresponding to the given line length The possible values for this distance depend on the choice of unit made before default font fixed monospaced font map font travel window font and elevation graph font the possible values are default for the default Tcl Tk font not recommended for the fixed font fixed or a list or string with fixed followed by a size in points a Tcl Tk font description that can include the font family and parameters for the size weight slant underline and overstrike The fonts for the map the elevation graphs and travel window can be changed while running the program size of icons used for the waypoint symbols either 15x15 or 30x30 in pixels GPSMan logos are adjusted to the selected size interface appearance number of maximum elements per menu initial positions of windows dimensions colours saving the program state on exit and deleting the saved state files after restoring permission of created files in Unix numeric notation default paper size and usable paper dimensions abbreviated names for months in all known languages paper sizes and dimensions used when saving plots or maps as Postscript files The dimen sions are floating point numbers followed by c for centimetres i for inches m for millimetres or p or nothing for printer s points 1 72 inch 18 output formats for floating point coordinates in seconds minutes degrees and grades ob viously changes
161. ted from the geodetic coordinates and pixel coordinates of the control waypoints An alternative for some transformations is to have a transformation file either with the parameters values or with pairs of geodetic pixel coordinates When geo referencing an image to be loaded from a file in one of the accepted graphics formats the following information must be known e the projection used in the image e the datum e the coordinates transformation to use unless there is a transformation file defining it see below 4 13 2 If the image is that of a map the projection and the datum will hopefully be described in it The corresponding options should be selected from the two menu buttons at the left on the bottom of the map window if the map window is the main window or the Datum and Projection menu buttons of the map window if the lists window is the main window If a transformation file is used the projection and the datum are selected from a dialog after the file is read 45 As to the datum it must be emphasised that some maps have a cartographic datum the one used for projecting the map elements and then one or more sets of grid lines projected using other different datums The datum to be selected in GPSMan is the cartographic one not any of those for the grids On the other hand if the intersection points of a grid are to be used as control points for geo referencing the image the datum for the grid should be used when creatin
162. tems and that re numbers routes when sending to the receiver and for his help in debugging David Kaplan dmkaplan_at_ucdavis edu for contributing the RPM packages of GPSMan 2003 2004 David Wolfskill david_at_catwhisker org who prepared a FreeBSD package of GPSMan and helped with the use of the Img package Edouard Lafargue who tested the communication with the Garmin eMap Eduardo Veloso who kindly provided links to information on aviation symbols Elric Milon Beltran elric_at_grupoikusnet com for his help in debugging the support for the Garmin EDGE 205 Fecz k Szabolcs feczo_at_siodigit hu for his help in debugging the support for the Garmin EDGE 305 Frank Jordan Universit t Duisburg for his help and patience in testing the communication with the Garmin eTrex receiver for his suggestions on improvements to GPSMan and for his help in the process of making the GPSMan Debian package a part of the official Debian distribution Frank Kujawski Frank_at_Kujawski org for the tests with the eTrex Legend and the contri bution of code for converting route information in MapsOnUS HTML format into GPSMan format Hans Olzem holzem_at_cantv net who helped with the testing of the communication with the Garmin GPSMAP 276C Harald Koenig Universitat T bingen for the tests of the communication over a USB serial port under Linux and his suggestions Harald Stauss harald stauss_at_web de for his help in debugging his sug
163. than 223 In this case and if there is a track in the current data base whose name is that number it is possible to display the track on the map from the lap window Laps are identified by the start time formatted according to the current date format These names must be unique implying that two laps cannot have the same start time Even if in a session the date format changes and laps with the same start time are saved to a file loading the file in a different session will result in all but the last such lap to be available When getting laps from the receiver laps will be aggregated in runs For each run a group is created Runs are computed as follows from the sequence of laps sorted by increasing start time a run is built for the first laps until and including a lap either having a track number less than 225 or being the last in the sequence and having a track number equal to 255 the same process is then applied to the rest of the sequence As laps are loaded only if the support for laps is active some care should be taken to avoid loss of data For instance laps data will be lost if one loads a file having laps when laps are not supported and saves the current data base under the same file name The list of laps is sorted in reverse chronological order more recent lap at the top 4 10 Groups Groups are very useful in cataloguing the available data and in operating on sets of items The possible operations are e to forget items
164. the elements of any of their descendants For this to take place select the type Group along with the type of items to be transferred 4 11 Searching for data items In order to search for data items the user specifies a set of constraints An item will be included in the search results only if it verifies all the constraints in the set that are applicable to its type The types of items to be searched for can be more than one to each type being applied only the constraints that make sense for it The search domain is either the entire data base or a set of groups In the latter case the search will be recursive i e will also explore the groups that are elements of the given groups and so on Furthermore if the search includes the type Group the given groups will be included in the search results The patterns for searching by names comments and or remarks follow the Tcl Tk glob com mand conventions In brief 1 stands for any single character stands for zero or more characters xyz stands for any of the characters within the brackets a z stands for any character in the range a to z inclusive Sro Mai Yity c stands for the character c The distance to a waypoint or to a location given by its coordinates can be used to search for waypoints a related operation is making clusters of waypoints 4 10 and or tracks With tracks all track points of each track may have to be checked what may take a long time Th
165. thias Herberts_at_iroise net for the information on how to use GPS Man under MacOS X systems Matt Martin matt martin_at_ieee org who implemented the support for Magellan receivers Max Spring mspring_at_cisco com for testing the communication with the Garmin eTrex Mariner 93 Nigel Orr gps_at_river view freeserve co uk who contributed the conversion of routes listed in HTML pages of the GreenFlag site into GPSMan data Niki Hammler http www nobaq net who wrote a Perl script for reading waypoints data in Fugawi export format Nikolai Kosyakoff priroda net_at_gmail com who contributed the support for Russian Odilon Ferreira Jr odilonf estaminas com br the author of GPS TrackMaker who kindly provided information on the file formats and datums used by his program Paul Scorer P Scorer_at_leedsmet ac uk who suggested the importation of FAI IGC data files and the drawing of climb rate graphs kindly providing a noise reduction filter for them and contributed code for importing BGA DOS turnpoint files Peter H Dana University of Texas who provided help in correcting bugs in the conversion of UTM UPS coordinates and information on map projections Pierre Thibaudeau prt3_at_sympatico ca for all his effort in debugging the communication with the Garmmin Forerunner and exportation to Ozi files Povl H Pedersen pope_at_my terminal dk who corrected a bug in the implementation of the Garmin protocol Rob Buitenhu
166. tion and links by Garmin At present GPSMan deals with three data fields for each stage a comment a label that will appear in the map and hidden information Data items refer to the elements stored in the GPSMan data base Apart from the data items used in GPS receivers GPSMan also works with e polylines LN also called polygonal lines that are similar to tracks but have points LPs without time stamps Polylines are mainly used as background in the map window e groups GR can be seen as sets of items or alternatively as directories folders containing items They can be used to collect together items that are related to each other they allow for operations to be performed on a set of items and they can be the result of operations yielding a set of items for instance the result of a search Track and polyline segments are subdivisions that in the case of tracks normally indicate that there were time gaps in which the receiver got no position information The representation in the map of a track or polyline having different segments is a polygonal line that is interrupted between each segment segments with a single point will hardly be visible Segments are defined by their starting points and in the track or polyline edit window it is possible to mark or unmark each point except the first as being a segment starter Comments and remarks NB can be specified for some types of items The difference between them is that comments
167. titude whose default value is taken as the average of the latitudes of the first points to be mapped The Equidistant Cylindrical projection is a simplistic projection where latitudes and lon gitudes are taken as rectangular coordinates making it only appropriate for very large scale maps Its single parameter is the central latitude that in GPSMan defaults to the average latitude of the first points being mapped This projection as the Spherical Mercator is generally used with the WGS 84 datum in map imagery available on the Web such as OpenStreetMap Nasa WMS Yahoo Maps Google Maps A particular case of this projection with central latitude 0 is known as the Plate Carr e not pre defined in GPSMan When used with the WGS 84 datum it is known as the EPSG 32663 projection pre defined in GPSMan Neither of them should be used with maps far from the Equator 4 16 Distances and bearings There are two sets of formulas for computing distances and bearings that the user may choose 1 the so called Law of Cosines for Spherical Trigonometry that is not very accurate but is quite fast and 2 the modified Rainsford s Method with Helmert s elliptical terms with a high degree of accu racy but slower this method cannot be applied if one of the points is a geographical pole in which case GPSMan applies the Law of Cosines In some situations namely when computing the total distance along a track having very small distances
168. to Morales amd77_at_gulic org support for Spanish Martin Buck m_at_rtin buck de resizing of 2D graphs change in track edit window e David Kaplan dmkaplan_at_ucdavis edu RPM packages 2003 2004 e Jean H Theoret ve2za_at_rac ca code for changing the symbol of each waypoint in a group e Paul Scorer p scorer_at_leedsmet ac uk a Tel script implementing importation of British Gliding Association turnpoint DOS files e Nigel Orr gps_at_river view freeserve co uk conversion of routes listed in HTML pages of the GreenFlag site into GPSMan data e David Gardner djgardner_at_users sourceforge net creating a group from un displayed items and automatically numbering routes when sending to the receiver e Nikolai Kosyakoff priroda net_at_gmail com support for Russian 2007 e Benoit Steiner benetsteph_at_free fr displaying information on points of 2D elevation graphs and computation of cummulative ascent height of climbing for tracks e S ndor Laky laky sandor_at_freemail hu support for the EOV Hungarian National pro jection and grid e Alexander B Preobrazhenskiy modul_at_ihome ru support for Russian since October 2009 e Rudolf Martin rudolf martin_at_gmx de plug ins for creating plots of tracks using gnuplot and for other computations related with tracks Kind help from many other people should be mentioned and is acknowledged below 7 3 1 2 Main features What GPSMan does when i
169. tum based on the Bessel 1841 ellipsoid usually the Rijks Driehoeksmeting datum If the given datum is for a different ellipsoid GPSMan will change the datum to Rijks Driehoeksmeting All parameters for this projection are 54 fixed the centre is at N52 09 22 178 E5 23 15 5 in the Rijks Driehoeksmeting datum coordinates of the Amersfoot OLV church the scale factor is 0 9999079 and the constants for the conversions between the isometric latitudes in the ellipsoid and in the sphere are n 1 00047585668 and m 0 003773953832 The Netherlands grid uses the Schreiber dual projection with a false easting of 155km and a false northing of 463km and the Rijks Driehoeksmeting datum Acceptable ranges of values are 0 290000m for x 290000 630000m for y 50 3 53 45 degrees for latitude and 3 7 45 degrees for longitude The Cassini Soldner projection is a neither conformal nor equal area projection used in the 19th century It is still used for mapping areas with a small E W extent Scale is true along a central meridian and distortion increases significantly with distance from it It has two parameters the latitude and the longitude of the natural origin These parameters are taken as the averages of the latitudes and longitudes of the first points being mapped The American Polyconic projection is also a neither conformal nor equal area projection used before the computer era It has a single parameter the standard la
170. uguese Army Geographic Institute Parameters central latitude 39 66666666666667 central longi tude 8 13190611111111 scale factor 1 The datum to be used is called Lisboa Military coordinates in these maps correspond to a false easting of 200km and a false northing of 300km the Swedish Grid SEG projection Parameters central latitude 0 central longitude 15 808277777778 scale factor 1 Coordinates in this grid correspond to a false easting of 1500km e the Taiwan Grid projection TWG Parameters central latitude 0 central longitude in 6 zones of 2 degrees centred at 115 117 125 and scale factor 0 9999 Coordinates in the TWG grid have a false easting of 250km This grid is usually employed with either the Hu Tzu Shan datum also known as TWD67 or the TWD97 datum whose definition could not be found for inclusion in GPSMan e the Uniform Finnish Grid KKJY projection Parameters central latitude 0 central lon gitude 27 scale factor 1 Coordinates in this grid correspond to a false northing of 500km There is a single zone named 27E e the Basic Finnish Grid KKJP projection Parameters central latitude 0 central longitude in zones of 6 degrees centred at 21 24 27 and 30E scale factor 1 Coordinates in the KKJP grid have a false easting of z x 1000 500 km where z is the zone number The Swiss Oblique Mercator projection is a particular case of an Oblique Mercator pro jection which i
171. ull modem cable Brian Baulch baulchbChotkey net au 3 Apr 2002 copyright c Brian Baulch 2000 2002 103 Appendix C Map Mouse and Keyboard Shortcuts The tables of the following two sections summarise the availabe shortcuts for map operations The last section explains the notation for events C 1 By Operation scroll left move map right fast lt Control 4 gt scroll right move map left slowly lt Key Right gt scroll up move map down slowly lt Key Up gt scroll up move map down lt Button 4 gt scroll up move map down fast lt Key Delete gt lt Shift 4 gt scroll down move map up slowly lt Key Down gt scroll down move map up lt Button 5 gt scroll down move map up fast lt Key space gt lt Shift 5 gt scroll left move map right slowly lt Key Left gt scroll left move map right lt A1t 4 gt scroll right move map left lt A1t 5 gt scroll right move map left fast lt Control 5 gt scroll NE move map SW slowly lt Shift Up gt scroll SE move map NW slowly scroll SW move map NE slowly scroll NW move map SE slowly lt Shift Right gt lt Shift Down gt lt Shift Left gt panning slowly panning fast lt Control Motion gt lt B2 Motion gt create waypoint lt Button 1 gt lt Return gt stop motion of waypoint if one moving lt Button 3 gt open item if over item measure distance and azimuth lt
172. urther analysis A before the end of a line is taken as continuation line marker but this may cause an error if there is an unmatched quote The following commands are available for use in GPSMan scripts read FORMAT PARAMS TYPES PATH read data from a file when used from the command line this command 5 10 reads a data file and launches the graphical interface write FORMAT PARAMS TYPES PATH write data to a file get TYPES read data from receiver put TYPES write data to receiver Example the following GPSMan script WPs from the receiver to file in GPSMan format getwrite WP GPSMan myWPs gpsman save them also in Shapefile format write Shapefile dim 3 pformat UTM datum Datum 73 shape myWPs downloads the waypoints from the GPS receiver and writes them both to a GPSMan file and to a Shapefile 84 Chapter 6 Extending GPSMan Plug ins GPSMan can be extended through pre and user defined plug ins that are written in Tcl Tk and are launched from either buttons and or menu entries In order to define a plug in knowledge of programming in Tcl Tk is required while in some cases an understanding of parts of the GPSMan code might also be needed This chapter is written assuming these prerequisites 6 1 The graphical interface for plug in definitions Plug in definitions can be inspected or created from the Definitions menu button Each plug in has a name that must be unique a remark for docu
173. usb as in usb dev ttyUSBO to enforce the use of the Garmin USB protocol when this is not the default protocol In other systems execute gpsman tcl with the Tcl Tk wish program 4 2 Basic concepts Here is a list of a few terms that will be used below Waypoints routes tracks and laps are examples of data used in GPS receivers e a waypoint sometimes abbreviated to WP describes a precise location through its geo graphic coordinates e a sequence of waypoints is called a route RT and is defined by the user e a track TR also called a trail in Lowrance receivers is a sequence of track points TPs 20 recorded by the GPS receiver over a time period and giving the positions each with a time stamp of the receiver during that period and including if possible the altitude and the depth both in either metres or feet depending on the existing option for this e alap LAP has a time stamp for its start a duration the total distance the calories spent the start and stop positions and an associated track a sequence of laps is called a run and runs are represented in GPSMan by groups that are automatically created when getting laps from the receiver support for laps in GPSMan exists only for Garmin receivers and must be explicitly selected from the options receiver parameters window Route stages are the parts of a route between each two consecutive waypoints Route stages are called edges in Graph Theory legs in avia
174. ut will be to the standard output unless the format is the Shapefile format in which case the command fails Existing files will be silently overwritten This command only works with Garmin receivers Examples the command getwrite WP RT gpsman data myWPRTs download the waypoints and routes from the receiver and writes them to the file data myWPRTs in GPSMan format while the command getwrite TR Shapefile dim 3 pformat UTM datum WGS 84 shp myTRs downloads the tracks and writes them in Shapefiles with basename myTRs in the directory shp keeping altitude information 3 dimensions and using UTM coordinates for the WGS84 datum 76 5 6 The readput Command The readput command reads information from a file and sends it to the receiver readput FORMAT IN PARAMS IN TYPES PATH OUT TYPES where e FORMAT IN PARAMS is the input file format and its parameters if any use show formats 5 3 for a list of the currently accepted formats e IN TYPES are the data types to read the possible types depend on the format and some formats impose that there is a single data type per file they may be absent if the format requires a unique data type or if the files can have items of different types all can be used as an abbreviation of WP RT TR e PATH is the path to the file to read from or in the case of the Shapefile format the path to the Shapefiles basename file extensions will be discarded If the PATH is stdin input will be fro
175. ven centres for routes distances azimuths and differences in altitude between consecutive points total distance and enclosed area under certain conditions for tracks distances differences in time speed and azimuths between consecutive points cumulative distance and altitude at each point total distance and and time with and without considering gaps between segments average speed distance from first to last point maximum distance from first point to any track point and if altitude information is available cummulative ascent and descent maximum and minimum al titudes for laps stop time average speed e GPSMan can make a map to scale using one of a choice of projections showing waypoints routes tracks and polylines the map can be saved or printed in Postscript or other graphics formats if the Img Tcl Tk library is available images may be used as background for the map and geo referenced waypoints can be represented in different ways any combination of symbol and name or comment an animation of the movement along the real time track or of a recorded track can be shown on the map elevation graphs as side views or perspectives of routes and tracks can be plotted and saved or printed in Postscript or other formats if Img is available speed and climb rate graphs for tracks can be plotted saved and printed in a similar way e GPSMan allows for data items to be searched by patterns matching the item n
176. ver brand Lowrance LP see polyline point Magellan real time log see real time log Magellan receiver see receiver brand Magellan map 41 55 background image 41 44 more than one 48 name 21 29 30 32 35 create LN 41 RT 43 WP 42 cursor 44 50 datum 41 45 46 48 49 115 distance and azimuth 41 edit RT 43 font 18 geo referenced 41 45 menu for WP 42 moving map see real time log tion projection see projection scale 18 48 61 small scale 49 scroll pan 44 shortcuts 104 size 18 transformation file 47 transformation of coordinates 41 45 48 Least Squares file 47 Least Squares fit 46 Ozi map file 47 TFW file 47 MapBlast 11 MapsOnUS 11 anima menu for WP on map 42 size 18 MH coordinates 29 moving map see real time log animation name see item name navigation see real time log NMEA 0183 see protocol NMEA 0183 options see preferences OS command display image 18 34 open terminal 18 33 print process PS 18 31 41 paper size 18 platform 16 Linux 13 Debian 13 20 other 13 RPM package 13 20 Macintosh 14 non Unix 16 other 14 20 Unix 13 plug ins 85 87 polyline 21 35 36 colour 35 create 34 41 operations on 36 position format 35 reacting to events 17 segment 21 36 67 splitting 36 to TR 36 width 17 35 polyline point 36 altitude 36 position 36 position 21 23 format 18 23 28 cursor 18 grid
177. w hidden below other ones and waiting for some input GPSMan blocks or gives strange error messages when trying to connect to a Garmin receiver that has been turned off but still answers to a product information request command in Linux the Tcl Tk error couldn t load file usr lib gpsmanshp so cannot open shared object file usually means that the gpsmanshp library was not correctly installed GPSMan support for Garmin receivers may need to convert between bytes and floating point numbers Tcl Tk has no machine independent way to do these conversions and GPSMan only implements them for little or big endian architectures that follow the IEEE floating point standard Some Garmin receivers do not use protocols having floating point numbers and are not affected by this 15 Chapter 3 Configuration A few crucial parameters should be configured in the GPSMan main file gpsman tcl Default values for user options are set in the file config tcl but as they are overwritten by the values in the preferences file they are more conveniently changed when running the program GPSMan needs a user directory that will contain the users preferences file and other data and a user temporary directory The paths to these directories and the name of the preferences file are given at the beginning of gpsman tcl When GPSMan is launched and does not find the user or the temporary directories it attempts to create them and if this fails asks for them to b
178. w point and from it to the last one This procedure is repeated always replacing one of the lines for which the distance to an intermediate point is maximum The review of Heckbert and Garland 1997 describes an algorithm by Ballard and Brown published in 1982 that seems to be very close to this one Although GPSMan lets the user fix the number of points to keep between 2 and the number of track points there is a maximum number of points per route depending on the GPS receiver It should also be noted that the time needed to find the simplified line will increase significantly with the number of points although keeping all the track points will take only the time to create the new item So that a choice may be made between different numbers of points GPSMan may be asked to display the simplified line and also the original track on the map on the fly When the user clicks the Ox button the map will be restored the simplified line is used in forming a new item in the case of a route with new waypoints having names of the form ZTn with n a 4 digit integer and an edit window will be opened for editing the new item If the edit window for the item type was already in use then the item is created under an automatically generated name For a route GPSMan will create a new group with all the new waypoints for easier access An animation of the movement corresponding to a track can be viewed in the map window Animation button in the track edit
179. wise to the end of the route Control and right click e add to end i e change the insertion point to the end of the route when editing the last stage this can be done with Control and right click e close menu destroying the menu button When using Control right click and Control Shift right click to go from one stage to another the lines in the map are only redrawn when the cursor moves During the edition of the route waypoints can be moved to other positions as described above 4 12 Scrolling and panning the map can be done by using the Locate entry in the Items menu button the mouse the keyboard or a wheelmouse Selecting an item with the Locate entry in the Items menu button only items on the map are listed scrolls the map so that the selected item becomes centred In case of a route track or polyline this applies to its first point Dragging the mouse with the middle button down or moving it with the Control key pressed will pan the map The keyboard arrow keys and the Space and Delete keys scroll the map in the expected way while the arrow keys with the Shift key scroll the map in the SE NW and NE SW directions Users of a wheelmouse can use the wheel in it for the same purpose with no modifier key for vertical motion with the Shift key for vertical motion by one page with the Alt key for horizontal motion and with the Control key for horizontal motion by one page As the cursor coordinates are updated wh
180. work information kindly supplied by Mathias Herberts Mathias Herberts_at_iroise net e Keyspan USB to Serial Adapter USA19HS http ww keyspan com products usb usal9hs e Tcl Tk Aqua http tcltkaqua sourceforge net e device to use dev cu USA19 To install GPSMan unpack the gpsman 6 4 4 2 tgz archive and edit the GPSMan main file gpsman tcl for configuration see below 3 and put it where it can be executed The other GPSMan files should go into the directory whose path is given at the beginning of gpsman tcl 2 6 5 Other systems After unpacking the gpsman 6 4 4 2 zip archive the GPSMan main file gesman tcl should be edited for configuration see below 3 and put where it can be executed The other GPSMan files should go into the directory whose path is given at the beginning of gpsman tcl 2 7 Known problems The list of known problems on 6 October 2013 is 14 developers of Tcl Tk found out in May 2011 that the Tk raise command to raise a window may not work as expected in some situations As its behaviour depends on the operating system graphics support and on the window manager there is no solution they can offer GPSMan uses this command to present pop up windows in particular those asking for a confirmation or an answer and that must be attended to by the user before execution goes on This means that when GPSMan seems to block and does not answer the user should check whether there is such a windo
181. y are computed either when a data item is displayed and the map is void or when a map background image is loaded According to an option the user is asked to accept or change them When a map background image is loaded it will be geo referenced and a transformation of coordinates may be selected for that purpose There are three such transformations affine which covers rotation and non conformality affine conformal and affine conformal with no rotation that corresponds to applying only a scale factor and that is used when there is no background image Obviously there will be deformation when either the projection or the transformation is not suitable for the image More detailed explanations of how to use background images and projections and coordinate grids are given in the next sections 4 13 4 15 Measuring distances and azimuths on a non empty large scale map can be done by using the mouse right button when pressing the Shift key to select a sequence of positions at a distance greater than 1 metre Arrows between each position to the next will be displayed and a dialog will show the total distance and the azimuth of the last position from the first The arrows will be deleted when the dialog is closed The dialog allows for the line formed by the arrows to be closed linking the last position to the first unless they stand at less than 1 metre and to be used in creating a polyline item LN Note that distance values computed in this wa
182. y can be wrong on small scale maps if two consecutive points are too far away from each other Items can be displayed on the map by using the Display on map entry in the Items menu button in the map window 41 If the item has an associated map background image name and the map window is empty the image will be loaded before displaying the item If the name refers to a non existing or invalid file it will be silently ignored Please see below 4 13 for further details on how to define map background names Other methods include using the Display on map option when reading new data from files or the receiver e right clicking on a name in an items list e using the Display on map option of the edit window for an item e using the display entry in the menu that pops up with Control key left click on a waypoint in the map To clear an item from the map there is the Clear entry in the Items menu button in the map window Other ways of achieving the same effect e right clicking on a name in an items list e using the Display on map option of the edit window for an item e using the clear entry in the menu that pops up with Control key left click on a waypoint in the map Groups can also be created for the items that are or are not currently displayed on the map This is done using the Make Group entry of the Items menu button on the map window A waypoint can be created on the map if the map has been geo referenced by clicking w
183. ypes are TR a track the time stamp of each file is compared with the track points time stamps and a position is computed by linear interpolation extrapolation strange results can be caused by track points being widely apart in distance or time GR a group the files are sorted by their time stamps in increasing order and each file is put into correspondence with a waypoint in the group in the order they appear there undefined waypoints being discarded if there are more files than waypoints the last waypoint is used for the remaining files e PROC PARAMS the processing parameters can be id ID gives the name or identifier number of the item to be used from the input file if not given the last item of IN TYPE that was read in is used date DMODE describes how file time stamps should be retrieved DMODE being pict the default the file is a picture file the time stamp should be got from the EXIF tags in the file the following methods will be tried in sequence using the Tcl exif package running the exif or the metacam external utilities if all of them fail the file is discarded 82 x exif the file is in the EXIF format as produced by exif or metacam and the time stamp is retrieved from the EXIF tag fmod the file last modification time as given by the operating system is taken as time stamp dh DHOUR gives the difference in hours of the time zones of the track and files time stamps a positive valu
184. z the value 1 stands for unknown the number of satellite measurement stations and the zone of validity given by S N latitudes and W E longitudes All these fields are for information only and may be empty The definitions can be inspected but not changed from the corresponding entries under the Definitions menu button It should be noted that some datums have variants for different regions For instance the European Datum 1950 has at least 15 such variants and it has been observed that Garmin receivers do use the local variant for Portugal Spain when this datum is selected and a waypoint in Portugal is created This means that using the average European Datum 1950 in such a situation may lead to large position errors Probably the same will happen with other datums having variants Users may define their own datums and ellipsoids from the entries under the Definitions menu button These definitions that cannot override those in GPSMan are automatically saved in a file in the GPSMan user directory and will be loaded when GPSMan is started Currently GPSMan does not prevent changing or forgetting a datum or ellipsoid that is in use it is the user s responsability to avoid inconsistencies due to such operations When sharing files having data depending on user defined datums with other users the definitions of the relevant datums and ellipsoids should also be shared 4 15 Projections and coordinate grids 4 15 1 Selecting and defi

GPS Manager User Manual

Contents

Download Pdf Manuals

Related Search

Related Contents