Advanced Settings

General:

  • Time Source: There are two possible sources of time information: the GPS time provided by satellites, and time provided by your device (set in control panel). GPS time is always accurate. GPS reports universal time (UTC), but the application can convert it for you to local time according to time zone set in Windows control panel. When you are planning trip across time zones, it's best if you get time from GPS and log it as UTC time. (Unless you have a "smart" phone that can switch time zones automatically)
  • Altitude correction: GPS altitude is somewhat different from altitude you can see in maps or Google Earth. This may cause the track to be rendered in mid-air or underground. You can easily instruct Google Earth to ignore track elevation (in case of points it's not as easy because you must change the setting for each point separatelly). The difference between GPS altitude and true altitude is caused by the way how it is measured by GPS and traditionally. GPS uses some unified ellipsoid (WGS84) model, while traditional measurement uses some local sea level whih can vary by the sea actually used. Altitude correction in advanced GPS altitude usually differs from altitude you can see in maps or Google Earth. This is caused by different style of measurement - GPS uses WGS84 ellipsoid. The difference is usualy constant for one map in certain area and good map gives you he information about the difference, so you can set-up correction here. Bad or no correction may cause your tracks and points to be rendered in mid-air or underground. You can turn altitude logging off as well (in settings screen). For yachting it is really not important.
  • Start Immediately: Checking this forces the application to log first point immediately when you click Start, disable it if you'd rather take it easy.
  • Minimal distance: When you move, you'll observe that the GPS tracks are quite accurate. If you stand still, you'll see points scattered all around you. This option can let you prevent GPSTracka from logging points near your last logged location by setting up a minimum required distance between two points being logged. Experiment with it. The right number will depend on your GPS receiver, how fast you are moving and the precision you want. When walking, try 5 to 10 meters.
  • Pause after X invalid positions: This indicates the number of invalid positions received before the application should stop attempting to read GPS data and wait for another polling interval. This is ignored after start until the first valid position is received. This is useful because GPS drains battery power and you don't want it running if it's not getting valid data. Keep in mind, though, that a small number here can prevent the app from ever finding a lock on a satellite. 0 - never pause.
  • Keep awake devices: Comma-separated list of names of devices to keep awake when GPS is running - you'd use this if you have external devices attached. Enlist device names such as GPS0 or GPS0:. Colon-terminated devices will be kept awake only during GPS cycle; other devices will be kept for whole time when GPSTracka is logging. Unknown devices are skipped. When not using Windows GPS diver, the COM port is kept awake automatically for whole time when GPSTracka is logging.

Display:

  • Status bar: Check this to show status bar at mine screen. It shows current status of GPS operation, count-down timer for polling interval and very approximate speed.
  • Clear log every X lines: Having text in the textbox consumes your phone's memory. If you're logging frequently, then the memory consumption will shoot up. Setting this to a non-zero value will make the textbox clear itself when it receives that many lines of text. This will not affect the log file.
  • Log format: The format of information writtent to log text box at main screen. See below for details. Actual format can be tested using the ? button.
  • Info pane: Check to show info pane with various statistic information in main screen.
  • Speed unit: Unit used for displaying speed values.
  • Distance unit: Unit used for displaying distance values.
  • Elevation unit: Unit used for displaying elevation values. Also affects value passed for formatting (log, KML). Does not affect value recorded in log file.

KML

Here you can set up KML (Google Earth) file generation.
  • Name format: The format of name of each point placemark in KML. See below for details. Actual format can be tested using the ? button.
  • Desc format: The format of description of each point in KML. See below for details. Actual format can be tested using the ? button.
  • Line color: Color of line in KML file. Color can be set by typing R, G and B values or by clicking one of predefined colors at left side. There is color preview at right side.

  • Formatting: Formatting is a tricky and slightly convoluted process used by programmers in .NET to display date, time, numeric and other values in different formats. In this specific case, string formatting replaces each occurence of {x} with a string representation of the corresponding object. x is decimal number - 0-based index of object. More, {x} can be in format {x,len}, {x:format} or {x,len:format}.
  • x: 0-based index of object passed py application to formatting. Actual value depends on application.
  • len: Number - minimal length of string representation of the object. If actual string representation of the object is shorter than length, it is padded with spaces to the given length. If positive, the parameter is right-aligned; if negative, it is left-aligned.
  • format: This is the most important and most tricky parameter. It defines how the value is formatted. If omitted, default formatting (depends on object type and value and control panel settings) is used. Actual valid value of format depends on type of object being passed to formatting. Basically there are two types of formatting - predefined (single letter) and custom. For complete guide see .NET formatting guide
  • For placemark and log formatting GPSTracka provides following values:
  • {0} Date & time UTC
  • {1} Longitude (positive for East, negative for West)
  • {2} Latitude (positive for North, negative for South)
  • {3} Altitude (if measured; 0 otherwise) in meters (see altitude notes above)
  • {4} Date & time local (according to time zone set in Control panel).
  • {5} Abbreviation of chosen altitude unit. Text only - do not apply any formatting after colon.



Win GPS

Provides settings related exlusively to Microsft Windows Intermediate GPS Driver.
  • Use sea level altitude: Use sea level (the normal one) altitude instead of ellipsoid one. GPS system normally provides altitudes measured to the WGS84 ellipsoid standard instead of actual sea level as used in maps. Windows driver may provide sea-level altitude as well. If you are receiving no altitude after checking this, uncheck it.

Diagnostic

  • NMEA log: Check to create extra file in Save folder containing RAW GPS NMEA data. May be used for diagnostics. Contains almost the same data as written in verbose mode to text box. (In case the GPS device provides data too quickly, the textbox skips some lines while the file always contains all of the data.) Note: The file may grow fast. NMEA files are always named using system local time, because GPS time may not be available when it's being created. The file is not logged when using Windows Intermediate GPS driver.
  • Beep every X s: Makes device beep every X seconds when GPS is running. 0 means do not beep. Device does not beep when suspended. In addition beep count is shown in status bar which increments even when device is suspended.


CSV

This page controls settings related to CSV file format.
  • Separator: Character used as seperator of CSV fields. Default is comma (,); semicolon(;) or pipe (|) are often used.
  • TAB: Sets field separator to TAB character.
  • Text qualifier: CSV text qualifier used to suround values. Double (") or single (') quotes are commonly used. From list chose when the qualifier should be used. Always, never or when needed. When needed means that qualifier is used only when value of the field contains character used as separator. In case that field contains character used as taxt qualifier and text qualifier is used, then is is escaped by writing it twice time. Examples (seperator ,, qualifier " used as needed):

** 142 becomes 142
** 14"2 becomes 14"2
** dc,x becomes "dc,x"
** d"c,x becomes "d""c,x"
  • New line: Character(s) used as line separators. You can chose from common Windows, Unix and Apple seperators.
  • Header: Text used as header of CSV files. Empty and no header is written. You are completelly responsible of corectness of header. It should reflect order of CSV fields and use the same rules for field separation and qualification as CSV data lines. The TAB button insets the tab character at cursor position.
  • Available fields: Shows available CSV fields that are in use. Use the >> button to add field among used ones.
  • Used fields: Shows fields used in CSV files generation. At least one field must be selected. Use the << buton to remove field. Use the ^ and v buttons to muve selected fiedl up (left) and down (right).
  • Date format: Format used for formating date into CSV file. Date/time format described in Formatting is used, but without braces {} and numbers - only the part after colon (:). Actual format can be tested using the ? button. Unlike naming formats, this is evaluated in invariant culture instead of current culture.
  • UTC time: Checked when CSV file contaisn times in UTC coordinates, unchecked to use time in local time zone. Note: You change the format so that it outputs the timezone.

Last edited Sep 6, 2009 at 8:20 AM by mendhak, version 3

Comments

No comments yet.