This utility takes in delimited ascii data file(s) which contain records (rows) of data which
contain latitude and longitude coordinates plus some data that you would like to have mapped
thematically.  Specifying a few arguments to customize the mapping options for your
application and a .kml file will be generated which can be viewed in applications such as
Google Earth or Nasa WorldWind.

For more information see this programs webpage: http://www.blakerobertson.com/AsciiToKML/


usage: tokml [OPTIONS] <INPUT>

<INPUT> = (INPUT_FILE | INPUT_DIR)
INPUT_FILE = the path to the ascii delimeted data file you want to load.  
             Enclose the path in quotes.
INPUT_DIR  = A directory containing a ascii delimited data files.  Enclose the path in quotes.  
             By default, the utility loads every file with a .txt extention.  
             If your data has a different extention, use the ext= option.


[OPTIONS]:
All options take the form of <optionName>=<optionValue> and are seperated by spaces.  
If an argument has spaces in it, be sure to enclose it in quotes. (Ex. docName="My Data")

--[ BASIC OPTIONS ]-------
   outputFile=<PATH>     : sets the directory to save the kml file to.  DEFAULT value is
                           the same directory as the input files
   input=<INPUT>         : sets the input data file or directory, if argument isn't specified
                           then the last argument is assumed to be the input.
   fileExt=.xxx          : when the output file is set to a directory this specifies the file ext.
                           for the files that should be checked.  DEFAULT=.txt
   delim=<DELIM>         : sets the delimiting character between the columns of data.  DEFAULT="\t"
   latCol=#              : sets the column in the ascii data where the latitude data is.  
                           Note: coordinate must be in Decimal-Decimal Format. (See NMEA0183)
   lonCol=#              : sets the column in the ascii data where the longitude data is. 
                           Note: coordinate must be in Decimal-Decimal Format. (See NMEA0183)
   dataCol=#             : sets the column of data to use for the thematic map.  DEFAULT=9
   docName=<string>      : sets the document name in the kml file: DEFAULT is NONAME
   minValidDataValue=#   : sets the lower bound for range1.  DEFAULT=5.0E-324
   range1=#              : each row where the minValidDataValue >= dataCol < range1 
                           will be assigned the range1 icon style
   range[2-4]=#          : For range2 -> each row where the range1 <= dataCol < range2
                           will be assigned the range2 style.  For range3 and range4 it's similiar.
   maxValidDataValue=#   : sets the upper bound for range5.  DEFAULT=1.7976931348623157E308
   filterRows=(true|false): enables/disables data row filtering based on a specific column value.
   filterColumnNumber=#  : sets the column to check each row of data to see if it matches                           filterMustMatchValue.
   filterMustMatchValue=<string>: If a value in the filterColumnNumber for a given row does
                                  not match the value specified by this argument.  It will
                                  not be included.
--[ ADVANCED OPTIONS ]-----
   verbose=(true|false)  : when set true, more debug statements will be printed. DEFAULT=false
   skipLines=#           : specifies the number of lines to skip at the top of each file.DEFAULT=1
   latMult=#        : sets the number to multiply the latitude by to convert to "Decimal-Decimal"
                      dd.dddd) format.  For example, if your datalogger recorded latitude in a
                      format that looked like -076935750.  Multiplying it by 0.000001 would make it
                      = -76.935750 (which is the Decimal-Decimal format used in KML).  DEFAULT=1
   lonMult=#             : sets the number to multiply the longitude by. (see latMult)
   range(1-5)Icon=(URL | FILE_PATH): specifies the image file to display for data points
                                     that fall into the respective ranges. SEE range(1-5) above.
   redundancyFilter=(true|false) : enables or disables a filter which removes datapoints that are 
                                   within redundancyDistance feet from another datapoint and 
                                   its dataCol value within redundancyDataDifference.DEFAULT=false
   redundancyDistance=#          : for two datapoints within redundancyDistance feet... 
                                   if the abs( dp1 - dp2 ) < redundancyDataDifference, then dp2
                                   will not be included in the KML file. DEFAULT=0.00
   redundancyDataDifference=#    : see explanation of redudancy distance, DEFAULT=0.00
   dataDigits=#          : sets the number of digits after the decimal point for data values

--[ SPECIAL GPS OPTIONS]-------
    These settings are for use when the input data is information logged from a GPS receiver 
    which outputs data in NMEA0183 format.
   NMEA0183=(true|false)        : set to true if data imported is in NMEA0183 format. DEFAULT=false
   dataIsSatInView=(true|false) : when set true the dataCol argument is ignored and the source 
                                  data which is mapped thematically is the number of SIV.

[LIMITATIONS]
1) The data in the column specified by the dataCol argument must be numeric.  
    This also applies to the range arguments.

[NOTES]
* By default data is expected to be in signed decimal decimal format.  
  NMEA0183 sentences which are read from.  GPS receivers are not signed.  
  Instead they have a seperate data column which specifies the hemisphere that the 
  the coordinate is in.  So, by setting NMEA0183=true it will look at the column 
  after latCol for the latHem and similarly it will look at the column immediately 
  after lonCol for the lonHem