Ultra Wideband Impulse Radio MiXiM Simulation Model
---------------------------------------------------

This example illustrates the use of the IEEE 802.15.4A UWB-IR
simulation model implemented in MiXiM.
The omnetpp.ini files comprises two scenarios. Both scenarios
involve only two hosts.

The first scenario, named BERDistance, configures one host to
sends ($nbPackets) packets to the other. The distance ($distance)
between the two nodes is changed at each run. This is performed
for two channel models (Ghassemzadeh-LOS and NLOS) so that the
difference between a Line of Sight and a Non Line of Sight
environment can be seen. 

The second scenario is simpler. It only sends one packet at each
time, and iterates over five channel models: Ghassemzadeh-LOS, 
Ghassemzadeh-NLOS, CM1, CM2 and CM5.
It allows to see the simulator representation of the maximum
pulse amplitude over time, as modified by the various channel
models.

To run the scenarios, compile mixim, open a terminal and go to
examples/ieee80154a. There, type:
./runBERDistance.sh 
to execute all runs of the Bit Error Rate over Distance scenario.
The "run" script expects to find opp_run in the path. Thus, make sure 
to have $OMNET_PATH/bin in your path. 

You can also try:
./runChannelPlots.sh
to execute all runs of the channelPlots scenario.

The results can be analyzed from within Omnet++. In the
examples/ieee802154a directory, open the files BERDistance.anf
or channelPlots.anf (depending on the scenario that you ran before).
At the bottom of the window, switch from the Inputs tab to the Datasets
tab. In the BERDistance.anf file, you will find a "scatter chart BER_Distance"
item. Double-click on it to generate the graph.

In the channelPlots.anf file, there are several graphs. Opening
"line chart Ghassemzadeh LOS" will show the packet as modified by the 
Ghassemzadeh LOS channel model. Compare it with "line chart CM2" to see
the impact of the Power Delay Profile. By default, the view does not allow
to see the pulse shapes, because of the ultra short duration (2 ns per pulse).
Zoom repeatedly until you see a triangular shape, by holding down the "Ctrl"
touch and drawing a zoom box with the mouse around the area to enlarge.

For more information, please refer to:
* the Omnet++ documentation at www.omnetpp.org/documentation and the user guide.
* the MiXiM documentation
* UWB-IR NED modules documentation and source code.

Questions should be send to the Omnet++ mailing-list: omnetpp@googlegroups.com.

acknowledgment 
--------------
this work was supported (in part) by the National Competence
Center in Research on Mobile Information and Communication Systems
NCCR-MICS, a center supported by the Swiss National Science
Foundation under grant number 5005-67322.
 


