Readme

Description

Package features:

• SQL database for storing AIS position reports and vessel metadata

• Vessel position cleaning and trajectory modeling

• Utilities for streaming and decoding AIS data in the NMEA binary string format (See Base Station Deployment)

• Integration with external datasources including depth charts, distances from shore, vessel geometry, etc.

• Network graph analysis, MMSI deduplication, interpolation, and other processing utilities

• Data visualization

Web Interface: https://aisdb.meridian.cs.dal.ca/

Docs: https://aisdb.meridian.cs.dal.ca/doc/readme.html

Source Code: https://git-dev.cs.dal.ca/meridian/aisdb

What is AIS?

Wikipedia: https://en.wikipedia.org/wiki/Automatic_identification_system

Description of message types: https://arundaleais.github.io/docs/ais/ais_message_types.html

Install

Requires Python version 3.8 or newer. Optionally requires SQLite (included in Python) or PostgresQL server (installed separately). The AISDB Python package can be installed using pip. It is recommended to install the package in a virtual Python environment such as venv.

python -m venv env_ais
source ./env_ais/*/activate
pip install aisdb

For information on installing AISDB from source code, see Installing from Source

Documentation

An introduction to AISDB can be found here: Introduction.

Additional API documentation: API Docs.

Code examples

1. Parsing raw format messages into a database

2. Automatically generate SQL database queries

3. Compute trajectories from database rows

4. Vessel trajectory cleaning and MMSI deduplication

5. Compute network graph of vessel movements between polygons

6. Integrating data from web sources, such as depth charts, shore distance, etc.