Skip to content

VTTI-CSM/ShipNetSim

Repository files navigation

NeTrainSim
ShipNetSim [Network Ships Simulator]

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

Download ShipNetSim | Documentation

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"

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