Bike3S-Simulator - Introduction

Bike3S is a simulator created for the purpose of testing different behaviors in real bike sharing systems. Bike sharing systems allow citizens to move between different places in an simple and economical way. Bike3S offers us the possibility to execute situations using different infrastructure configurations, user models and balancing algorithms.

The motivation of this project is to search strategies to balance the system resources using systems, typically, based on incentives, which recommend the users to rent or return a bike in a certain station to contribute to the system balancing

Here you'll find all the necessary documentation to use and develop new features in Bike3S.

For Users

If you just want to run the simulator with preconfigured user behaviors in different cities around the world, just follow the next guide: User Guide

For Developers

If you are a developer or researcher and wants to create new things for the simulator, you should start here. With this guide you will learn to:

• Configure and prepare your system for development.
• Configure you're favorite IDE.
• Learn the architecture and fundamentals of the simulator to implement new things.
• Implement different users behaviors.
• Implement your own recommendation system.

And more... Feel free to see how to make all this fun stuff reading the developers Guide:

Developer Guide

F.A.Q.

F.A.Q. link

Users Guide

TO DO

Developers Guide

Prerequisites

1. JDK 1.8
2. Maven >= 3.5
3. Node.js >= 8.9
4. Git

Please make sure that all the binaries are registered in your PATH.

The package manager NPM is also required but is usually bundled with the Node.js installer.

Getting Started for Development

This project is development environment agnostic. You can use a IDE or just the command line

General overview of the software architecture

The project is separated in two mains parts backend and a frontend.

The user flow is presented here.

The backend is related to all the simulation logic and is implemented in Java. The folder /backend-bikesurbanfleets contains this part of the project.

The frontend is related to all the GUI and data analysis of the simulations. It is implemented in TypeScript, using Angular and Electron. The folder /frontend-bikesurbanfleets contains this part of the project.

Setup

1. Firstly of all, check that all prerequisites are installed.
2. Execute this commands in the project directory.

    git clone https://github.com/gia-urjc/Bike3S-Simulator.git
    cd Bike3S-Simulator
    npm install
    node fuse configure:dev

If no errors appeared you have now all prepared for all you want. Run the program, compile simulator, etc... Next sections are just commands to compile and run the system.

Execute Frontend

You can now execute your program and try it just by running:

    node fuse build:frontend

Execute Backend

TODO - Execute Backend users generator and Backend Users Core example

Build From Command Line

To build the backend, execute this command:

    node fuse build:dev-backend

To build the frontend and execute the GUI:

    node fuse build:frontend

To build all project:

    node fuse build:dist

Distrubute

To distribute and executable or installer for your OS, just run npm run distribute

Executables are generated in build/dist/

Fundamentals

TODO - Link to pdf developer manual

Simulate from the command line

Are you too lazy to configure your IDE? No problem, you can execute this commands to execute the simulator.

Generate users:

node fuse gen-users:dev

An example user generation can be run via node fuse gen-users:dev. The configuration files are taken from the folder /examples/usergeneration-test. To test quickly simulations without the GUI, you can use or edit these configuration files and run this command. The results file users_configuration.jsonis created in teh same folder.

Simulate:

node fuse simulate:dev

An example simulationcan be run via node fuse simulate:dev . The configuration files are taken from the folder /examples/simulation-test. To test quickly simulations without the GUI, you can use or edit these configuration files and run this command. The results of the simulation (history and analysis) will be stored in /examples/simulation-test/history and /examples/simulation-test/analysis.

F.A.Q

What IDEs or Text Editors should I use

First of all, this project is divided in two code bases, a backend (JAVA) and a frontend (TypeScript + Angular + Electron).

This project is prepared for any IDE or Text editor you want. Some editors/IDEs will work for both code bases, some only for one code base. Here you have some basic configuration for the most common IDE's and text editors and the part of the project you can work with it:

IntelliJ IDEA CE (Backend)

WebStorm (Frontend)

Visual studio Code (Backend and Frontend)

Eclipse (Backend)

Netbeans (Backend)

Publications

1. Fernández, A., Billhardt, H., Ossowski, S., Sánchez, Ó. (2020) Bike3S: A tool for bike sharing systems simulation. Journal of Simulation, 14 (4), pp. 278-294.

   • link https://doi.org/10.1080/17477778.2020.1718022

2. Billhardt, H.; Fernández, A.; Ossowski, S. (2021) Smart Recommendations for Renting Bikes in Bike-Sharing Systems. Applied Sciences, 11 (20), pp. 15.

   • link https://dx.doi.org/10.3390/app11209654

3. Fernández A., Billhardt H., Timón S., Ruiz C., Sánchez Ó., Bernabé I. (2019) Balancing Strategies for Bike Sharing Systems. In: Lujak M. (eds) Agreement Technologies. AT 2018. Lecture Notes in Computer Science, vol 11327. pp 208-222. Springer, Cham

   • link https://doi.org/10.1007/978-3-030-17294-7_16

4. Fernández A., Timón S., Ruiz C., Cumplido T., Billhardt H., Dunkel J. (2018) A Bike Sharing System Simulator. In: Bajo J. et al. (eds) Highlights of Practical Applications of Agents, Multi-Agent Systems, and Complexity: The PAAMS Collection. PAAMS 2018. Communications in Computer and Information Science, vol 887. pp 428-440. Springer, Cham

   • link https://doi.org/10.1007/978-3-319-94779-2_37
   • Presentation: BikeSharingSimulator-PAAMS-2018