Introduction
Library for decoding maritime Automatic Identification System messages.
See Also
Automatic Identification System
Other open source AIS projects:
Building
Building with Python
$ python setup.py build
$ python setup.py installTesting with Python
$ virtualenv ve
$ source ve/bin/activate
$ python setup.py testBuilding with CMake
$ cmake .
$ makeBuilding with legacy Makefile
$ make -f Makefile-custom testUsage
There are two interfaces to libais, one high-level iterator based one and a low-level fast C++ only one. The iterator based interface is accessed the following way:
import ais.stream
with open("file.nmea") as f:
for msg in ais.stream.decode(f):
print msgTo use the low-level C++ interface directly, you need to handle multi-line messages and padding yourself:
import ais
ais.decode('15PIIv7P00D5i9HNn2Q3G?wB0t0I', 0)
ais.decode('402u=TiuaA000r5UJ`H4`?7000S:', 0)
ais.decode('55NBjP01mtGIL@CW;SM<D60P5Ld000000000000P0`<3557l0<50@kk@K5h@00000000000', 2)There is also support for converting parsed messages to the structure output by GPSD / gpsdecode. For full compatibility, you have to write the resulting message dictionaries to a file with json.dump() and add a newline after each message.
import ais.stream
import json
import ais.compatibility.gpsd
with open("infile.nmea") as inf:
with open("outfile.gpsd") as outf:
for msg in ais.stream.decode(f):
gpsdmsg = ais.compatibility.gpsd.mangle(msg)
json.dump(gpsdmsg, outf)
outf.write("\n")AIS Specification Documents
ITU-1371, ITU-1371-{1,2,3,4]
IMO Circ 236
IMO Circ 289
EU RIS
Developing
The C++ code was switched to the Google style in November, 2012. Indenting should be by 2 spaces.
http://google-styleguide.googlecode.com/svn/trunk/cpplint/
$ git clone https://github.com/schwehr/libais
$ cd libais
$ virtualenv ve
$ source ve/bin/activate
$ pip install -e .[tests]
$ python setup.py test
$ py.test --cov=ais --cov-report term-missingor
$ git clone https://github.com/schwehr/libais
$ cd libais
$ virtualenv ve
$ source ve/bin/activate
$ pip install -e .[test]
$ python setup.py develop
$ python setup.py test
$ py.test --cov=ais --cov-report term-missing1 maintainer
Metadata
1 maintainer
Release files for libais 0.17
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| libais-0.17.tar.gz | 157.4 kB | Details |
Release files / libais-0.17.tar.gz
| Download URL | libais-0.17.tar.gz |
|---|---|
| Size | 157.4 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
eb2aea2298c5e976927d748e4c0d01e1fdda2dc1d792003fdd6059041350d35f
|
|
BLAKE2b-256 checksum How to use checksums |
8cbedf64b5f1dfa2bc26f7cc4c8483129ef6cdf8683c93789439f67701fb4c26
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
