View on GitHub

The ONE

The Opportunistic Network Environment simulator

Download this project as a .zip file Download this project as a tar.gz file

Information

The ONE is a simulation environment that is capable of

The ONE simulator was developed at Aalto University and is now maintained and extended in cooperation between Aalto University (Comnet) and Technische Universität München (Connected Mobility).

Developers: Ari Keränen, Teemu Kärkkäinen, Mikko Pitkänen, Frans Ekman, Jouni Karvo, and Jörg Ott

Acknowledgments

The ONE simulator has been developed in the SINDTN and CATDTN projects supported by Nokia Research Center (Finland), in the TEKES ICT-SHOK Future Internet and IoT-SHOK projects, Academy of Finland projects RESMAN and Picking Digital Pockets (PDP), European Community's Seventh Framework Programme SCAMPI project, and supported by EIT ICT Labs.

Releases

The latest release:

Previous releases:

Older versions of the ONE are available from the old ONE homepage.

Referring to the ONE simulator

If you have used the ONE simulator in your research, please use the SIMUTools paper ([PDF] [BibTeX]) as the reference.

Community Resources

The users of the ONE simulator have created many helpful resources:

Contact

For questions about the simulator you can subscribe to the ONE user community email list at our mailman.

This list is for discussion and announcements for the ONE simulator. The users of the ONE can report bugs, share experiences and code, and give hints to each other on this list. New releases of the ONE are also announced on this list.

However, we are planning to move to a new platform for Q&A in the near future. Stay tuned, the change will be announced at the mailing list.

License

The program is released under GPLv3 license. Copyrights of the included map data of Helsinki downtown are owned by Maanmittauslaitos.

Running (a really quick help)

Download the program. Compile it using your favourite IDE or compile.bat (on Windows) or compile.sh (on Linux or Mac OS X).

Start a simulation by typing in (Linux/Unix/OS X) terminal:

./one.sh

or (in Windows):

one.bat

After a short while, the GUI should start and a simulation based on default settings should be up and running.

Every simulation run uses the settings from default_settings.txt, if one exists. You can give an additional configuration file(s) as a parameters to define new settings or override the ones defined in default settings. For example:

./one.sh example_settings/snw_settings.txt

That would use the (included) snw_settings.txt settings configuration file and change the router for all nodes to Spray and Wait (default is "passive router", i.e., no routing logic). See default_settings.txt for information about the different settings.

If you don't wish to use the GUI, you can run simulations in batch mode using -b option. In batch mode you can also define the number of runs using different run indexes. For example:

./one.sh -b 22 example_settings/snw_comparison_settings.txt 

That would run Spray and Wait comparison using 11 different message copy counts and with binary and normal mode. See Settings class' javadoc for details about run indexing.

To create a local copy of the javadoc documentation, run the create_docs.sh script in the doc folder.

See the project README for more information.

Publications

Michael Solomon Desta, Ari Keränen, Teemu Kärkkäinen, Esa Hyytiä, Jörg Ott: Evaluating (Geo) Content Sharing with the ONE Simulator. Invited demo paper. Proceedings of the 14th ACM Symposium Modeling, Analysis and Simulation of Wireless and Mobile Systems (MSWiM), November 2013. [PDF]

Ari Keränen, Teemu Kärkkäinen, and Jörg Ott: Simulating Mobility and DTNs with the ONE (Invited paper). Journal of Communications, Academy Publisher, Vol 5 No 2, pp 92-105, February 2010.

Ari Keränen, Jörg Ott and Teemu Kärkkäinen: The ONE Simulator for DTN Protocol Evaluation. SIMUTools'09: 2nd International Conference on Simulation Tools and Techniques. Rome, March 2009. [PDF] [BibTeX]

Jouni Karvo and Jörg Ott: Time Scales and Delay-Tolerant Routing Protocols. Proceedings of the ACM MobiCom CHANTS Workshop, September 2008. San Francisco, September 2008. [PDF] [BibTeX]

Frans Ekman, Ari Keränen, Jouni Karvo, and Jörg Ott: Working Day Movement Model. 1st SIGMOBILE Workshop on Mobility Models for Networking Research, Hong Kong, May 2008. [PDF] [BibTeX]

Ari Keränen: Opportunistic Network Environment simulator. Special Assignment, Helsinki University of Technology, Department of Communications and Networking, May 2008. [PDF]

Ari Keränen and Jörg Ott: Increasing Reality for DTN Protocol Simulations. Technical Report, Helsinki University of Technology, Networking Laboratory, July 2007. [PDF]