AIS Demo

This Demo offers a simple exploratory interface over AIS Data.

For a chosen MMSI, it shows the vessel location over chosen dates. Location can be represented with latitude and longitude, or with H3. The H3 resolution can be adjusted to show more or less detail.

Components

The Dashboard is created using Dash & Plotly for the map, Pandas for the frontend data processing, and Tinybird for the backend.

Dataset

The dataset comes from NOAA, and is a few billion vessel observation samples from 2020.

To Use

1. Clone this repository
2. Create a Python virtual env python -m venv .venv && source ./.venv/bin/activate
3. Install the Python dependencies pip install -r requirements.txt
4. Open or create your Tinybird Workspace
5. Open the Tinybird Auth Token page and copy the User Admin Token
6. In your CLI, run tb auth in the repo directory and paste the Auth Token
7. Then run tb push to establish the backend processing structure and serve the data APIs
8. Use noaa_uploader.sh to append as many of the zipped CSV files as you need to Tinybird for sample data. Jan-May is about 1b rows. You will need jqinstalled: sudo apt-get update && sudo apt-get install jq -y --no-install-recommends or brew install jq for MacOS.

⚠️ NOTE: NOAA provide this data for free, so don't abuse their download server

9. Run app.py to have a local Dash app to explore some of the shipping data. The default values should work

You could also stream in live AIS data following the same format.

Credits

Created by: @Chaffelson, @juliavallina, @sdairs, and @rbarbadillo