File | Date | Author | Commit |
---|---|---|---|
aislogger | 2009-08-09 | Erik Olsson | [80a779] Bugfix: don't fail sorting in alert/remark view |
bin | 2009-08-01 | Erik Olsson | [f0d399] Reorganization of tree for distutils |
doc | 2009-08-09 | Erik Olsson | [181633] Added a user manual for AIS Logger |
external | 2009-08-01 | Erik Olsson | [f0d399] Reorganization of tree for distutils |
MANIFEST.in | 2009-08-09 | Erik Olsson | [895a20] Updated makefile for docs and sdist target |
Makefile | 2009-08-09 | Erik Olsson | [895a20] Updated makefile for docs and sdist target |
README.md | 2009-08-09 | Erik Olsson | [66a876] More readme fixes |
setup.py | 2009-08-09 | Erik Olsson | [895a20] Updated makefile for docs and sdist target |
AIS Logger is a simple viewer and logger for data received by
AIS-transponders or -receivers.
In summary:
The software is quite stable for daily use, but has some rough
edges. The GUI is not as friendly as it could be with regards to
helpful error messages and wizards. There are also a few GUI problems
when running on *nix systems, but it is usable.
AIS Logger has a few, but large, dependencies that needs to be
installed in order to use it. All of these should be readily available
in package repositories on *nix systems. If you plan to use AIS Logger
under Windows, please use a release binary as they are mostly self
contained (see the install instructions below).
These are the run-time dependencies:
Download and extract the archive to a location of your
choosing. Create a suitable shortcut to aislogger.exe and enjoy.
NOTE: You may have to install a few DLL files for AIS Logger to
run. You may put them in the winnt\system directory or directly in
the AIS Logger directory. Common missing files are gdiplus.dll (from
GDI+), msvcp90.dll and msvcr90.dll (both from Visual
C++).
Download and extract the archive to a temporary location and then
do:
$ python setup.py install # As root
$ aislogger # As normal user to start program
To compile the documentation you will need markdown in your
path. Then clone from Github, and do:
$ make doc # Generates manual (not necessary)
$ python setup.py install # As root
$ aislogger # As normal user to start program
Simply delete the directory containing AIS Logger.
Find the site-packages directory under your python installation
directory (typically /usr/lib/pythonX.X/site-packages/ on *nix).
Delete the aislogger directory and the file
aislogger-XXXX-pyX.X.egg-info. You also have to delete the script
aislogger (typically in /usr/bin under *nix). Done.
When running on Windows and saving the configuration file, you can
safely save the configuration file to the program directory.
Under *nix, you cannot save the configuration file directly to the
suggested directory because you don't have permission to write to the
AIS Logger directory. Please save the configuration file in your home
directory and start the program with the -c switch and the config
file:
$ aislogger -c myconfigfile.ini
To build AIS Logger on Windows, first install all dependencies given
above. You will also need to install py2exe to build the
distribution (any modern version should do).
Extract the source archive to a directory. Then run the following
command:
> python setup.py py2exe
You may need to use the full path to your python installation if it's
not in your $PATH. The result of the build is now in the directory
"dist" and is ready to run and distribute.
Automatic Identification System is a system used to identify and
locate maritime vessels. Transponders automatically broadcast
information via a VHF transceiver, so called “messages”, containing
data such as the vessels current position, heading, speed, name and
radio callsign. To receive these messages you will need either a
full-fledged transponder or a special receiver that communicate with a
computer through a serial interface. In theory, you could use a
standard VHF-scanner and a sound card to intercept AIS messages, but
this is currently not supported in AIS Logger. For this you could try
GNU AIS instead.
The following code is used by, and distributed with, AIS Logger but is
externally developed: