Skip to main content

AIS Cursor-on-Target Gateway.

Project description

IF YOU HAVE AN URGENT OPERATIONAL NEED: Email ops@undef.net or call/sms +1-415-598-8226

Screenshot of AIS points in ATAK-Div Developer Edition.

aiscot receives AIS Sentences from an AIS Receiver, such as ais-decoder, converts them to Cursor-on-Target Events, and transmits the CoT Events to a destination.

For use with CoT systems such as ATAK, WinTAK, etc. See https://www.civtak.org/ for more information on the TAK program.

Utilized for an open ocean boat race in the Northern Pacific Ocean, as described in this article: http://ampledata.org/boat_race_support.html

Support AISCoT Development

AISCoT has been developed for the Disaster Response, Public Safety and Frontline community at-large. This software is currently provided at no-cost to our end-users. All development is self-funded and all time-spent is entirely voluntary. Any contribution you can make to further these software development efforts, and the mission of AISCoT to provide ongoing SA capabilities to our end-users, is greatly appreciated:

Support AISCoT development: Buy me a coffee!

Installation

The AIS to Cursor on Target Gateway is provided by a command-line tool called aiscot, which can be installed several ways.

Installing as a Debian/Ubuntu Package:

$ wget https://github.com/ampledata/pytak/releases/latest/download/python3-pytak_latest_all.deb
$ sudo apt install -f ./python3-pytak_latest_all.deb
$ wget https://github.com/ampledata/aiscot/releases/latest/download/python3-aiscot_latest_all.deb
$ sudo apt install -f ./python3-aiscot_latest_all.deb

Install from the Python Package Index:

$ pip install aiscot

Install from this source tree:

$ git clone https://github.com/ampledata/aiscot.git
$ cd aiscot/
$ python setup.py aiscot

Usage

The aiscot daemon has several runtime arguments:

$ aiscot -h
usage: aiscot [-h] [-c CONFIG_FILE] [-d] [-U COT_URL] [-P AIS_PORT] [-S COT_STALE] [-F FILTER_CONFIG] [-K KNOWN_CRAFT]

optional arguments:
  -h, --help            show this help message and exit
  -c CONFIG_FILE, --CONFIG_FILE CONFIG_FILE
  -d, --DEBUG           Enable DEBUG logging
  -U COT_URL, --COT_URL COT_URL
                        URL to CoT Destination. Must be a URL, e.g. tcp:1.2.3.4:1234 or tls:...:1234, etc.
  -P AIS_PORT, --AIS_PORT AIS_PORT
                        AIS UDP Listen Port.
  -S COT_STALE, --COT_STALE COT_STALE
                        CoT Stale period, in seconds
  -F FILTER_CONFIG, --FILTER_CONFIG FILTER_CONFIG
                        FILTER_CONFIG
  -K KNOWN_CRAFT, --KNOWN_CRAFT KNOWN_CRAFT
                        KNOWN_CRAFT

See example-config.ini for example configuration.

Author

Greg Albrecht W2GMD oss@undef.net

http://ampledata.org/

License

  • aiscot is licensed under the Apache License, Version 2.0. See LICENSE for details.
  • pyAISm.py is licensed under the MIT License. See aiscot/pyAISm.py for details.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for aiscot, version 3.1.0
Filename, size File type Python version Upload date Hashes
Filename, size aiscot-3.1.0.tar.gz (16.6 kB) File type Source Python version None Upload date Hashes View
Filename, size aiscot-3.1.0-py3-none-any.whl (16.6 kB) File type Wheel Python version py3 Upload date Hashes View

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Huawei Huawei PSF Sponsor Microsoft Microsoft PSF Sponsor NVIDIA NVIDIA PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page