shipAIS

A Toolkit for AIS Data Processing and Visualization

Overview

shipAIS is a MATLAB class designed to efficiently import, process, visualize, and animate Automatic Identification System (AIS) data for ships. With built-in options for data cleaning, resampling, smoothing, and interactive visualization, `shipAIS` provides a suite of tools for maritime operators, researchers, and analysts. The toolkit is intended for teaching and research purposes only.

The toolkit includes the deg2utm and utm2deg functions [1,3], the KML Toolbox [2], and the function min_dist_between_two_polygons [4] for convenience.

Key Features

AIS Data Import & Processing:

• Import AIS data from CSV or other file formats, clean and resample it with user-defined methods.

Derived Fields Calculation:

• Compute key navigational parameters like Rate of Turn (ROT), accelerations, and UTM coordinates.

Interactive Visualization & Animation:

• Visualize AIS data fields through customizable plots and animate ship movements, with options to save as MP4 videos.

Environmental Object Modeling:

• Calculate minimum distances between the ship and defined environmental objects, such as buoys or landmasses.

Data Export:

• Export processed data to CSV files or visual plots as high-resolution JPG images for record-keeping and further analysis.

KMZ Export for Google Earth:

• Generate KMZ files to visualize ship movements in Google Earth.

Installation

1. Download the package from MATLAB File Exchange.
2. Unzip the contents into a directory of your choice.
3. Open MATLAB and select the `shipAIS` folder. This folder contains three subfolders: `doc`, `examples`, `shipAISv01`.
4. Run `runMeFirst` to add the `shipAISv01` directory and its subfolders to MATLAB.
5. To view documentation, select the `doc` directory and run the `plotAIS_doc` live script.
6. To run example, go to the folder `examples/example0` and run the `main.m` function.

References

[1] Rafael Palacios (2024). deg2utm (https://www.mathworks.com/matlabcentral/fileexchange/10915-deg2utm), MATLAB Central File Exchange. Retrieved October 3, 2024.

[2] Rafael Oliveira (2024). KML toolbox (https://github.com/theolivenbaum/kml-toolbox), GitHub. Retrieved October 3, 2024.

[3] Rafael Palacios (2024). utm2deg (https://www.mathworks.com/matlabcentral/fileexchange/10914-utm2deg), MATLAB Central File Exchange. Retrieved October 3, 2024.

[4] Guillaume JACQUENOT (2024). Minimum distance between two polygons (https://www.mathworks.com/matlabcentral/fileexchange/22444-minimum-distance-between-two-polygons), MATLAB Central File Exchange. Retrieved October 3, 2024.