---------------------- README for Installation and Usage Procedure for the Obstacle Mobility Model Plugin for NS-2 ---------------------- ---------------------- Introduction ---------------------- The Obstacle Model is a mobility model developed at the Mobility Management and Networking (MOMENT) Lab, Department of Computer Science, University of California at Santa Barbara, CA - 93106. Visit : http://moment.cs.ucsb.edu/mobility for more information ---------------------- Installation ---------------------- Modules required for the Obstacle Model Plugin are : 1. TerGen Tool (provided with the tarball) 2. The CGAL-2.4 libraries (provided at http://moment.cs.ucsb.edu/mobility or http://www.cgal.org) 3. CGAL voronoi graph code (provided with the tarball) 4. NS-2 Plugin files For installation purposes, 1. Download and install the CGAL libraries. The CGAL libraries are required to generate the voronoi graphs by TerGen. 2. Replace the file 'voronoi.C' at ~/CGAL-2.4/examples/Triangulation_2/ with the one provided with the tarball. Provide an absolute path to the data file in the voronoi.C code. Compile the code. 3. Extract the NS-2 files and replace the original NS-2 files with the given files. (Note : The tarball does not contain the entire NS-2 code. The latest copy of NS-2 can be obtained from http://www.isi.edu/nsnam/ns/) 4. Compile the simulator code. 5. Compile the TerGen code ---------------------- Version for the TerGen Tool ---------------------- This is a GUI based tool that shall aid the user in graphically placing objects on a terrain and generating the voronoi graph by using the CGAL libraries. 1. Compiling javac tergen.java 2. Usage - Enter the terrain size and visualization scale in the text boxes e.g. if the user wants a terrain of size 1000x1000 enter x -> 500 y -> 500 scale -> 2 - Draw rectangular objects on the canvas - For accepting an object, click on "Take Point" - For deleting an object, select it from the List and click "Delete" - Select NS-2 or GlomoSim - Click "Make Voronoi" to generate the input files and to display the voronoi graph on the canvas. 3. Path Change - The paths for the CGAL libraries have been hard-coded. Change them in tergen.java before using TerGen. 4. Files Generated a. Obstacles.txt This contains the co-ordinate positions of the obstacles specified. In case the user would like to place a different kind of a quadrilateral shape on the canvas, the user can manually type out the co-ordinate positions in this file. b. edges.in This file contains the voronoi edges that are generated by TerGen. The format of this file shall depend on the tool (NS-2 or GloMoSim) chosen. ---------------------- Version for TerGen ---------------------- Release 1.0 for TerGen - The Terrain Generator! ---------------------- Version for NS-2 Plugin ---------------------- This release is version 1.0 (first public release) of the Obstacle Model Plugin for NS-2. ---------------------- NS-2 Plugin Included ---------------------- The included files is a plugin to the NS-2 network simulator. The plugin has been developed for the ns-2.26 version of the network simulator with the CMU Monarch Project's Wireless Extensions. After untarring the tarball, the user should find 4 directories : 1. setdest/ This directory contains files that generate the mobility scenario. The usage is ./setdest -n -p -s -t -x -y -f 2. mobile/ 3. mac/ These directories contains files that shall simulate the signal propagation model. 4. scripts/ This directory contains a. sample tcl script wireless-om.tcl : Change the paths in this script. b. voroscript.pl This shall help the user in visualizing the movement of nodes on paths with the NAM animator. usage : ./voroscript namfile voronoifile xdim ydim tcl[0/1] nam[0/1] namfile : this is the name of the nam file that you shall create after running the tcl script. This script modifies the nam file. voronoifile : this is the voronoi edges file created by TerGen xdim : the x-dimension of the terrain ydim : the y-dimension of the terrain tcl : 0/1 decision to run the tcl script nam : 0/1 decision to trigger the nam visualization tool Note : The setdest code generates a file named "voro.edges" which is a list of processed edges. This file can be used as a 'voronoifile' for the 'voroscript.pl' script input. ---------------------- Input files required from TerGen ---------------------- The following files would have to be generated by using the TerGen Tool. Obstacles.txt : This file would contain the co-ordinate positions of the obstacle objects Place this file in the following directories a. ~/ns-2.26/indep-utils/cmu-scen-gen/setdest/ b. ~/ns-2.26/mobile/ edges.in : This file contains the voronoi edges. Place this file in the following a. ~/ns-2.26/indep-utils/cmu-scen-gen/setdest/ b. ~/ns-2.26/tcl/ex/ ---------------------- Note ---------------------- - The code is under constant improvement by the developer, in order to include more features. In the process, the user may observe variations in the results obtained. Please do inform the developer in case of widely varying results. ----------------------- Comments and Bug reports ---------------------- Please send all comments, suggestions and bug reports to amitj[at]cs.ucsb.edu