Keelson Processor AIS

TODO: Processor tasks:

• Parsing raw AIS messages from Sjöfartverker (DONE), Digitrafik (TODO) & Kystverket to Keelson protobuffer message format and publishing formatted data
  • Only for area of intrest (needs dynamic update)
  • Output format Target
• AIS data validation

Quick start

python3 bin/main.py --log-level 10 -r rise -e ted --publish udp_sjv --subscribe sjofartsverket 

python3 bin/main.py --log-level 20 -r rise -e erik --publish udp_sjv --subscribe sjofartsverket 

python3 bin/main.py --log-level 10 -r rise -e ted --publish log --subscribe digitraffic 

Record

docker run --rm --network host --name ais-udp ghcr.io/rise-maritime/keelson-processor-ais:0.0.3 "keelson-processor-ais -r rise -e erik --publish udp_sjv --subscribe sjofartsverket"


sudo docker run --rm --network host  --name mcap-logger --volume ~/rec:/rec ghcr.io/rise-maritime/keelson:0.3.7-pre.51 "keelson_processor_ais --output_path rec -k rise/v0/ted/**"

--mode client --connect tcp/10.10.7.2:7448

Setup for development environment on your own computer:

1. Install Docker Desktop for Windows

   • Docker desktop will provide you with an UI for monitoring and controlling docker containers and images along debugging
   • If you want to learn more about docker and its building blocks of images and containers checkout Docker quick hands-on in guide

2. Start up of Zenoh router either in your computer or any other computer within your local network

    # Navigate to folder containing docker-compose.zenoh-router.yml
   
    # Start router with log output 
    docker-compose -f containing docker-compose.zenoh-router.yml up 
   
    # If no obvious errors, stop container "ctrl-c"
   
    # Start container and let it run in the background/detached (append -d) 
    docker-compose -f containing docker-compose.zenoh-router.yml up -d

   Link to --> docker-compose.zenoh-router.yml

3. Now the Zenoh router is hopefully running in the background and should be available on localhost:8000. This can be example tested with Zenoh Rest API or continue to next step running Python API

4. Set up python virtual environment python >= 3.11

   1. Install package pip install -r requirements.txt

5. Now you are ready to explore some example scripts in the exploration folder

   1. Sample are coming from:
      • Zenoh Python API

Zenoh CLI for debugging and problem solving

UDP 1830

Start UDP AIS stream on port 1830

Step 1: Set up configuration file

• Make a folder for Keelson connectors and processors:
  • Copy a docker compose file docker-compose.ais-processor.yml OR create a file with name "docker-compose.ais-processor.yml" and add content bellow

services:

  keelson-processor-ais:
    image: ghcr.io/rise-maritime/keelson-processor-ais:latest
    container_name: keelson-processor-ais
    restart: unless-stopped
    network_mode: "host"
    command: "--log-level 10 --publish udp_sjv --subscribe sjofartsverket"

Step 2: Set up docker service configuration

• Open a terminal and navigate to location where you created the file

• Run following start up command in a terminal to start the service

  docker compose -f docker-compose.ais-processor.yml up -d

• Docker images will be downloaded and service started

Step 3: Open Docker Desktop

• Check if you can find the new service in docker desktop
• From now on you can start and stop the service from docker desktop (You do not need to do the step 2 again)