shipAIS

A Toolkit for AIS Data Processing and Visualization
19 Downloads
Updated 4 Oct 2024

View License

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.

Cite As

milan batista (2024). shipAIS (https://www.mathworks.com/matlabcentral/fileexchange/173435-shipais), MATLAB Central File Exchange. Retrieved .

MATLAB Release Compatibility
Created with R2024b
Compatible with any release
Platform Compatibility
Windows macOS Linux

Community Treasure Hunt

Find the treasures in MATLAB Central and discover how the community can help you!

Start Hunting!
Version Published Release Notes
1.0.5

Add utm2deg into shipAISv01 folder, so it can be accessed by getEnv function

1.0.4

Clean folders

1.0.2

Upload CSV data file

1.0.1

Minor changes

1.0.0