examples/stats/README
author Tom Henderson <tomh@tomh.org>
Mon, 28 Sep 2015 20:27:25 -0700
changeset 11676 05ea1489e509
parent 10401 6e9d4ceb880b
permissions -rw-r--r--
bug 2184: Integer overflow in MacLow
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
3570
44b0bc6817c6 Stats module and example merged in.
tjkopena@cs.drexel.edu
parents:
diff changeset
     1
44b0bc6817c6 Stats module and example merged in.
tjkopena@cs.drexel.edu
parents:
diff changeset
     2
			  ns-3 stats example
44b0bc6817c6 Stats module and example merged in.
tjkopena@cs.drexel.edu
parents:
diff changeset
     3
44b0bc6817c6 Stats module and example merged in.
tjkopena@cs.drexel.edu
parents:
diff changeset
     4
The example script wifi-example-db.sh in this directly will run
44b0bc6817c6 Stats module and example merged in.
tjkopena@cs.drexel.edu
parents:
diff changeset
     5
through the entire process of running a simple experiment.  It assumes
44b0bc6817c6 Stats module and example merged in.
tjkopena@cs.drexel.edu
parents:
diff changeset
     6
sqlite3 is installed as it uses the sqlite3 data output format of the
44b0bc6817c6 Stats module and example merged in.
tjkopena@cs.drexel.edu
parents:
diff changeset
     7
statistics package.  It also assumes it is being run from the
44b0bc6817c6 Stats module and example merged in.
tjkopena@cs.drexel.edu
parents:
diff changeset
     8
examples/stats/ subdirectory of the ns-3 package, together with its
44b0bc6817c6 Stats module and example merged in.
tjkopena@cs.drexel.edu
parents:
diff changeset
     9
gnuplot script.  When the script completes successfully, a graph will
44b0bc6817c6 Stats module and example merged in.
tjkopena@cs.drexel.edu
parents:
diff changeset
    10
be have been produced in examples/stats/wifi-default.eps demonstrating
44b0bc6817c6 Stats module and example merged in.
tjkopena@cs.drexel.edu
parents:
diff changeset
    11
output from this example.
44b0bc6817c6 Stats module and example merged in.
tjkopena@cs.drexel.edu
parents:
diff changeset
    12
44b0bc6817c6 Stats module and example merged in.
tjkopena@cs.drexel.edu
parents:
diff changeset
    13
More information on the statistics package and this example is
44b0bc6817c6 Stats module and example merged in.
tjkopena@cs.drexel.edu
parents:
diff changeset
    14
available online on the ns-3 wiki at:
44b0bc6817c6 Stats module and example merged in.
tjkopena@cs.drexel.edu
parents:
diff changeset
    15
10401
6e9d4ceb880b Update ns-3 wiki URL
Daniel Lertpratchya <nikkipui@gmail.com>
parents: 5502
diff changeset
    16
http://www.nsnam.org/wiki/Statistical_Framework_for_Network_Simulation
5502
04acce3f7133 Bug #645: fixes for opening stats file with OMNeT++
Andras Varga <andras@omnetpp.org>
parents: 3570
diff changeset
    17
04acce3f7133 Bug #645: fixes for opening stats file with OMNeT++
Andras Varga <andras@omnetpp.org>
parents: 3570
diff changeset
    18
*** Using ns-3 with the OMNeT++ analysis tool ***
04acce3f7133 Bug #645: fixes for opening stats file with OMNeT++
Andras Varga <andras@omnetpp.org>
parents: 3570
diff changeset
    19
04acce3f7133 Bug #645: fixes for opening stats file with OMNeT++
Andras Varga <andras@omnetpp.org>
parents: 3570
diff changeset
    20
The stat framework can write out the result in a format that is compatible with the
04acce3f7133 Bug #645: fixes for opening stats file with OMNeT++
Andras Varga <andras@omnetpp.org>
parents: 3570
diff changeset
    21
output format of OMNeT++ 4 Discrete Event Simulator Framework.
04acce3f7133 Bug #645: fixes for opening stats file with OMNeT++
Andras Varga <andras@omnetpp.org>
parents: 3570
diff changeset
    22
Use the wifi-example-omnet.sh script to generate the results in OMNeT++ format.
04acce3f7133 Bug #645: fixes for opening stats file with OMNeT++
Andras Varga <andras@omnetpp.org>
parents: 3570
diff changeset
    23
04acce3f7133 Bug #645: fixes for opening stats file with OMNeT++
Andras Varga <andras@omnetpp.org>
parents: 3570
diff changeset
    24
If you want to analyse the results with OMNeT++'s result analyser tool:
04acce3f7133 Bug #645: fixes for opening stats file with OMNeT++
Andras Varga <andras@omnetpp.org>
parents: 3570
diff changeset
    25
a) Download OMNeT++ 4 and install it. Start the IDE. (www.omnetpp.org)
04acce3f7133 Bug #645: fixes for opening stats file with OMNeT++
Andras Varga <andras@omnetpp.org>
parents: 3570
diff changeset
    26
b) If you do not want to install the whole simulator framework, there is a seperate 
04acce3f7133 Bug #645: fixes for opening stats file with OMNeT++
Andras Varga <andras@omnetpp.org>
parents: 3570
diff changeset
    27
   package which contains only the analysis tool from the OMNeT++ package.
04acce3f7133 Bug #645: fixes for opening stats file with OMNeT++
Andras Varga <andras@omnetpp.org>
parents: 3570
diff changeset
    28
   You can download it from http://omnetpp.org/download/release/omnetpp-scave.tgz
04acce3f7133 Bug #645: fixes for opening stats file with OMNeT++
Andras Varga <andras@omnetpp.org>
parents: 3570
diff changeset
    29
04acce3f7133 Bug #645: fixes for opening stats file with OMNeT++
Andras Varga <andras@omnetpp.org>
parents: 3570
diff changeset
    30
Once you are running the OMNeT++ IDE or the separate analysis tool (SCAVE)
04acce3f7133 Bug #645: fixes for opening stats file with OMNeT++
Andras Varga <andras@omnetpp.org>
parents: 3570
diff changeset
    31
- Choose File|Import...|Existing Projects into Workspace, then click [Next]
04acce3f7133 Bug #645: fixes for opening stats file with OMNeT++
Andras Varga <andras@omnetpp.org>
parents: 3570
diff changeset
    32
- Select root directory. (choose the examples/stats directory) and click [Finish]
04acce3f7133 Bug #645: fixes for opening stats file with OMNeT++
Andras Varga <andras@omnetpp.org>
parents: 3570
diff changeset
    33
04acce3f7133 Bug #645: fixes for opening stats file with OMNeT++
Andras Varga <andras@omnetpp.org>
parents: 3570
diff changeset
    34
Double click the wifi-example-omnet.anf in the opened project and select 
04acce3f7133 Bug #645: fixes for opening stats file with OMNeT++
Andras Varga <andras@omnetpp.org>
parents: 3570
diff changeset
    35
the Chart page to see the created chart. Experiment with the analysis tool and read its
04acce3f7133 Bug #645: fixes for opening stats file with OMNeT++
Andras Varga <andras@omnetpp.org>
parents: 3570
diff changeset
    36
documentation: http://omnetpp.org/doc/omnetpp40/userguide/ch09.html