home *** CD-ROM | disk | FTP | other *** search
/ Hand Held Organizer Toolkit / walnutcreekcdrom-handheldorganizertoolkit-march1998.iso / PalmPilot / time_date / tidemac.sit / README.txt < prev    next >
Text File  |  1997-04-19  |  3KB  |  72 lines
  1. TIDE CONVERTER README
  2.  
  3.  
  4. TideMac and TideWin are simple console-based applications which will covert
  5. text-format tide tables into PalmPilot databases for the Tides application. 
  6. Install the Tides application and as many tide table databases as you want and
  7. you're ready to go.
  8.  
  9. Currently, TideMac and TideWin support two tide table formats, xtide and a simple
  10. table format.  Source code is included so if you find a format which isn't
  11. supported, you should be able to easily modify TideMac or TideWin.
  12.  
  13. I personally recommend the xtide format at the site mentioned below since you can
  14. download tables for the entire year (or more) and the tables account for daylight
  15. savings as well!
  16.  
  17. Take a deep breath now... since there's no place which provides Pilot-ready tide
  18. tables, you'll have to do a little work.  All you'll need is a connection to the
  19. World Wide Web and a text editor or word processor.  Read below about the format
  20. and then surf to one of the sites mentioned.
  21.  
  22. ----
  23.  
  24. Both xtide and the table format start with two tab-delineated lines:
  25. (Tab-delineated means you type a "tab" between each field.)
  26.  
  27. The first line contains three names: 
  28. 1. a name used for the destination filename
  29.    (what the file will be called on your drive)
  30. 2. a 31-character (or less) name for the Pilot PDB
  31.    (what it will be named on your Pilot)
  32. 3. a 63-character or less site name
  33.    (which will be displayed in the Tides application).
  34.  
  35. The second line contains the table format type, whether the values are in feet or
  36. meters and the maximum number of tides per 24 hour period (typically 4).
  37.  
  38. xtide format files are available at <http://tbone.biol.sc.edu/tide/sitesel.html>
  39. and look like:
  40.  
  41. Gloucest.PDB    Gloucester Harbor MA    Gloucester Harbor, Massachusetts
  42. xtide    feet    4
  43.   High Tide:  Tue 1997-04-01  4:51 AM EST  9.02
  44.    Low Tide:  Tue 1997-04-01 11:19 AM EST  0.11
  45.   High Tide:  Tue 1997-04-01  5:35 PM EST  8.20
  46.    Low Tide:  Tue 1997-04-01 11:40 PM EST  0.72
  47.   High Tide:  Wed 1997-04-02  5:54 AM EST  9.13
  48.    Low Tide:  Wed 1997-04-02 12:20 PM EST  -0.06
  49.  
  50. high/low format files are available at
  51. <http://northshore.shore.net/~mcmorran/tide/tideform.html> and look like:
  52.  
  53. Boston.PDB    Boston MA    Boston, Massachusetts
  54. high    feet    4
  55. 04/01/1997    05:52    9.99    12:22    0.28    18:36    9.06
  56. 04/02/1997            00:43    0.94    06:55    10.10    13:24    0.09    19:38    9.37
  57. 04/03/1997            01:46    0.60    07:59    10.36    14:24    -0.25    20:39    9.88
  58. 04/04/1997            02:48    0.06    09:01    10.73    15:22    -0.68    21:37    10.50
  59.  
  60. This is a simple table which alternates between high and low tides (or low and
  61. high if the table type is "low").
  62.  
  63. For either format file, you can copy and paste the table into your text editor or
  64. word processor, then add the two lines as described above to the top of the file.
  65. Save the document as a TEXT only document.  Then run TideMac or TideWin and it
  66. will convert the text file info Pilot format.  Use the Pilot Install App program
  67. to install them on your Pilot.
  68.  
  69. A text version of the tide table for Gloucester Massachusetts as well as a Pilot-
  70. format (PDB) version are included as a starting point.
  71.  
  72.