Skip to main content

The ONE Tutorial (Moved)

  1. Introduction
  2. Why?
  3. Target Audience
  4. Pre-conditions
  5. The Scenario
  6. General Steps
  7. Configuration File(s)
  8. Specify Scenario Settings
  9. Specify Network Interfaces for Nodes
  10. Create a Group of Nodes
  11. Specify Motion Patterns
  12. Specify Traffic Pattern
  13. Specify Reports to be Generated
  14. Running the Simulation

The ONE tutorial has moved to a new page. Please click here to follow.


Opportunistic Network Environment is a Java-based simulator targeted for research in Delay Tolerant Networks (DTNs)/Opportunistic Mobile Networks (OMNs). Apart from letting a user to simulate different scenarios quickly and in a flexible manner, it also provides an easy way to generate statistics from the simulation performed.
ONE can be run on Linux, Windows, or any other platform supporting Java. Details about ONE, including how to download and run, can be found from the official site. A list of common questions and their answers are listed here.

Read more »


  1. Hi,
    thanks for the useful ONE tutorial.
    If possible, I am interested in more details about creating messages by loading an external file containing a list of messages. Like: file structure, parameters, how the file is called from the config file, etc.

  2. Thanks for your comments, Mirza! I plan to write a post on the external events. Right now, I would briefly outline it. The external file containing messages should be in the format: time C msg_id node_from node_to size

    Your settings file should include the following:
    Events1.class = ExternalEventsQueue
    Events1.filePath = path/to/message/trace.txt

  3. sounds good, thanks for the answer ..
    one key problem concerning ONE is lacking a good documentation. a single "read me" file can't perform the job !!
    a further question plz: can the sender's and receiver's IDs be randomly generated ?! even if in the "default_settings" file !

  4. Very useful Tutorial, I'm new with ONE simulation and your blog it's finally given me a direction to where to Look.

  5. Hi.. I have recently started using ONE for my term project. Your tutorial has been of great help indeed. I had some queries regarding movement models and manually assigning position of nodes.. can u please help me understand that?

    1. Alok,

      Please join the ONE mailing list at and post your question there. The community would be able to help you.

  6. Hello..
    I have recently started my masters final year project on opportunistic networks using one simulator.Your tutorials are extremely helpful. I had some queries regarding the TTL and message creation..Can you please help me??

    I want to know

    What is the Relationship between TTL expiry and New Message Creation???
    How the messages are being created??
    For different messages the TTL are diffferent??? What is the logic behind the TTL??
    Also Epidemic Routing replicates the actual message.But when i saw the event log it displayed messages with different size. Then how it becomes Epidemic Routing??

    1. The value of TTL would depend on your application/context. It can be different for different messages. Larger TTL generally translates to better chances of message delivery.

  7. Hello sir..
    I have started my project paper on opportunistic network.I have a query.Can you please help me???

    Apart from the prescribed routing algorithm in the one folder ,how will I implement my own routing algorithm so that it will be followed by one simulator???
    What are the steps required?? Where will I start???

    please help me sir...

    1. Our forthcoming book, Opportunistic Mobile Networks: Advances and Applications (, has a chapter on this. In general, you should start by studying the existing routing protocols.

  8. Hi, mate.
    I am not so familiar with the ONE Simulator. I want to ask you, I look at each node packet carries green, blue, and red. What's the difference? thanks.

    1. From the README file, "If a node is carrying messages, each
      message is represented by a green or blue filled rectangle. If node
      carries more than 10 messages, another column of rectangles is drawn for
      each 10 messages but every other rectangle is now red."

  9. hello sir,
    I want to ask you, how can I implement selfish behavior in the ONE Simulator, there isn't much more documents and tutorials on that!
    Best regards.

    1. Short answer: override the message replication logic so that one or more messages are not sent to a set of node(s).


Post a Comment

Popular posts from this blog

Text Highlighting in Latex

While preparing a manuscript with Latex, it is often useful to highlight the changes made in the current revision with a different color. This can be achieved using the \ textcolor command provided by Latex. For example, \textcolor {red}{Hello World} would display the string "Hello World" in red color. However, the final/published copy of the manuscript does not contain any highlighted text. Therefore, if a large volume of changes were made, it becomes tiresome at the end to find and remove all the individual portions of highlighted text. This can be circumvented by defining a utility command to switch highlighting on and off as desired. In the following, we define a new Latex command, highlighttext , for this purpose. The command takes only a single argument—the text to be highlighted.     \usepackage {color}    % For highlighting changes in this version with red color   \newcommand { \highlighttext }[1] { \textcolor {red}{#1}}   % Remove all text highlighting

Commonly Used Metrics for Performance Evaluation

The following metrics are commonly used when evaluating scenarios related to DTN protocols. Delivery ratio of the messages, Average message delivery latency Overhead ratio (of the underlying routing mechanism) Suppose that $M$ be the set of all messages created in the network and $M_d$ be the set of all messages delivered. Then, the delivery ratio is computed as $|M_d| / |M|$. Now let the $i^{th}$ delivered message was created at time $c_i$ and delivered at time $d_i$. Then the average message delivery latency is computed as $(\sum_{i = 1}^{|M_d|} (d_i - c_i)) / |M_d|$. Note that, in Statistics, mean, median and mode are all the measures of average. But "loosely speaking", unless otherwise specified, we refer to the "mean" value when we say "average." Nevertheless, the MessageStatsReport in the ONE simulator provides a measure of both the mean and median values wherever appropriate. One may refer the above metric as "end-to-end delay.

The ONE KB has a new home

The ONE Knowledge Base is now hosted at If you are unaware, the ONE KB allows you to search the old email archives of the simulator's community. Therefore, if you have any question related to simulation, you may query the existing database at the above link. Chances are good that your question might already have been answered previously. If not, you can still post an email to the community's mailing list. Have you tried the ONE KB already? How was your experience? Was it helpful? Let me know in the comments!