Explicitly state that YansWifiHelper::AddPropagationLoss may not be commutative
authorQuincy Tse <quincy.tse@gmail.com>
Wed, 01 Dec 2010 08:01:24 -0800
changeset 6672 53d7c5aaa720
parent 6671 b3d5193a2f94
child 6673 ec22aa763e2d
child 6704 de8a506b7437
Explicitly state that YansWifiHelper::AddPropagationLoss may not be commutative
src/helper/yans-wifi-helper.h
--- a/src/helper/yans-wifi-helper.h	Sat Nov 27 14:29:45 2010 +0000
+++ b/src/helper/yans-wifi-helper.h	Wed Dec 01 08:01:24 2010 -0800
@@ -73,6 +73,11 @@
    * Add a propagation loss model to the set of currently-configured loss models.
    * This method is additive to allow you to construct complex propagation loss models
    * such as a log distance + jakes model, etc.
+   *
+   * The order in which PropagationLossModels are added may be significant. Some
+   * propagation models are dependent of the "txPower" (eg. Nakagami model), and
+   * are therefore not commutative. The final receive power (excluding receiver
+   * gains) are calculated in the order the models are added.
    */
   void AddPropagationLoss (std::string name,
 			   std::string n0 = "", const AttributeValue &v0 = EmptyAttributeValue (),