probably includes your waypoints and routes.
From my experience, these are not always what they seem.
I have developed a script Housekeeper
that examines your waypoints and routes and reports on what it finds.
Further, it offers to fix any issues it finds.
If you run a very clean and tight ship, it may find nothing - as was the case when Mike (Rasbats) tested an early version for me.
In my case it found 173 issues. Clearly my use is messier than Mike's
In what follows I use the term waypoint
(WP) to refer to a free-standing waypoint which is included in the Waypoints tab of the Route
& mark manager.
A waypoint may be used in any number of routes or none at all.
I use the term routepoint
(RP) to refer to a point in a route
which is not a waypoint.
Routepoints exist only in routes and when a route is deleted, its routepoints are also deleted unless the are in use by another route. Routepoints are not listed in the Route & mark manager. By default, routepoints are given mark names 001, 002, 003 etc. although you can rename them to anything you wish.
I will use the term point
when this may be a waypoint or routepoint.
When Housekeeper is run, it first looks for and details:
(1) Waypoints and routes with no name
It offers to give them default names so you can distinguish between them.
(2) Waypoints and routes with duplicate names
It offers to make them unique by appending suffixes.
(3) Waypoints not used in any route and with a mark name like 001, 002.
These are likely routepoints that have been removed from a route. OpenCPN
converts these into waypoints. Housekeeper offers to delete them.
(4) One-legged routes with names starting with Goto...
These are left over from when you activated a Goto which was not a route.
Housekeeper can delete these.
(5) Routes with repeated legs, such as Mark A; Mark B; Mark B; Mark C
Yes this can happen - it found one in my routes. Housekeeper can remove senseless legs.
Housekeeper then looks for multiple points at the same location. You may find, like me, you have more of these than you realise.
When I started to use OpenCPN, I transferred my extensive library of waypoints and routes from my previous application MacENC.
I exported my waypoints into GPX files and imported some of them into OpenCPN.
I then exported my routes and loaded some of these too.
I expected OpenCPN to create the routes by linking up my waypoints.
OpenCPN does not work
like that. For each route imported, it creates routepoints for each leg.
This was not apparent at first because the waypoint and routepoints exactly overlay each other. But when I move one of these points it may reveal the other co-located points left behind.
I will illustrate this with what Housekeeper displayed for my point UK-S:P-ENT marking the entrance to my home port Poole Harbour.
At 50° 40.860'N 001° 56.840'W
1 WP UK-S:P-ENT 432f3..acb36 leg 8 in Warbarrow Trout to Poole
2 RP UK-S:P-ENT 4759a..9f80c leg 8 in UK-S:Salcome-PooleO
3 RP UK-S:P-ENT 1de5e..b3ff5 leg 9 in UK-S:Lyme Regis-Poole (O)
4 RP UK-S:P-ENT 72f3f..06530 leg 9 in UK-S:West Bay - Poole (O)
5 RP UK-S:P-ENT 18864..c1048 leg 18 in Christchurch S C to Frome mooring
shared with leg 0 in UK-S:Brownsea to Frome mooring
6 RP UK-S:P-ENT 37f87..d122c leg 0 in UK-S:Poole-Yealm
7 RP UK-S:P-ENT 210f0..4f769 leg 7 in UK-S:Weymouth - Poole I
8 RP UK-S:P-ENT 085c2..10576 leg 0 in UK-S:Poole-Weymouth O
9 RP UK-S:P-ENT 63c04..103b3 leg 0 in Poole-Lulworth (I)
10 RP UK-S:P-ENT 5a9f6..d5414 leg 8 in UK-S:Dart-PooleO
11 RP UK-S:P-ENT 7bc24..2a635 leg 0 in UK-S:Poole-Lulworth O
The first point is the original waypoint I imported.
2-11 are extra routepoints created by OpenCPN when I imported my routes, as evidenced by the different (abbreviated) GUIDs.
This season I created two new routes.
For the route Warbarrow Trout to Poole
, I chose to use the nearby waypoint for the entrance to the harbour.
For Christchurch SC to Frome mooring
I also chose to use the nearby mark offered - but I now see that was not the waypoint but the routepoint of the same name in the route UK-S:Brownsea to Frome mooring
In my opinion, having multiple marks overlaying each other is bad practice and even dangerous. Suppose the entrance moves or an obstruction is discovered and a mark has to be repositioned. In the above case, I would have to move all 11 marks. Routes hidden at the time would likely be missed and I might end up sailing them later believing the mark had been moved when it had not been.
For the example above, Housekeeper determines that the first mark is the true waypoint and offers to use it to replace the routemarks in the 11 routes not using it. I now have a single
waypoint shared by the 12 routes.
Fuller details of what Housekeeper does are available in its description here
I will be interested to learn if others discover things about their waypoints and routes they were unaware of.