This is the readme file of ANSim version 3.02

ANSim stands for "A"d-Hoc "N"etwork "Sim"ulation

Overview:
It's a tool for statistical simulation of Ad-Hoc Netowrks. The user provides the simulator with input of some base parameters such as size and shape of the geographical area, range of the stations, etc. The Simulator will calculate results like the probability that two selected stations are connected.

ANSim can be used as a scene generator for other simulators. ANSim creates XML-output (according to the schema sppmobtrace.xsd) for the nodes movement. A converter creates ns2 files out of the xml-files. I have added a converter for glomsim that generates the nodes.input and the mobility.in files. There is an on-line version that acts as input interface for a quick trial.

http://www.i-u.de/schools/hellbrueck/ansim/ansimfrm.htm

Note:
The XML to ns2 and xml to glomosim converter tool makes use of the xerces java XML parser. For details have a look at:
http://xml.apache.org/xerces-j/

Licensing
Feel free to use the program without any restrictions.
Please do not change the code or distribute it to others without contacting me as I want to keep track of the program at the moment. If you are interested in further extensions of ANSim please let me know.
I intend to make also the source code generally available when my PhD is finished.

Requirements:
- installed jdk 1.1 or higher ("java -version" will show)
- ansim was succesfully tested with 
  - jdk1.1.8  (linux SUSe 7.0)
  - jdk1.3    (linux SUSe 7.0)/Windows2000/Solaris8.0
  - jdk1.4    (linux SUSe 8.0)/Windows2000

Installation:
- Unzip the files to a directory of your choice
- Make sure that the classpath is set correctly to this directory and the classes can be found or just use the run script files "run" and "ns2" "glomosim".
- You can copy the jar files into the <javaroot>/jre/lib/ext directory for a permanent installation, so that you do not have to take care of the classpath anymore.

Start:
- open a shell 
- type "java ansim.main.ANSim" or start the "run" script file
  
  The ANSim GUI appears:
- Type in/Choose your input parameters
  Press the "Start" button to run the simulation
  Press "Stop" to finish
  
  Have fun!!!
  

Creating ns2 files:
- open a shell 
- type "java ansim.main.ANSim -log XML_SPP" to enable XML logging or start the "ns2" script file
  The ANSim GUI appears:
- Type in/Choose your input parameters
  make sure that the scenario is mobile
  Press the "Start" button to run the simulation
  Press "Stop" to finish
- exit ANSim
- The current directory contains a file "ANSimlogSPP.xml"
- type "java ansim.tools.xml.XMLToNs2Converter ANSimlogSPP.xml ANSimlog.ns2" or just wait if you have started "ns2" script file
- after several seconds there is another file "ANSimlog.ns2"
  
Creating glomosim files:
- open a shell 
- type "java ansim.main.ANSim -log XML_XML" to enable XML logging or start the "glomosim" script file
  The ANSim GUI appears:
- Type in/Choose your input parameters
  make sure that the scenario is mobile
  Press the "Start" button to run the simulation
  Press "Stop" to finish
- exit ANSim
- The current directory contains a file "ANSimlogSPP.xml"
- type "java ansim.tools.xml.XMLToGlomosimConverter" or just wait if you have started "glomosim" script file
- after several seconds there are two other files "nodes.input" and "mobility.in"
  That's it

For converting the old xml-file use the switch -old for the ns2 or glomosim converter.

URLs:

OLD XML schema:
http://www.i-u.de/schools/hellbrueck/ansim/xml/simulation.xsd
NEW XML schema (SPP):
http://www.i-u.de/schools/hellbrueck/ansim/xml/sppmobtrace.xsd

download:
http://www.i-u.de/schools/hellbrueck/ansim/download/ansim.zip

help:
http://www.i-u.de/schools/hellbrueck/ansim/help.htm

on-line version:
http://www.i-u.de/schools/hellbrueck/ansim/ansimfrm.htm


Contact:
If there are any questions left, don't hesitate to contact me

Horst.Hellbrueck@i-u.de