more dox
authorMathieu Lacage <mathieu.lacage@sophia.inria.fr>
Thu, 19 Jul 2007 12:21:48 +0200
changeset 1634 2bf997301257
parent 1633 4d40e18b5ce3
child 1635 935bed1e13e7
more dox
src/node/random-direction-2d-mobility-model.cc
src/node/random-direction-2d-mobility-model.h
--- a/src/node/random-direction-2d-mobility-model.cc	Thu Jul 19 11:31:17 2007 +0200
+++ b/src/node/random-direction-2d-mobility-model.cc	Thu Jul 19 12:21:48 2007 +0200
@@ -28,11 +28,9 @@
 namespace ns3 {
 
 const double RandomDirection2dMobilityModel::PI = 3.1415;
-const InterfaceId RandomDirection2dMobilityModel::iid = 
-  MakeInterfaceId ("RandomDirection2dMobilityModel", MobilityModel::iid);
 const ClassId RandomDirection2dMobilityModel::cid = 
   MakeClassId<RandomDirection2dMobilityModel> ("RandomDirection2dMobilityModel",
-                                             RandomDirection2dMobilityModel::iid);
+                                               MobilityModel::iid);
 
 
 static RandomVariableDefaultValue 
--- a/src/node/random-direction-2d-mobility-model.h	Thu Jul 19 11:31:17 2007 +0200
+++ b/src/node/random-direction-2d-mobility-model.h	Thu Jul 19 12:21:48 2007 +0200
@@ -34,17 +34,37 @@
 
 class RandomVariable;
 
+/**
+ * \brief the parameters to control a RandomDirection mobility model.
+ */
 class RandomDirection2dParameters : public Object
 {
  public:
+  /**
+   * Create a default parameter object from Bind default values.
+   */
   RandomDirection2dParameters ();
+  /**
+   * \param bounds the 2d bounds of the mobility model
+   * \param speedVariable the random variable used to pick a random speed
+   * \param pauseVariable the random variable used to pick a random pause delay
+   */
   RandomDirection2dParameters (const Rectangle &bounds,
-			     const RandomVariable &speedVariable,
-			     const RandomVariable &pauseVariable);
+                               const RandomVariable &speedVariable,
+                               const RandomVariable &pauseVariable);
   virtual ~RandomDirection2dParameters ();
 
+  /**
+   * \param speedVariable the random variable used to pick a random speed.
+   */
   void SetSpeed (const RandomVariable &speedVariable);
+  /**
+   * \param pauseVariable the random variable used to pick a random pause delay.
+   */
   void SetPause (const RandomVariable &pauseVariable);
+  /**
+   * \param bounds the 2d bounds of the mobility model.
+   */
   void SetBounds (const Rectangle &bounds);
  private:
   friend class RandomDirection2dMobilityModel;
@@ -56,13 +76,28 @@
   RandomVariable *m_pauseVariable;
 };
 
+/**
+ * \brief a RandomDirection mobility model
+ *
+ * The movement of objects is based on random directions: each object
+ * pauses for a specific delay, chooses a random direction and speed and 
+ * then travels in the specific direction until it reaches one of
+ * the boundaries of the model. When it reaches the boundary, it pauses,
+ * selects a new direction and speed, aso.
+ */
 class RandomDirection2dMobilityModel : public MobilityModel
 {
  public:
-  static const InterfaceId iid;
   static const ClassId cid;
 
+  /**
+   * Create a RandomDirection model from the default Bind values.
+   */
   RandomDirection2dMobilityModel ();
+  /**
+   * \param parameters the parameters which control the behavior of the model.
+   * Create a RandomDirection model using the parameters specified.
+   */
   RandomDirection2dMobilityModel (Ptr<RandomDirection2dParameters> parameters);
  private:
   void Start (void);