The ONE

The Opportunistic Network Environment simulator.

Information

The ONE is a simulation environment that is capable of

ONE can import mobility data from real-world traces or other mobility generators. It can also produce a variety of reports from node movement to message passing and general statistics.

The simulator is written in Java (1.6). More documentation is available in form of javadocs.

News

25.8.2008 New version (1.2.0) with a new movement model framework is available

18.8.2008 New section in the homepage: user contributions

6.5.2008 A beta version of the next release (1.1.0) is now available

Download

You can get the source code tar-ball for the latest version (1.2.0) from here.
For Windows users, there's a zip packet available here.

Note that the latest version is still in beta-stage and might behave in unexpected ways.

Old versions

Description .tar.gz .zip javadoc
The ONE version 1.1.0 download download browse
The ONE version 1.0.1 download download browse

Sample scenarios

Here you can download some additional scenarios for the ONE that are not included in the distribution package. The field "ONE version" tells you which version(s) of the ONE the scenario is suitable for. You can download the file by clicking the filename at the "download" column. The entry in the contact column tells you where you can ask questions or give comments about the scenario.

name description ONE version contact download
Epidemic TTL test Sample scenario of testing the effect of Time to Live (TTL) to Epidemic routing protocol's performance. The package contains also the resulting report files, so you can use this to check if you managed to install and run the ONE properly. 1.0 - 1.1 The ONE mailing list epidemic_ttl.zip
RWP Epidemic Simple scenario of 200 nodes doing Random Waypoint movement with Epidemic routing (similar to the 3rd screenshot). 1.0 - 1.1 The ONE mailing list rwp_epidemic.zip

User contributions

Here you can find add-ons and scripts for the ONE that the users of the ONE have created.

name description ONE version made by download
BonnMotion converter This perl script can convert mobility traces created with the BonnMotion to a form that is suitable for the ONE as external movement model input. 1.0 - 1.1 Vinicius Mota orderedNs2Parser.pl

 

Contact

For questions about the simulator you can subscribe to theONE 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.

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 (should work in Linux, Windows and Mac OS X).

Start a simulation by typing (in Linux/Unix/OS X)
./one.sh
or (in Windows)
one.bat

After a short while, the GUI should start and a simulation should be up and running.

Every simulation run uses the settings from default_settings.txt. You can give an additional configuration file as a parameter to define new settings or override the ones defined in default settings. For example:

./one.sh epidemic_settings.txt

That would use the (included) epidemic settings configuration file and change the router for all nodes to epidemic (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 snw_comparison_settings.txt 22

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 included README.txt for more information.

Publications

Ari Keränen and Jörg Ott: Increasing Reality for DTN Protocol Simulations. Technical Report, Helsinki University of Technology, Networking Laboratory, July 2007. [prelimenary PDF] (official PDF with ISBN to come)

Screenshots


Simulator running with 100 nodes, map-based movement and Spray and Wait routing


Zoomed view of the simulation


Random waypoint with 200 nodes and 250m radio range


Adjacency graph generated from a report (with some help from Graphviz)


Message passing graph (only messages from h1 to h2)

eXTReMe Tracker