readme

Service Location Protocol

/******************************************************************************
*   Copyright (C) 2004  Toilers Research Group -- Colorado School of Mines
*
*   Please see COPYRIGHT.TXT and LICENSE.TXT for copyright and license
*   details.
*******************************************************************************/


=======================================================================
IMPLEMENTATION OF THE STEADY-STATE RANDOM WAYPOINT MOBILITY MODEL 
=======================================================================

Original mobgen program written by Jeff Boleng <[e-mail]>
(Ph.D. 2002 from the Colorado School of Mines).

Program modified to create mobgen-ss by Nick Bauer (M.S. 2004 
from the Colorado School of Mines). 

The papers related to the code:
        * W. Navidi and T. Camp, Stationary Distributions for the Random 
        Waypoint Mobility Model, IEEE Transactions on Mobile Computing,
        vol. 3, no. 1, pp. 99-108, January-March 2004. 

        * W. Navidi, T. Camp, and N. Bauer, Improving the Accuracy of 
        Random Waypoint Simulations Through Steady-State Initialization,
        Proceedings of the 15th International Conference on Modeling and 
        Simulation (MS '04), pp. 319-326, March 2004. 

We are happy to share our code with you. We only ask that any published 
research from using our code include a reference to the appropriate 
preceding paper.

If you have any questions on the code, send email to
Tracy Camp <[e-mail]>.

The research group's URL is:  http://toilers.mines.edu

=======================================================================

The mobgen-ss program is used to generate mobility files for NS2, gnuplot, 
and QualNet.  The mobility files use the random waypoint model, where a node 
picks a random point on the simulation area and a random speed and then 
travels to that point at the chosen speed.  Once it arrives, the node pauses 
for a randomly chosen pause time, and then repeats the process until the 
simulation ends.  The mobgen-ss program picks initial node positions, 
speeds, and pause times according to the steady-state distributions of the 
random waypoint model, so that no time is required to let the distributions 
of position and speed settle at the beginning of the simulation.

To compile the mobgen-ss program, type "make" and the makefile will compile 
the program. 
(The program has been tested under 
gcc version 3.3.2 and gcc 2.96)

To execute the mobgen-ss program, type:
mobgen-ss <number of nodes>
          <max-x> <max-y> <end time>
          <speed mean> <speed delta>
          <pause time> <pause time delta>
          <'N' or 'G' or 'Q'>
          'N' implies NS2 mobility file
          'G' implies gnuplot path file
          'Q' implies QualNet mobility file

where <number of nodes> is the number of nodes in the simulation, <max-x> 
and <max-y> are the lengths of the sides of the simulation rectangle, and 
<end time> is the length of the simulation.  The nodes will pick speeds from 
a uniform distribution centered at <speed mean> with a range of <speed 
delta> on either side.  The last command line argument is a single letter 
indicating the type of mobility file to generate, where 'N' implies NS2 
mobility file, 'G' implies gnuplot path file, and 'Q' implies QualNet 
mobility file.

The permitted values of input parameters are: 
	<number of nodes> must be greater than 0 
	<max-x> and <max-y> must be greater than 0 
	<end time> must be greater than or equal to 0 
	<speed mean> must be greater than 0 
	<speed delta> must be greater than or equal to 0
		 and less than <speed mean> 
	<pause mean> must be greater than or equal to 0 
	<pause delta> must be greater than or equal to 0 
		and less than or equal to <pause mean> 

NOTES: The minimum speed must be positive, because the steady-state 
distribution is degenerate when the minimum speed is 0. An end time 
of zero only gives the initial configuration of the nodes without 
any movement. 

=======================================================================