https://github.com/sinaa/train-simulator

A train simulator to investigate the Ferromone Trails concept, with variable and fixed block signalling
https://github.com/sinaa/train-simulator

ant-colony-systems decentralised self-driving simulation simulator train

Last synced: 4 days ago
JSON representation

A train simulator to investigate the Ferromone Trails concept, with variable and fixed block signalling

• Host: GitHub
• URL: https://github.com/sinaa/train-simulator
• Owner: sinaa
• License: gpl-3.0
• Created: 2017-05-30T12:35:02.000Z (over 7 years ago)
• Default Branch: master
• Last Pushed: 2022-12-14T20:32:31.000Z (almost 2 years ago)
• Last Synced: 2023-03-24T14:02:55.749Z (over 1 year ago)
• Topics: ant-colony-systems, decentralised, self-driving, simulation, simulator, train
• Language: Java
• Homepage: https://sinaa.github.io/train-simulator/
• Size: 271 KB
• Stars: 2
• Watchers: 2
• Forks: 1
• Open Issues: 3
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# Train Simulator - Decentralised Self-Driving Trains

[![Build Status](https://travis-ci.org/sinaa/train-simulator.svg?branch=master)](https://travis-ci.org/sinaa/train-simulator)

### Ferromone Trails Concept

Ferromone Trails is a concept of using the existing train infrastructure such that trains can self-organise safely, without having to rely on a centralised network. This project is a Java-based simulator created from scratch which was built to investigate the feasibility of this concept. The concept is modeled after ant-colony algorithms, where pheromone trails are used for organisation and navigation.

![Train Simulator Screenshot](gh/screenshot.png)

# Getting Started

## Download

[Download Latest Release: 1.0.0](https://github.com/sinaa/train-simulator/releases/download/1.0.0/train-simulator-1.0.0-SNAPSHOT.jar)

## Run it!

Start by executing the program (Notice: Java 1.8 is required):

    java -jar train-simulator.jar

Navigate to http://localhost:8080 and follow the intstructions on the page to run your desired simulation.

![Simulator Menu](gh/menu.png)

## Runtime Arguments

### Custom Maps

Maps can be created in YAML format. You can pass custom maps to the program using the argument: 

    java -jar train-simulator.jar --maps=path/to/my_map.yaml,path/to/map/folder,...

    

All maps used to evaluate this study are [available here](https://github.com/sinaa/train-simulator/releases/download/1.0.0/experiment-maps.zip).

### Output folder

By default, the results will be exported to the `./results` directory in the current working directory. This can be changed by passing the runtime argument `--output=my/custom/path`.

# Development Status

The simulator application was built under the Department for Transport T-TRIG grant, and since the objectives of the study have already been investigated, the project is no longer actively maintained. However, contributions are more than welcome!

# License

This project is released under GPL License. Please review [License file](LICENSE) for more details.