!Off  (Note the !off to left matches a !on before a waypoint list at file end.)

File readme.txt  for 2M Navigation Assistant Version 1.1000
          05 August 2000 - Tim Holt Software

Modifications: 
15 Jul 2000 for release 1.1000
   1 - Removed south of Madiera Waypoint and added 5 degree DLO Great Circle request 
          for transatlantic run.  This brings the route close to Azores and Bermuda
   2 - Corrected AMVER and MOVREP leg labeling with global LATX request.
          Great Circle was placed on any leg not labeled Rumbline.
   3 - Unintialized value caused crash when no data.  No data case handled
          more logically.  

22 Dec 1999 for release 1.0001
   1 - Made decimal precision in GPS output 3 places.
   2 - An apparent compression induced error in floating point conversion when 
          using the Calc-geodetic length of lat and lon.
   3 - Position dialog (in mercator view) was not being initialzed at the right
          time and showed an erroneous prompt when first brought up.

    To install run the program setup.exe in the 2M_setup directory.
To Uninstall use Start\Settings\Control Panel\Add Remove Programs.
If you have created any data files in the 2M home directory (other than this
file and its output version readme.out) the 2M home directory will remain with
your data files untouched. 

System requirements:
    Windows 95/98
    16Mb RAM
    486 or better processor.
    16Mb disk space - 41Mb at start of install
        VGA screen (SVGA or better recommended)

    This readme file repeats information in 2m.hlp.   It also serves as
the default route source file and contains a route from Bar, Montenegro
to Houston, Texas which is described in the help Overview and is used 
to display some data source commands. 
    2M is a navigational program combining editor, sailplan generator
and mercator route plotter.  Given a waypoint list, 2M will produce a 
sailplan (waypoint sheet or route sheet) in ASCII text form suitable for
printing or editing.   In addition to a basic tabular listing, CSV (comma
separated format), USCG AMVER, and USN MOVEREP formats can be selected.
Of course, speeds, times of departure and arrival, great circle routings,
chart lists, zone descriptions, etc. can be added to enhance the output.  
    A route is often seen as a list of locations drawn from a big pool of
locations.  But to the navigator of a large vessel it is often a collection of
information which has a flow and a known value only once used as a unit.   The 
route legs are checked and plotted with great precision and tossing waypoints
once selected back in a pool is unthinkable.   Speeds are associated with legs
as are charts, weather and traffic conditions, zone descriptions, great circle
routings, intercepts used to plot the track, ports departed from and arrived
at and pilotage information for both.    Keeping it all together to produce a
sailplan makes it more than a list, and a lot like a batch file or a program.
Once the information is written, it should be easy to reproduce and alter the
route with all the data together.   The key thing is to make it easy to write
in way that can be edited to combine routes and splice in new destinations. 
    2M Navigation Assistant is for the professional navigator what the 
spreadsheet was to accountants.
    2M is a Microsoft Foundation Classes (MFC) Win-32 program, which is based
on the Multiple Document Interface (MDI) and the CEditView edit control class.
It is possible to be editing several routes, have several sailplans in more
windows, and have several mercator projection maps or routes (or any location)
in more windows.   The editor selects lines in error in the source document,
and allows for basic operations such as Undo, Find, Replace, Goto-Line and
Select-All.
    There are two aspects of 2M which make it different from most other waypoint
programs.  First, 2M takes an ASCII text (plain) file as input with description,
latitude, longitude on sequential lines.  All lines starting with an exclamation
mark are command lines.  This allows 2M to accept a great variety of formats and
makes cut and past editing straight forward. Output files have  ".OUT" file
extensions but are just ASCII text files like the data files.   Data files can
have any name without a ".OUT" extension.   Straight text (ASCII) can be edited
and printed on almost any device (a handy feature on poorly equipped vessels).
Second, 2M allows a rapid plot on a basic world mercator map at almost any scale
and with good speed.  This map can be printed but only on a graphics printer
with a Windows driver.
    It is possible to cut and paste two separate routes together, look at the
