Skip to content

VTTI-CSM/ShipNetSim

NeTrainSim
ShipNetSim [Network Ships Simulator]

DOI License: GNU GPL v3 GitHub tag (latest by date) GitHub All Releases CLA Required CLA assistant

Build and Push Docker Image

Download ShipNetSim | Documentation

For questions or feedback, contact Ahmed Aredah or Prof. Hesham Rakha

Ship Network Simulator (ShipNetSim)

ShipNetSim is an open-source simulation software designed to analyze ship energy consumption and emissions in extensive maritime networks. Built with a modular and adaptable structure using Qt6, it integrates propulsion-resistance models, real-time environmental data, and advanced path-finding algorithms for longitudinal vessel motion analysis.

How to Cite

@INPROCEEDINGS{10733439,
  author={Aredah, Ahmed and Rakha, Hesham A.},
  booktitle={2024 IEEE International Conference on Smart Mobility (SM)}, 
  title={ShipNetSim: A Multi-Ship Simulator for Evaluating Longitudinal Motion, Energy Consumption, and Carbon Footprint of Ships}, 
  year={2024},
  volume={},
  number={},
  pages={116-121},
  keywords={Measurement;Energy consumption;Adaptation models;Carbon dioxide;Trajectory;Fuels;Marine vehicles;Greenhouse gases;Carbon footprint;ShipNetSim;Ships Large-Scale Simulation;Ships Longitudinal Motion;Energy Consumption;Environmental Footprint},
  doi={10.1109/SM63044.2024.10733439}}

Features

  • Open Access: ShipNetSim is freely accessible and openly modifiable to support community collaboration.
  • Modular and Flexible: Ships of varying types, sizes, and fuel types can be analyzed, with scalability to support evolving policies and technological advancements.
  • Environmental Sensitivity: Capable of simulating operational strategies like reduced speeds and alternate fueling to comply with International Maritime Organization (IMO) standards.
  • Cybersecurity Modeling: Analyzes risks like GPS spoofing and network disruptions, simulating impact on ship navigation and energy efficiency.
  • Real-time Analytics: Tracks energy consumption, emissions, and vessel dynamics for each ship, enabling data-driven decisions.
  • Adaptable Pathfinding: Integrates visibility graphs and QuadTree indexing to optimize navigation and obstacle avoidance on real-world routes.

Getting Started

Download the latest release version on the releases page.

Prerequisites

ShipNetSim requires no additional setup, as all third-party dependencies are bundled within the installer.

Installation

  • Download the installer file.
  • Double-click to open and follow the setup prompts. The default path is C:\Program Files\ShipNetSim, but this can be adjusted as needed.

Running

GUI Interface

  • The GUI is still under developement.

Shell Interface

  • Open a terminal or command prompt.

  • Navigate to the installation folder:

cd "C:\Program Files\ShipNetSim"
Type ShipNetSim -h to view command options.
ShipNetSim.exe -s "path\to\ships\file"

Building from Source

To build ShipNetSim from source code, please see our comprehensive HOW_TO_BUILD.md guide, which includes:

  • Complete dependency installation instructions
  • Platform-specific build steps for Windows, Linux, and macOS
  • CMake configuration options and customization
  • Troubleshooting common build issues

Collaborators

  • Ahmed Aredah, M.Sc.:

    • Ph.D. student, Dept. of Civil and Environmental Engineering, Virginia Tech
    • M.Sc. Student, Dept. of Computer Science | Engineering, Virginia Tech
    • Graduate Research Assistant at Virginia Tech Transportation Institute
  • Hesham A. Rakha, Ph.D. P.Eng., F.IEEE:

    • Samuel Reynolds Pritchard Professor of Engineering, Charles E. Via, Jr. Dept. of Civil and Environmental Engineering
    • Courtesy Professor, Bradley Department of Electrical and Computer Engineering
    • Director, Center for Sustainable Mobility at the Virginia Tech Transportation Institute
    • Fellow of Asia Pacific Artificial Intelligence Association
    • Fellow of the American Society of Civil Engineers
    • Fellow of the Canadian Academy of Engineering
    • Fellow of IEEE

License

ShipNetSim is licensed under GNU GPL v3. See the LICENSE file for more details.

Contributing

Interested in contributing? Please see our CONTRIBUTING.md file for guidelines on how to participate.

Contributors

Ahmed Aredah
Ahmed Aredah

๐Ÿ’ป
Hesham Rakha
Hesham Rakha

๐Ÿ“†
Add your contributions

About

An open-source integrated ship network simulator.

Topics

Resources

License

Code of conduct

Security policy

Stars

Watchers

Forks

Packages