Table Of Contents
Chart Conversion Manual
Table Of Contents
imgkap and the kap file
To convert a chart picture to a BSB chart, libbsb was for a long time the only choice.
With the arrival of "imgkap", there is an alternative with updated features.
Read more about imgkap here: www.dacust.com/inlandwaters/imgkap/
Picture to Chart, some details
For both tiff2bsb(libbsb) and imgkap there must be a user supplied "header" file containing information and Geo-referencing of the chart picture. This file can be produced in different ways. From simple handcrafting, to a method described on the page "Conversion Using Linux", which actually applies to windows as well in many parts.
To see a real header, just open a chart file (whatever.kap) in a text-editor.
The first part of the text in the beginning us user supplied, then comes a text part created by libbsb or imgkap an then the binary part.
Whatever method is used for conversion it is important to understand the header.
Here is a commented header file originating from the NGA project, that describes the essential items in a basic version.
0. The BSB version used
1. *Name of chart from the chart. Warning do not use commas ",".
2. *Chart number. Plan A on 23456 should be named 23456_A
3. Size of picture Pixel x coordinate
4. Size of picture Pixel y coordinate
5. *Scale of the chart from the chart.
6. *Geodetic datum, for example WGS84, from the chart. If the geodetic datum cannot be determined, don't convert the chart. OpenCPN V4.0 will treat it as WGS84, but this requires a carefull check of the final chart.. For a list of approved Datums see the file georef.cpp in the source code. Charts released earlier than 1990 (?) and conforming to World Geodetic System should be WGS72, unless stated otherwise. The difference between WGS 84 and WGS 72 is minor.
7. *Projection, almost always MERCATOR, a few charts are TRANSVERSE MERCATOR. We should not bother with other projections, GNOMONIC small scale great circle charts etc. High latitude "Lambert Conformal Conic Projection" should be skipped, for now. OpenCPN only handles Mercator, Transverse Mercator and Polyconic Charts. Do not leave this value blank and don't use "UNKNOWN".
8. *For Mercator charts this is the latitude where the scale is valid. If available on the chart, use that value.
If it is not available on the chart use the average value of the latitude of the upper and lower edge, to the nearest 1/10 of a degree.
For Transverse Mercator charts use the average _longitude_ of the eastern and western edge.
8a. SK is the skew angle of charts that are not "North Up". For North Up the value is 0.0
From OpenCPN 3.3.1117 skewed charts without this parameter set, are handled internally, and showed correctly. This is only to handled commercially issued charts that are not correctly coded.
8b.TA is he text angle, more or less always 90.0
9. Unit for soundings from the chart, mostly METERS
10. Datum for soundings from the chart, for ex MLWS, LAT
11. x and y resolution, meters per pixel. Not necessary for us to compute. OpenCPN handles this.
12. Chart edition date copied from the chart,inf in SW corner, except, there must be _no_ commas.
13. Our release edition.
14. Our release date.
16. Geo-referencing, standard case - simple 4 corner chart, use the 4 corners, starting in the SW corner proceeding clockwise.
Format: x pix,y pix, lat, long. Lat & long i decimal degrees, to 8 decimals, where N lat and E long are positive.
One reason to use all 4 corners is to catch skewed and warped charts, and calculate SK (8a), also to calculate a rotating angle for charts that are not properly aligned.
17. Standard case, just copy the lat & long from the REFs.
18. Corrections in seconds of arc to bring the chart to WGS84. This is generally stated on the chart (if they exist), in a format where the corrections are in minutes of arc for plotting a WGS84 position on the chart. This correction must be transformed to seconds of arc and the signs reversed.(we are doing the reverse to the case stated on the charts). These values are sometimes difficult to find on the chart. Think of OpenCPNs grid as a fixed WGS84 grid. A WGS 84 charts printed grid should agree with OpenCPN', grid. If not, the Chart needs to be moved. Use + for N and E. Use O's measure tool to measure the offset in meters.1 sec of arc latitude is 31 m. The longitude varies with the latitude and 1 sec is about 15 m in lat 60.
19. If a chart spans the 180th meridian = > CPH/180.0, else => CPH/0.0. So CPH/ is 0.0 for most charts. Note that OpenCPN handles transiting the 180:th meridian while a few other plotters don't.
**IFM** is not used as tif2bsb and imgkap calculates this value and ads it to the header on the final kap, together with other values such as RGB. Any manually entered values will be overwritten.
One great advantage with imgkap, compared to libbsb, is that generally the original format for the chart picture can be used directly.
To calibrate a chart can be as simple as composing the headerfile , a text file with the extension ".txt". Often the Lat&Long of the SW and NE corners are printed on the charts.
Use, for example GIMP, to find the pixel coordinates for each corner.
For example, to the chart picture BA1121.jpg we write the header file BA1121.txt.
To create the chart file with the extension ".kap", issue the command:
imgkap BA1121.jpg BA1121.txt BA1121.kap
The BSB/KAP file format.
Tim Thornton from the TeamSurv
project has contributed an extended documentation of the bsb/kap file format headers.
There is a .BSB file for the chart (not required by OpenCPN and many others), and a .KAP file for each panel within the chart (and an additional optional file for updates to charts, which we won’t use). A header file is required. Create this in the tile folder with file name chartname
.bsb.txt and chartname
.kap.txt. This has the following formats. In all cases, date is in the format mm/dd/yyyy. Data fields must not have commas in them where there are sub fields, and probably not /. In the NA fields (and possibly others) /A indicates a new line. Subfields can be separated with a “,” or a new line.
Note that the origin for pixels is the top left (NW) corner of the chart, whereas for positions it is the usual SW corner.
Tests in OpenCPN have produced a minimum data set requirement for the KAP files. Fields that are required for chart display or for operational reasons have been highlighted in italics
in the description. In addition, Raytech requires the BSB
file to be present.
! An example BSB text header
CRR/2013, TeamSurv. All rights reserved.
CHT/NA=Australia 3000000, NU=123
NTM/NE=70.00,ND=07/25/2012, BF = on, BD=07/25/2012
K01/NA= Australia 3000000
The text header is terminated with a <Control-Z><NUL> sequence (ASCII characters 26 and 0).
! An example KAP text header
CRR/2013, TeamSurv. All rights reserved.
KNP/SC=3000000,GD=,PR=LAMBERT CONFORMAL CONIC,PP=145.0
NTM/NE=70.00,ND=07/25/2012, BF = on, BD=07/25/2012
The text header is terminated with a <Control-Z><NUL> sequence (ASCII characters 26 and 0).
Note that where the meaning of a field is the same as in the .BSB file above, it is not repeated here.
- ! - Comment line
- VER - Version number of BSB format – we will use 3.0
- CRR – Copyright message. Free text
- CHT – General parameters
- NA - Chart name given to the BSB chart (can represent more than one .KAP)
- NU - Chart number.
- CHF Chart format (e.g. Overview, General, Coastal, Approach, River, Harbour or Berthing)
- CED – Chart edition parameters - optional
- SE - Source edition / number of paper chart
- RE - Raster edition / number
- ED - Chart edition date/number
- NTM – Notices to mariners - optional
- NE - NTM edition number
- ND - NTM date
- BF - Base flag on or off (I guess this allows a base edition of the chart to be specified?)
- BD - Base date
- CHK – number of KAPs; KAP number(s). Note sure of format for > 1 KAP. Not sure if the separator should be , or ;
- CGD - ? coast guard district – optional or can be unknown
- RGN - ? - optional
- ORG – Producing agency identifier – TeamSurv for us
- MFR – Manufacturer of the RNC chart – TeamSurv for us
- Knn – Records 1 – n for each KAP file
- NA - Chart name given to the pane
- NU - Pane number e.g. 123_A
- TY - Type. Base for the base chart, Inset for a plan contained within the base chart, or extension for a plan outside of the base area
- FN – KAP file name e.g. 123_1.kap
- Naa – List of text boxes and hot spot links on the chart
- RT – N for text box, L for hot spot link
- KN - ?
- CA – Category e.g. Chart, Caution, General etc
- DE – Type e.g. Tide box, note etc
- LK – Links this hot spot to the specified text box
- P1, P2, P3, P4 – Hot spot location (just P1) or text box boundaries as 4 point polygon in x, y pixels
- VER - Version number of BSB format – we will use 3.0
- BSB (or NOS for older GEO/NOS or GEO/NO1 files) – General parameters
- NA - Pane name
- NU - Pane number. If chart is 123 and contains a plan A, the plan should be numbered 123_A
- RA - width, height - width and height of raster image data in pixels
- DU - Drawing Units in pixels/inch (same as DPI resolution) e.g. 50, 150, 175, 254, 300
- KNP – Detailed chart parameters
- SC - Scale e.g. 25000 means 1:25000
- GD - Geodetic Datum e.g. WGS84 for us
- PR - Projection e.g. MERCATOR for us. Other known values are TRANSVERSE MERCATOR or LAMBERT CONFORMAL CONIC or POLYCONIC. This must be one of those listed, as the value determines how PP etc. are interpreted. Only MERCATOR and TRANSVERSE MERCATOR are supported by OpenCPN.
- PP – Projection parameter. For Mercator charts this is where the scale is valid, i.e. +lat_ts – use average latitude of the chart. For transverse Mercator it is the +lon_0 value.
- PI – Projection interval ? e.g. 0.0, 0.033333, 0.083333, 2.0
- SP -? – Unknown is valid
- SK - Skew angle e.g. 0.0 for us. Angle of rotation of the chart
- TA - text angle e.g. 90 for us
- UN – Depth units (for depths and heights) e.g. METRES, FATHOMS, FEET
- SD - Sounding Datum e.g. MEAN LOWER LOW WATER, HHWLT or normally LAT
- DX – X resolution, distance (meters) covered by one pixel in X direction. OpenCPN ignores this and DY
- DY – Y resolution, distance covered by one pixel in Y direction
- CED – Chart edition parameters (see BSB section)
- NTM – Chart edition parameters (see BSB section)
- OST - Offset STrip image lines (number of image rows per entry in the index table) e.g. 1. Generated by imgkap.
- IFM - Depth of the colormap (bits per pixel). BSB supports 1 through 7 (2 through 127 max colors). Or compression type? Generated by imgkap.
- RGB – Default colour palette - entries in the raster colormap of the form index,red,green,blue (index 0 is not used in BSB). Generated by imgkap.
- DAY – Optional day colour palette
- DSK – Optional dusk colour palette
- NGT – Optional night colour palette
- NGR – Optional night red colour palette
- GRY – Optional grey scale palette
- PRC – Optional palette
- PRG – Optional grey palette
- REF – Reference point record, gives point n, then position x, y in pixels, then in longitude, latitude - optional
- CPH – Phase shift value - optional
- WPX – Polynomial longitude to x - optional. The Polynomials is an alternative to REF points for georeferencing. OpenCPN uses these polynomials if they are available. The existence of polynomials is a condition for using noaa:s chart reprojection tool.
- PWX – Polynomial x to longitude - optional
- WPY – Polynomial latitude to y - optional
- PWY – Polynomial y to latitude - optional
- ERR – Error record –These should be present if polynomials are used. These ERR rows report the error at the REF points due to the usage of polynomials.
- PLY - Border polygon record – coordinates of the panel within the raster image, given in chart datum lat/long. Any shape polygon
- DTM – Datum shift parameters - Datum's northing and easting in floating point seconds to go between chart datum and WGS84 (omitted or 0,0 for WGS84 charts)
- KNQ – Additional parameters - Optional
- P2 - the same as KNP PP for Mercator and Transverse Mercator projection.
- P3= scale factor for Transverse Mercator; 1st standard parallel for lambert conic
- P4= 0 for Transverse Mercator; 2nd standard parallel for lambert conic
- P5= Central meridian for Transverse Mercator and lambert conic
- P6= origin of latitude for Transverse Mercator and lambert conic
- P7 = +x_0 for Transverse Mercator and lambert conic
- P8 = +y_0 for Transverse Mercator and lambert conic
- VC= ?
- PC=?. Set to TC for Transverse Mercator.
Conversion Using Linux
How to convert your chart images to a format that OpenCPN will read using Linux
Do you have a bunch of scanned charts of your area, in graphical format (jpg, tiff, etc.) and OpenCPN won't read them?
Here's how you can – with a bit of work, sure, but worth the effort – convert them into usable electronic charts.
- ImageMagick: http://www.imagemagick.org/ (Binary releases are available for a few distributions, for Ubuntu just get it with the package manager, it's in the repositories.)
- Libbsb: http://libbsb.sourceforge.net (You will need some version of libtiff-dev and libpng-dev installed to build it. A .deb package that worked fine for me can be found here.
- mc2bsbh: you can get it here.
- Get the c++ source file, and from its directory, type:
- g++ -Wall -s -O2 mc2bsbh.cpp -o mc2bsbh
- It compiled without any problem on my (very standard) Karmic. I personally put it in /usr/local/bin, which I own as user, so it's in the PATH and can be called from anywhere, if you leave it in the working directory, use ./mc2bsbh
- MapCal: part of the free navigation package SeaClear .
- Note: I had some problems running it with Wine (saving the calibration) but I can't reproduce the error and now it works fine. One suggestion is, make the directory you're going to write the calibration in world-writable before running MapCal.
- The pcx2tif script (optional) , found here. This is a great little shell script by "taifun" used to convert old Maptech-style formats of tiled charts. If you find your chart is made of little bits instead of a whole file, this will stitch them all together in TIFF format.
- Instructions for use are in the tarball.
Once we have the tools all set up, we can get to work. The process in in five steps:
- Convert a chart image to tiff with imagemagick.
- Convert it again to png with the same (you'll need both files).
- Load the png version of the chart in Mapcal and calibrate it.
- Generate the chart header with mc2bsbh, and make the .kap version of the chart, with libbsb.
- Copy the resulting .kap into opencpn's chart dir, and reload the chart database.
Let's see them in detail:
Steps 1 and 2:
Say you have a chart in jpeg format called chart.jpg.
From the command line, use:
convert chart.jpg -colors 127 chart.gif
and then again,
convert chart.gif -colors 127 chart.tif
and then again,
convert chart.jpg -colors 127 chart.png
(there is a script that does this for multiple files, get it here , just remove the .doc extension, this is the example)
Throw away the .gif file. Don't ask me why you need to generate it in the first place, but apparently you do, it's an imagemagick thing. Keep the .tif and the .png ones a while longer, though. You'll be even happier to get rid of them when you've finished.
- Open MapCal.
- File, Open Image. Open the .png version of your chart. Ignore the data window for the moment, you'll do that later, click OK. You should see your chart.
- To calibrate it, choose a point near a corner for which it is easy to know lat/lon. Right-click on it, and choose Add New Cal. Point. To zoom in and out use the little + and – buttons at the bottom.
- Ignore the fact that Latitude has three integer figures, we're still talking about the Earth. Enter the coordinates and proceed for at least three more points, near the corners.
- Click Activate Changes. Check that the grid makes sense. Click Border, draw a border around the chart (that part is easy).
- You should also enter some data for the chart: Edit, Chart Information.
- The Chart Name will show up in OpenCPN to remind you of all your hard work, choose it well.
- For this example we'll just use “chart”.
- You should also enter at least Scale (found on the chart) Depth Units, Projection (Mercator most likely) and Datum (WGS84 most likely, but be careful with older charts). All of this information should be found on the chart itself.
- For more details, you have the SeaClear Manual.
- File, Save Calibration. Repeat ad-lib for any other charts and exit. If everything went well, you'll find a file called CHARTCAL.DIR in the same directory as you loaded your png chart from. This is used to (finally) make your calibrated chart that OpenCPN will use, as detailed in
- Generate the chart header from the command line:
- You should see:
- Create CHART.hdr
(the .hdr file must have DOS newlines)
- So type:
- tif2bsb -c 127 CHART.hdr chart.tif chart.kap
- At which point you should have a chart.kap file that OpenCPN will happily use.
This can be done for many charts at a time by using the tif2bsb batch script from the mc2bsbh page. If it gives you any problem with lowercase-uppercase names, try:
for i in `find * -depth`; do (mv $i `echo $i|tr [:upper:] [:lower:]`); done
which will convert all files in the current directory to lowercase (works great for me).
If you get an error like /bin/bash^M, no such shell (I did), it's a cr/lf thing, just edit it, type [enter] at the end of each line (there's only 7) and get rid of the blank ones.
Note 1: you can also make the .hdr file “manually”, using a template and entering the calibration data with a text editor, but I won't go into that for the moment.
Note 2 (about the commands, so if there's any problem you know what to look for) :
convert is a command from imagemagick.
tif2bsb is a command from libbsb.
mc2bsbh is a standalone thing.
Note 3: (by Jonasberg, on the colors in the conversions) :
The "127" is the number of individual colors used. Sometimes it pays of to reduce this number to get a smaller file size, say, if you start with a bitmapped format like png that contains fewer colors.
Note 4: On the joinpcx script:
If you use it "standalone" and not as part of the "charts" script, change the lines,
convert new1.gif - colors 127 $1.tif
(and .png) to
convert new1.gif -colors 127 `basename $PWD`.tif
because the "$1" will not create files with [directory_name].tif and .png, it won't create any files at all.
Using `basename $PWD`will make files called [current directory name].tif (and .png).
So just edit the script to whatever suits you best.
libbsb is a portable C library for reading and writing BSB format image files, typically used for nautical charts.
A number of utilities to convert and work with BSB charts are included in the libbsb package. Sample files and instructions on using these tools are available on the Examples page.
- bsb2tif - convert BSB image to TIFF format
- bsb2ppm - convert BSB image to PPM format
- bsb2png - convert BSB image to PNG format
- tif2bsb - convert TIFF image to BSB image
- ppm2bsb - convert PPM image to BSB image
- bsbfix - fix the index table in a BSB file
The mc2bsbh Utility
This is a utility to take an image of a chart that has been calibrated with MapCal, and convert it into a BSB chart that can be displayed in many marine navigation programs.
GUI for the several command line tools such as mc2bsbh and the libbsb tools, (for Windows, sorry Linux and Mac guys).
Powerfull utility conversion chart to and from a large variety of formats
For Google Earth
http://www.gdayii.ca/Downloads/ (password to decompress the archives: phiggins)
GE2KAP - Creates .KAP charts from Google Earth
GERoute - Follows a route to load the Google Earth cache.
C2GPXKML - Converts navigation routes and tracks to different formats.
Port detail generated by GE2KAP
Many people have found Google Earth and Google Maps printable images helpful in supplementing their knowledge of a particular area or specific location. The ChartAid program offers you the ability to save Google Maps printable images as Raster Charts or Photo Charts, in BSB/KAP file format.
Overlay NOAA raster charts in Google Earth
Script to Convert MaxSea Routes to GPX
VentureFarther is a FREE cruiser built website that allows you to create BSB/KAP format charts online from either Google Maps or Microsofts Virtual Earth. Just create a login, go to the "Advanced Tools For Cruisers/Satellite images BSB/KAP Charts" menu option and start downloading. No software to download and install.
Raster charts classification
RASTOW - RASTER CHARTS ORGANIZER
*** RASTOW *** (raster-stow contraction) classify your raster charts collection (*.kap files) creating 96 subdirectories divided by timezone (15° steps, without any country exception), north and south, above and below 45° of latitude.
Two modes of creation are available: -copy- or symbolic -link-. At the end of operation, a chartlist.txt containing a catalog of your charts is automatically created. Using -chartlist- command, you can create only a chartlist from your database. In copy mode, the created database may be bigger than the original base because a map can have a part in more than one timezone or <45° to >45° in latitude, and it resides in all the timezone subs covered. So, use symlinks if your space storage is critical.
Two others commands are useful to organize your collection with datas founded in the file header:
-update- change the file date to the last update edition.
-rename- change the filename by the chart title.
It's a good practice to make an update before a copy or rename command: if two files are equals, only the most recent will be handle.
About raster charts: theses charts are not so powerfull and practical than vector charts (no more details zooming, more bigger size), but generally come from original charts edited by officials hydrographics services, the source of vectors charts, so, sometime they may have more details than commercial vector charts (see example in marinux website ) or it is usefull to consult its in case of doubt. Some others people have the homesickness of paper chart look and feel, and theses charts keep the same aspect.
INFOS & DOWNLOAD
Android GPS Apps
There are many needs for GPS and methods for transmitting GPS position information.
1. Laptop GPS (mouse type or other type) ---> Tablet or Phone to run Marine Chart Apps (MxMariner)
2. Tablet or Phone GPS ----> Laptop Opencpn
GPS Availablity Apps:
1. Send Android GPS data from phone to some other device. (also Nmea)
2. Recieve GPS data from Laptop or other GPS device. (also Nmea)
and maybe some others.
This category of Supplimental Software may be essential to operation of Opencpn because it can provide position information, however keep in mind that phones can become discharged fast and you may want a better long term source for position information.
I suggest that you read this page web page about Android GPS Apps
"Using Bluetooth GPS with Android" on L-36 website
Updated July 13, 2013
1. Good overview.
2. Suggestion to use External dedicated Bluetooth GPS due to battery life and reliability.
3. Bluetooth GPS "pretty good app" and Bluetooth GPS Provider "excellent job of locking"
4. Detailed instructions for Bluetooth GPS Provider.
Android GPS via BT to Opencpn
I did have some luck and help from Bluetooth GPS folks and got Opencpn working with GPS from my Samsung S4 phone via bluetooth, using BT Serial Com port. It works well.
Bluetooth GPS Output (BTGPS) with Samsung S4 & OpenCPN on Windows
Bluetooth GPS Output by Meowsbox
Works over Wifi, USB or Bluetooth
Installation Instructions from Meowsbox
Here are a few things to check:
Also see Forum Post for similar Step by Step Description:
This post has other information about protocols and testing of other Apps.
1. For a Windows Computer make sure 'Bluetooth Support Service' is running and set to 'Automatic' by going to ->Control Panel -> Administrative Tools -> Services (select it from the list)" If it is disabled enable it.
2. Did you create the Bluetooth pair from inside BTGPS app? If not, delete the pairing and start over. Pairing from within our app is different than the regular Android way. To delete the pairing, go to Devices and Printers, right click on the Samsung S4 and select Remove. If you don't want to delete your existing pairing, then you'll need to create the outgoing virtual COM port manually.
3. Create a new pairing while Bluetooth GPS Output is running. One of the advantages to doing this is that your computer will automatically find and create the virtual COM ports as part of the pairing process. On the phone in the BTGPS app touch MENU, ADVANCED SETTINGS, then select EMULATED ONLY. (Usually required for Samsung S3 or S4) which launches Bluetooth GPS Output from your phone.
4. Make your phone discoverable via the BTGPS application menu. This is a convenient shortcut.
5. On your computer, search for Bluetooth devices and locate your phone in the list of available devices and initiate the pairing.
6. Pair the Samsung S4 Phone and your Laptop Bluetooth by confirming a number on each device. Check to see that the pairing worked under Devices and Printers.
7. Determine the correct Com Port for Opencpn. Under Windows 7: Control Panel > In search type Bluetooth > Pick Change Bluetooth Settings. Here you should see which Com Port is the "SPP Slave" use that Serial Com Port Number for the Opencpn Connection.
8. In OpenCPN under Settings > Connections > Add New > Connection Type= SERIAL (not a network), DataPort= the COM port of your phone listed as "SPP SLAVE" (See the guide below for pictures and more detail), Speed=9600 baud is usually sufficient, Priority=0, Check Control Checksum, uncheck "Garmin mode for input". Other settings can be left to their defaults. Make sure the connection is checked.
9, Test by seeing your Boat become Red and move to true location and by Checking the Nmea Debug box under Connections, to see the Nmea commands being received.
10. For more details, related to Windows 8, but still applies:
11. You are given 10 minutes per use to allow testing then requested to purchase. The best way to purchase is through Paypal as it is good for 5 devices that way. About $2. Their response to my questions was within 6 hours and quite detailed, with Opencpn information.
If you are using Windows 8, John - a user at Intel, has put up a great Windows 8 pictorial guide to getting set up.
Windows 8 Pairing Guide https://software.intel.com/en-us/blo...re-apps-part-3
I invite others to post their detailed APP settings and success.
- Wireless solution for wired USB/Serial GPS receivers
- Pairs with any compatible Bluetooth SPP (slave) profile device
- Works with any Bluetooth enabled PC and most popular GPS software including:
Microsoft's Streets & Trips
Geolocational WiFi logging utilities (inSSIDer), and many other applications.
- Takes advantage of your Android phone's built-in AGPS for shortest time to first fix.
- Supports background running so you can use your phone uninterrupted.
For the fulll trial and error testing and Muttnick's help and explanation see forum thread Android GPS via Bluetooth to Laptop Opencpn
This thread tested various configurations with Muttnick's comments and explanations.
See this post about two other Android Aps for GPS Bluetooth
GPS Status & Toolbox
is a simple program to show all the GPS and sensor data of your phone. It is designed to be simple, yet effective. It helps you to see what is happening while the GPS is trying to acquire your locations and can be used as a simple compass, as a leveling tool, will measure the phone’s speed and acceleration, the brightness or the air pressure (if your phone has the necessary sensors.) The program also supports basic navigation functions that are useful when you are out in the wild.
My favorite GPS Tool - Acquires signal faster than any other app.
Send Android GPS signal to other devices
Bluetooth GPS Output Meowsbox
NOTE: Supports transmission over Wifi, USB or Bluetooth!
Tested with Opencpn over BT with Success!
Bluetooth GPS License Meowsbox
|Share your GPS location over Bluetooth to nearly any device or software. Use with popular charting programs in the comfort of your PC, maps on another tablet; even with the latest Android Wear.Users have reported success with: OpenCPN, Google Earth, xGPS, GRLevel, inSSIDer, GPSDirect, VisualGPS, even the Samsung Gear* and more! Updated to Version 2 with all the features users have been asking for.
GPS Share BT
|Unlocks Bluetooth GPS Output for unlimited usage.Simply purchase this license key, then close and reopen the Bluetooth GPS Output app. Google Play may require internet up to 2 days after purchase to permanently unlock Bluetooth GPS Output. Real human support staff is available to assist you - send us an email if you have any comments, questions.
GPS over BT Vasiliy Saenko
|Android phone become a Bluetooth GPS module that the Android Tablet and iPad can navigate. Support send NMEA data to Android Tablet without GPS so that it can navigate. Tablet need to install BT GPS
All tablet support ! Support send NMEA data to Wi-Fi-only iPad so that it can navigate. IPad need to install roqyBT4 or BTstack GPS. Support three NMEA output format：GPS, Russian GLNOSS and Chinese Beidou (BD2). Turn on Bluetooth, GPS and 3G data in one touch.
|GPS over BlueTooth allows you to connect your mobile phone as an external GPS receiver that can transmit information about satellites and the currrent location, using Bluetooth, to computer. This will help you to work with such programs as: SasPlanet, Google Earth, OziExplorer, 2Gis and other Navigation applications.
See this thread for further description of use. http://androidforums.com/threads/gps-over-bt-app.475494/
Recieve GPS signal from other devices
BT GPS is an Android tablet app that receives GPS data via Bluetooth. It lets any tablet become navigator right now. The app is specifically designed for large phone and tablet.
No problem! Using GPSDirect to develop location-aware apps
Welcome to GPSDirect and GPSReverse GPS NMEA Windows 7 Windows 8 Sensor Driver iOS Android TCP
"GPSDirect is basically a bridge solution. It's middleware that takes a GPS device connected on a virtual COM port and connects it to the Windows Location Sensor. To date, not many manufacturers provide a true sensor driver for their GPS receivers
, and GPS receivers
that are integrated into tablet and ultrabook platforms are still fairly rare. For those wishing to develop precision location-aware apps-- or even just use them-- GPSDirect represents the best way to make that possible when a native GPS sensor is not available on the system."
which uses one of the following Android Apps
GPS Sharing for Windows Sensor
This application shares your Android Phone's GPS with the Windows 7/Windows 8 Sensor driver (http://www.turboirc.com/gps7
)This allows you to share the GPS with any Sensor-enabled Windows 7 or Windows 8 Desktop/RT Application!
Turbo GPS 2
IF RUNNING ANDROID 4+ , GET Turbo GPS 3
The known all-in-one GPS for android, now in version 2.
* NMEA TCP Server
* Custom GPS provider support (including Bluetooth external GPS)
- Identification of celestial bodies.
- Nautical Almanac, including sun and moon phenomena.
- Sights: correction of the observed altitude and calculation of line of position (type of LoP: Marcq Saint Hilaire).
- Celestial Fix. GPX file output that serves as an input to OpenCPN. Complete solution: fix, circles of position, confidence ellipse.
The Running Fix problem is easily solved using Astronavigation.exe
Circles of position or Circles of equal altitude. General scale.
Fix and confidence ellipse. Coastal scale.
Software is available for free, for non-commercial use, at: http://sites.google.com/site/navigationalalgorithms/ (Only for Windows®)
Plotting circles of equal altitude: Method explained
Using the GPX utility and the Chart Work family of programs is it possible to do on an electronic nautical chart the work you do in a traditional way.
The three programs are:
GPX output includes:
- Lines of position and Great Circle sailings (orthodromic).
- Piloting: Currents and coastal fix.
- Search & Rescue search patterns.
Coastal navigation LoP
Celestial navigation LoP
- Horizontal angle
Piloting and coastal fix
- Marcq St. Hilaire Line of Position
- Circle of Position
SAR search patterns – Patrones de búsqueda SAR
- Currents Drift and Set
- Ciclonic method
- Fix by simultaneous Distance and Bearing of same object. Geographic Range, D( waterline, top of object )
- Fix by 2 simultaneous Horizontal Angles
- Expanding Square
- Sector Search
- Parallel Search for one ship
Chart Work - Lines of Position & GC sailing
Chart Work - Traditional paper chart work on an ECS.
the three types of lines of position used are:
- Horizontal angle
Fix by three simultaneous bearings.
Fix by three simultaneous bearings. Detail.
Offshore navigators use celestial navigation,sextant observations, as a backup for the GPS. Use a sextant for taking the altitude of a celestial body and OpenCPN to plot the celestial circle of position instead the LoP -Line of Position-. Repeat this and take at least three sights. You easily can check if any danger is near your fix, and the uncertainty in your position.
Parameters of a circle of position in astronavigation.
Route using the three types of sailings
- Rhumb Line. Direct with OpenCPN (And also using Plugin Route_pi).
- Great Circle(Direct in OpenCPN using using Plugin Route_pi).
- Composite(Direct in OpenCPN using using Plugin Route_pi).
The three types of sailing are also available in ChartWork
Composite Route plot with OpenCPN.
RDF or radiogoniometer provide a bearing. Its line of position may be plot using GPX input. Two options:
- RDF onboard
- RDF on station
Fix by two RDF bearings with OpenCPN.
Chart Work - Piloting
Using the OpenCPN GPX utility and the Chart Work - Piloting program is it possible to do on an electronic nautical chart the work you do in a traditional way.
Piloting and coastal fix
Advanced piloting techniques - Currents
- Currents Drift and Set
- Ciclonic method (820. Determining Track Made Good by Plotting Running Fixes. Bowditch-American Practical Navigator.)
- Fix by simultaneous Distance and Bearing of same object. Distance by:
D( waterline, top of object )
- Fix by 2 simultaneous Horizontal Angles
Chart Work - SAR search patterns
Search & Rescue utility that generates a GPX file for OpenCPN or Google Earth.
- Expanding Square
- Sector Search
- Parallel Search for one ship
- Parallel Search for two ships
Orientation as an input to takes into account tide, wind and drift.
Number of legs and its length may be configurable.
Free software to create the GPX file that serves as an input to OpenCPN is available at http://sites.google.com/site/navigationalalgorithms/
(Only for Windows®)
GPS Geolocation for Win8 GNSS Sensor
Small GPS Geolocation Application that enables Windows 8 Tablets or Notebooks with GNSS Sensor
It's been tested inside of a fiberglass boat and the GNSS sensor seems to be able to pick up the signal quite well. Hasn't been tested at sea yet. See the details here: https://bitbucket.org/petrsimon/geolocationtcp/wiki/Home
Code is available at the bitbucket repo, viz the link above.
The program needs to be improved in many ways. Right now it waits for a connection from OpenCPN and then starts to send messages. Once connected, it should start printing "Sent NMEA sentence $GPRMC XXXXXXX". If that doesn't happen perhaps OpenCPN did not connect. Check that the settings in OpenCPN are correct, as I'm sure you did. just press Apply or OK, once you filled all settings. Also have tried the GPS Satellite application to verify that the GNSS sensor works? You'll find it in the Store.
I'll soon make a nicer more user friendly interface what will make it easier to look for problems. Please watch the bitbucket repo for changes.
See "How to use OpenCPN on a tablet windows 8 thread" and Post 7
A paid alternative if Geolocation does not work for your installation / setup is
which works for an Asus Vivo Tab Smart.
GRIB Data and Software
Freeware application Ugrib allows instant and fully customizable access to global weather data. Within one simple to use interface you can download and view weather data right on your desktop.
The data being served at http://www.grib.us/GribData.aspx
is from the US GFS global weather model. Its has a native resolution of 0.5 degrees and includes surface winds and barometric pressure. The forecast you get from the webpage is a 7 day forecast with a 3 hour timestep.
Graphical software for Linux, Mac OS X and Windows (GPL3, Qt) to download and display GRIB 1 files.
Linux / OS X
- kplex: Open source (GPLv3) software NMEA 0183 multiplexer for Linux, OS X and FreeBSD. Handles serial, pty, TCP/IPv4, TCP/IPv6, IPv4/IPv6 UDP multicast, IPv4 broadcast UDP and file inputs and outputs and performs optional sentence filtering, checksumming and data source prioritisation/failover.
- Muplex: Open source under GPL, a Linux soft multiplexer that can mix different input flows of real or emulate serial (USB, bluetooth) NMEA datas and share it between multiple applications, creating virtual serial port and TCP/IP local loop or network, as VSPE for windows.
- AIS/NMEA Router and Decoder: Routes AIS and other NMEA sentences between Serial, UDP, TCP, USB, Internet, Log files, TTY Display, and TTY Display Windows. Free Windows program. AIS Guides. Website with detailed AIS information. PDF showing operation with Opencpn. AIS Decoding webpage
- VSPE: Closed source freeware, windows only, Virtual Serial Port Emulator enables you to use data from one serialport (such as GPS or NMEA data) simultaneously with several programs. You can run PolarCom, NavMonPC, OpenCPN and other navigation programs at the same time without COMport conflict.
- GeolocationTCP: The sole purpose of this program is to fill a gap for Windows 8 users unable to use OpenCPN with the internal GNSS sensor. The program creates a server which serves NMEA location information based on the status of GNSS sensor. OS/Hardware required: Windows 8 with GNSS sensor. For program download, installation, startup and Opencpn connection instructions, see https://bitbucket.org/petrsimon/geol...ntcp/wiki/Home
- NMEA MTK checksum calculator: http://www.hhhh.org/wiml/proj/nmeaxor.html
NMEA Instrument Display
- NavMonPC: Closed source, windows only, but reportedly excellent gauges for wind instruments, GPS, AIS display, anchor alarm, etc.
- PolarCOM: Closed source, windows, linux, mac; visually appealing gauges for wind instruments, GPS, anchor alarm, etc.
- CapCode: Free software, Java-based navigation programme with sailing/regatta focus, supports wind instruments, polars, VMG etc.
- Matrix Mariner GPS: Free software, Windows and Linux, visually appealing GPS display, some features for GPS handling including live gps output to Google Earth. (Windows version includes VSPE kernel mode virtual serial driver).
- gpsview:Tool for analyse NMEA textual data, allows to load NMEA log files and view data in table, graph and track forms.
- OSD_Depth: Open source under GPL, a Linux echo-sounder repeater which uses the OSD technique (On Screen Display, always on top of all applications, using big digits) to display the water depth from NMEA sentences 'DBT' or 'DPT' in meters, feet, or fathoms.
Nmea Server for Tests
Nmea Server using Python Script & Launcher_pi
Contributed by Transmitter Dan, reported by R. Gleason
From the Command Line - Once everything is set up:
from command prompt cd C:/python27
Command: > python VDRServer1.py Hakefjord-Sweden.txt 127.0.0.1 2947 .033
Command: > python VDRServer1.py Hartmut-Netherlands.txt 127.0.0.1 2947 .033
Another way to start the Nmea server is to define all the paths to the various files so you don't have to change directory to C:\python\. This example has the Nmea files under C:\Data-Dart\Nmea\ for example:
Command: > c:\python27\python c:\python27\VDRServer1.py C:\Data-Dart\Nmea\Hakefjord-Sweden.txt 127.0.0.1 2947 .033
Command: > c:\python27\python c:\python27\VDRServer1.py C:\Data-Dart\Nmea\Hartmut-Netherlands.txt 127.0.0.1 2947 .033
Download Attached Files
These are available at
Opencpn Beta File Thingie
Download from the Nmea-Server folder. PLEASE Remove ".TXT" from VDRServer1.py.TXT
Install and Setup:
1. Download and install Python27 Python is a platform independent scripting language interpreter.
2. You can Download Python for Windows here: https://www.python.org/downloads/
"Download Python 2.7.10
3. Execute the python-2-7-10.msi file and install to c:\python27 by default, it will require 95 mb.
4. Copy the file "VDRServer1.py" file into c:\python27
5. Copy the NMEA file Hakefjord-Sweden.txt into into c:\python27
6. Copy the NMEA file Harmut-Netherlands.txt into c:\python27
7. Open a command prompt Start > Run > enter CMD at the prompt type "CD C:\python27"
8. Then enter either command:
Command: python VDRServer1.py Hakefjord-Sweden.txt 127.0.0.1 2947 .033
Command: python VDRServer1.py Harmut-Netherlands.txt 127.0.0.1 2947 .033
9. Leave the command prompt window open to keep the Pyton Server program running.
10. In Opencpn, set up a communications channel for network UDP. This is what the setup screen in O looks like for Windows: In Opencpn Options > Connections > Add connection
Connection Type: Network
Control Checksum checked
Receive Input checked
Output on this port not checked
Input Filtering: Sentences only button
11. Now you should see the Nmea data being run in Sweden or Netherlands
12. See TransmitterDan's Python script "VDRServer1.py", which is also below.
Using Launcher_pi to make it easy
If you want to make this even easier, you can download the Launcher_pi plugin and install it. Then under Options > Plugins > Launcher, Enable the plugin.
Then use Launcher > Preferences to make appropriate entries to run various nmea files for testing, eg:
Name : Haken-Sweden
Command: c:\python27\python c:\python27\VDRServer1.py C:\Data-Dart\Nmea\Hakefjord-Sweden.txt 127.0.0.1 2947 .033
Command: c:\python27\python c:\python27\VDRServer1.py C:\Data-Dart\Nmea\Hartmut-Netherlands.txt 127.0.0.1 2947 .033
Under Options > Plugins hit Apply, Ok and then in the main Opencpn screen bring up the Launcher menu.
You should see Hakefjord-Sweden and Hartmut-Netherlands to select. Try one of them. Don't close the command prompt or the nmea file will stop running. Now go setup Opencpn > Options > Connections as in item #10 above.
if len(sys.argv) < 4:
print("[python] VDRServer1.py InputFile IP_Address Port# [Sleep time]")
print("Sleep time is the delay in seconds between UDP messages sent.")
print("Sleep time defaults to 0.1 seconds")
UDP_IP = sys.argv
UDP_PORT = int(sys.argv)
filename = sys.argv
if len(sys.argv) > 4:
delay = float(sys.argv)
delay = 0.1
print(['UDP target IP:', UDP_IP])
print(['UDP target port:', str(UDP_PORT)])
sock = socket.socket(socket.AF_INET, # Internet
socket.SOCK_DGRAM) # UDP
f = open(filename, 'r')
while True :
mess = f.readline()
if len(mess) < 1:
mess = mess.strip()
Olex to GPX Conversion
Olex File with 2000- 3000 waypoints and routes
How do I change waypoints from Olex plotter to be compatible with Open CPN
OpenCPN uses the GPX format to store waypoints. If Olex can export this format, Yes.
There are lots of free tools that convert various formats to/from GPX.
How to convert to GPX for use in OpenCPN?
NewGPSU Olex File Converter Utility New
Version 1.05, Released 2-JAN-2013
A program for converting OLEX files to/from GPS Utility Format Files.
GPS Utility - Download
Not Free Registered version does unlimited number of waypoints.
Does Open CPN support NMEA 0183 sentence called TLL (Target Latitude, Longitude).
Yes, OpenCPN supports both TLL and TTM messages, see Radar Targets | Official OpenCPN Homepage
(not very well tested yet).
Another alternative: GPSBabel: convert, upload, download data from GPS and Map programs
"SASPlanet is a program designed for viewing and downloading high-resolution satellite imagery and conventional maps submitted by such services as Google Maps, DigitalGlobe, Kosmosnimki, Yandex.Maps, Yahoo! Maps, VirtualEarth, Gurtam, OpenStreetMap, eAtlas, Genshtab maps, iPhone maps, Navitel maps, Bings Maps (Bird's Eye) etc., but in contrast to all these services all downloaded images will remain on your computer and you will be able to view them, even without connecting to the internet."
Overlay GRIB data on satellite images in OpenCPN using WxtoImage, Opencpn and Weatherfax_pi plugin.
Detailed process explanation from retrieving the satellite image to using Weatherfax to locate the satellite image on the chart, and then comparing the satellite data to grib files. by Littlechay (Chris). Thank you, Chris.
Overlay GRIB data on satellite images in OpenCPN
1. France, SHOM - http://www.shom.fr/fr_page/fr_serv_prediction/ann_marees.htm
2. United Kingdom, easytide UKHO - http://easytide.ukho.gov.uk/EASYTIDE/EasyTide/SelectPort.aspx
3. United Kingdom, NOC - http://www.pol.ac.uk/ntslf/tidalp.html
4. The Netherlands, RWS - Tidal data: http://www.rijkswaterstaat.nl/kaarten/astronomisch-getij.aspx
5. The Netherlands, RWS - Tidal data: http://getij.rws.nl/getij_locaties.cfm?taal=en
6. Germany, BSH - http://www.bsh.de/de/Meeresdaten/Vorhersagen/Gezeiten/index.jsp
7. United States, NOAA - http://tidesandcurrents.noaa.gov/gmap3/
8. Canada, CHS (pdf files) You will find the pdfs on the tide station page -http://www.waterlevels.gc.ca/eng/data/predictions/2013
9. Canada, CHS - http://www.marees.gc.ca/cgi-bin/tide-shc.cgi?queryType=showFrameset&zone=1&language=english®ion=4&stnnum=3250
Not for navigation!
XTide - Harmonic tide clock and tide predictor. Work with X-windows, plain text terminals, or the web.
WXTide32 - a free Windows tide and current prediction program.
WXTides Stations - tcdata, (HARMONIC, HARMONIC.IDX), for OpenCPN
cTide: tide prediction software for PocketPC's
JTides - an advanced, accurate, easy-to-use tide and current prediction Java MDI (Multi-Document Interface) application.
QuickTide - a free Windows tide program specifically made for The Netherlands, especially for the tidal area of the Waddenzee. For Linux: runs under Wine. In Dutch only.
Xinutop Marine OS
Xinutop-nav is a Linux portable or installed marine OS, including a lightweight base applications from Xfce
family, and provide, with about 500Mo, essential marine applications such as:
- OpenCPN: naturally ! chartplotter, tides, AIS, grib files, GPS interface and others navigation datas (dashboard).
- Polarcom: virtual instrumentation, from NMEA datas.
- XTide: tides with numerical and graphical display, worlwide coverage.
- Zygrib: download and display weather grib files.
- Fldigi: reception and display radio weather-fax and NAVTEX, via the sound card.
- Muplex: NMEA multiplexer.
- Rastow: raster charts organizer
- OSD Depth: display water depth with big digits above any application (aka "on top").
Xinutop is made with a special care of lightness, simplicity, efficiency, reliability, non redundancy which can operate from multiple datas devicess (HDD, SSD, USB, SDcard,Flash) on a great variety of x86 instructions set compatible computers, specially with low power processors, or those unfairly considered as obsolete, poorly supporting the growing greed of currents OS, less and less compatible with embedded hardware. Xinutop can run as a portable operating system on removable device, but also as a main operating system on hard drive (same install). The memory usage after startup is about 100MB. To make Xinutop unbreakable (may I say "unbrickable" - used term for deads tablets - or almost ?), the necessary system files and directories are locked and can't be deleted or modified by a normal way (even in root mode).
Xinutop is assembled with Ubuntu 14.04 packages (Trusty) and include these features:
- A robust architecture: main file system in squashfs, boot system protected, no write access.
- A fast boot provided by lrd scripts, more simple and very much faster at boot than casper, the default live system for Debian-Ubuntu.
- A persistent mode that allows to keep the user datas and system changes in a transparent user layer (as Linux-Android system).
- A restore mode, allowing to findnize exactly the original system (simply by deleting the user layer).
- A "home-save" function, to automatically save and move user home datas during a restoration. Interesting if you want try hazardous solutions !
- A full access to session and sytem without any password, allowed by this operating mode. Due to the particular architecture, an inexperimented user can't brake the system. In any case, you are sure to reboot and make a restoration if needed. The purpose of Xinutop is a navigation tool, used by the skipper and the crew; if you have very personal datas, use an external device and/or create a password in your bios.
- A ramdisk mode, which boost time access, running Xinutop from a virtual harddisk emulated in memory (RAM mini 768Mo). You can start it from a slow device as an USB key and run it faster than a conventional installation on a HDD.
- The full compatibility with applications of the Ubuntu distribution. You can install and run any other application from your user layer.
Xinutop is under GPL V3, then you are free to use, distribute and modify it, but at your own risk and under your own responsability !
INFOS AND DOWNLOAD
Usually a gyrocompass is not available at a yacht. Instead one or more magnetic compasses serve for steering. The reading of this kind of compass must be corrected for variation and deviation.
OpenCPN uses true course over ground. The course to steer is calculated taking into account the wind, the current and the compass correction: magnetic variation + magnetic deviation:
Deviation curve of magnetic compass
An analytic method for obtaining the deviation curve of a magnetic compass allowing obtaining the value of the deviation for any course.