result on the globe, and print the waypoint sheet with ETA's, local
departure/arrival times, chart list, along with views of the route on a mercator
projection, send AMVER (and/or MOVEREP) text to disk for radio transmission, and
append pilotage notes in a few easy steps.

  The data file is a text file with a basic format:
  
   description
   latitude
   longitude

   description
   latitude
   longitude

   ...
   ...
   ...
  
     There is one item to a line and description is cut at 18 characters.
 2M is therefore free to accept a wide range of formats for lat and lon.
 2M can read/write AMVER , write MOVREP & CSV (comma delimited -for Excel).
   
    Single line commands:
   
    !Speed <knots>
    !gc                       (Start great circle routing)
    !rl                         (Start  rumbline routing).
    !Chart <number>            (Print chart # (5 digit only) with intercepts.
    !Lat <intercepted lat.>     (Calc. intercepted longititude)
    !Lon <intercepted lon.>.   (Calc. intercepted latitude)
    !Vessel <name>
    !Call <call sign>
    !Off                      (Stop scan of file - cut part of route)
//  !On                       ( Resume scan of file - don't remove the //)
    !Set,            (Maintain last leg speed in any arrival speed calc.)
    !Ave,!Unset      (Allow change of speed for arrival time.)
    !Stop <hours>  stop at waypoint for hours.
    !ZD <-12.0 to +12.0> zone description for following waypoints.
    !Arriving <port name>  (Arrival port name used in AMVER/MOVEREP reports)
    !Departing <port name>  (Departure port name used in AMVER/MOVEREP reports)

    //        (Comment line (ignored) started with: //)
   
    Blank lines are ignored.

    !LAT gives a latitude (usually a chart edge or parallel for which you
want a crossing point for the course line.   !LON asks for the same
thing of longitude.   This allows rapid replotting of accurate course
lines on the chart.   When storms force many deviations this saves
time.   GPS positions make errors in mechanical laying off and transferring
of courses glaringly apparent; precise course lines will match GPS
cross track error indications.  The chart list can be entered in the
file using !CHART statements, and if these are given just before an intercept,
the intercept will be printed with the associated chart.
    Using arrival time and departure time specifications,  2M  will try
to calculate the required speed.   Speeds entered in a file using:
!SPEED, will be retained, so remove them or comment // them out, if
you want an average for the entire trip.
    Whenever a position to a waypoint is entered (Calc To Waypoint), it will
be considered the new departure point.  You need to enter a time
of departure which corresponds to the position entered.
    2M  makes an attempt at a reasonable USN MOVEREP report, as well
as AMVER and normal formats.   All versions of output can be saved to
a disk file (defaulting to a .OUT extension).    These files can then be read
as text into programs like MS-WORD or EXCEL.   EXCEL can read text
delimited by comma's into spreadsheet columns.  A comma delimited
format is available.);
    !SET fixes the last leg speed until an !AVE or !UNSET statement.

    The mercator map view allows almost unlimited examination of each
waypoint at any scale.   Besides the route and grid lines 2M displays
charts intercepted, land (if the world map is installed, when also
rivers and boundaries are selectable), ports and sea features.   It is
possible to view any point on the earth from 85S to 85N (mercator plotting
requires some limit).   The map resolution is about 1/2 NM.

Some features of 2M:

 --> Edit multiple routes and output sailplans.
 --> Send text source and output to e-mail, telex, packet radio, basic printers, and any editor.
 --> Turn off and on sections of route waypoints as needed 
 --> Obtain intercepts for any intersecting longitude or latitude (all intercepts are found).  
 --> Find time intervals by entering date and time.
 --> Find DR positions with an entered time.   
 --> Go to a waypoint from an entered position as the new start of route.
 --> Generate (U.S. Coast Guard) AMVER departure and deviation reports.
 --> Generate (U.S. Navy) MOVEREP reports.
 --> Adjust leg speeds to make a time of arrival while reserving some leg speeds as fixed.
 --> Add stops in hours to waypoints.
 --> Generate great circle LatX points (and composite points).
 --> Request LatX points for any leg at almost any dlo (1-50 degrees).
 --> View a mercator map of the route or any location at almost any magnification.
 --> Set what items are displayed on the map and in what colors.
       (grid, land, ports, sea features, chart outlines, rivers, user locations, boundaries)
 --> Append crosshair locations from the map to the source or edit and paste them in.
 --> Show a file of user locations on the map.
 --> Print maps as well as sailplans with user modifiable headers.
 --> Print preview source, output sailplans, and mercator maps.
 --> Change printer and screen type fonts for both output and map views.
 --> Set the start number for the route.
 --> Set ETA minute rounding values.
 --> Print local times in the headers with source zone description lines.
 --> List user charts for route along with intercepts needed to plot the track on each chart.
 --> List program selected charts (and intercepts if desired).
 --> Append pilotage notes below the sailplan section.
 --> Track positions and log GPS NMEA-0183 input.  (Positions date/time stamped).
 --> Goto any waypoint from GPS position to get BRG, DIST, XTE, VTWP, TTG, ETA. 
 --> See rumbline and great circle data simultaneously in the GPS data window.
 --> Take GPS log positions and paste into a route source document.
 --> Switch between GPS unit supplied SMG/CMG to sampled values.
 --> 2M is year 2000 ready and is aware of leap years (and of the one in 2000).
 --> Obtain context sensitive help anywhere in the program.

  Warnings:

    Always go to a chart to chose adequate bottom clearances, distances
off etc..   GC routes are best plotted on a gnomonic chart.  But here
the save waypoints as data file allows you to save generated great
circle (or composite) waypoints in a text file to paste in as needed.
If your GPS has rumblines double check leg CN's and distances.
When using intercepted latitudes or longitudes recheck the result CN.
    Tim Holt Software does not accept any liability for navigational 
accidents involving the use of 2M.  2M is intended to provide a rapid 
check on intended route, and is NOT intended for direct navigation.
    The prudent navigator never relies on one set of calculations or on
one set of plots.  Checking of routes on small to large scale charts,
matching sailplans to navigation device sailplans, getting input 
from fellow navigators are all recommended.
    The C-engine of 2M has been used for a number of years, but there 
must exist some problems to be reported.  I would appreciate any 
suggestions or bug reports.
    You may e-mail Tim Holt Software at timholt@worldnet.att.net 
or call 831-464-2056 with any questions.  OEM opportunities are being
sought.
     NOTE: the source data (compressed from a CIA database by Brian Reid)
does not show every rock or island (for example: Navassa I. off Haiti 
does not show up.  Ille Europa in the Madagascar straits is not there).    
Some islands, rocks and reefs have been added in the sea features data 
which are not shown in the land data.  These were added in order to give 
quick feedback about deep ocean routes, but plotting on actual small scale
charts after looking at 2M output is absolutely essential. 
    Therefore use this to get a feel for your data, to make a quick check
that all is as you expected and to print a basic map of the intended route.  
It can be quite embarrassing to make a minor change to a number here and there,
calculate ETA's thinking all is well only to find the calculations were based
on data sending you over the land.   Plotting charts directly from the data
used for a waypoint sheets and steaming time, and comparing courses plotted
to those calculated as each line is drawn, is the safest way to do your chart work.   

                            Tim Holt Software - 5 Aug 2000
                            timholt@worldnet.att.net
                            831-464-2056

!on // starts scan of following route after !off at file top.

// File BarHoust  Tim Holt Software 2000
// Winter route 
!DEPARTING BAR
!ARRIVING HOUSTON
!vessel FAIRWIND
!call WXXX
!remark Hospital but no doctor on board.

!NOTE Houston:
!NOTE Houston Pilots 14,16 VHF (work 73,13) VTS 11,12  Dist S/B to Jacinto Port 41NM 
!NOTE Min. Controlling Depth to Jacinto Port 39ft, Airdraft 175 FT (Fairwind < 134 ft)
!NOTE Bar:
!NOTE No Air Draft Limits
!NOTE Harbor 14M (45.9ft) , Alongside 10-14 M (32.8-45.9ft) Depths  
!NOTE Tides 0.6M (2ft)

!speed 16

!zd -1

!chart 683
!zd 0

Pilot Station Bar
42-06.25N
019-03.25E

!chart 54240
!chart 54260
!chart 54060

Capo d'Otranto 1
40-06.5N
018-41.5E

Cap.S.Maria Leuca
39-44.0N
018-28.0E

!chart 54040
!chart 53200
!chart 53220

Capo Passero
36-32.0N
015-10.0E

!chart 52180

Isola Pantelleria
37-00.0N
012-00.0E

Cap Bon TSS 
37-12.0N
011-13.0E

Cani Rks TSS Entr.
37-34.0N
010-15.0E

Cani Rks TSS Exit
37-34.0N
010-00.0E

!chart 52200

Galitions/Serrat
37-20.0N
008-53.0E


Cap Bengut
37-05.5N
003-52.0E

!chart 52220
!chart 52240
!chart 52060
!chart 52040

Europa Pt. TSS
36-01.5N
005-20.0W

!chart 52039
!chart 51013


Tarifa
35-57.5N
005-35.7W

!chart 51160

Gibralter
35-57.5N
006-12.0W

!GC 5  // Great circle points a 5 degree DLO interval

!chart 51017

//South of Madeira - winter Rumbline route
//30N
//20W

!chart 925  //plotting sheets
!chart 924



!chart 11013
!chart 26300

!zd +5
Hole In The Wall
25-46N
77-11W

!RL  // Back to rumbline

!chart 26320
!LAT 24-58N     // longitude intercept will be printed in output
!LON 77-10W     // latitude intercept will be printed in output
 
NW Prov. Ch.
26-13N
79-00W

Great Isaac Lt.
26-13.0N
79-10.0W

!chart 11450

//Pacific Reef
//25-22.1N
//80-02.3W

French Reef
25N
80-12W

Tennessee Reef
24-36.7N
80-47W

!chart 11434

South Sand Key
24-17N
81-53W

Dry Tortugas
24-20N
82-50W

!chart 11006
!chart 11340



!zd +6
Fairway Entrance
27-51.3N
92-34.2W

!chart 11330


Fairway Junction
28-12.5N
92-52.3W

Fairway Precaution
29-08.4N
94-21.4W

TSS Inbound Exit
29-17.4N
94-35.5W

!chart 11323
!chart 11324

Bouy "GB"
29-18.4N
94-37.5W

!chart 11327
!chart 11328
!chart 11329


// End of file readme.txt - end of route Bar to Galveston
