examples: Adding new example to illustrate use of L2Tracer to trace aggregate packet drop rate on nodes
diff --git a/docs/source/_static/l2-rate-tracer.png b/docs/source/_static/l2-rate-tracer.png
new file mode 100644
index 0000000..c930bd4
--- /dev/null
+++ b/docs/source/_static/l2-rate-tracer.png
Binary files differ
diff --git a/docs/source/_static/topo-tree-25-node.png b/docs/source/_static/topo-tree-25-node.png
new file mode 100644
index 0000000..ba39687
--- /dev/null
+++ b/docs/source/_static/topo-tree-25-node.png
Binary files differ
diff --git a/examples/ndn-tree-with-l2tracer.cc b/examples/ndn-tree-with-l2tracer.cc
new file mode 100644
index 0000000..d3e262e
--- /dev/null
+++ b/examples/ndn-tree-with-l2tracer.cc
@@ -0,0 +1,145 @@
+// ndn-simple-withl2tracer.cc
+
+#include "ns3/core-module.h"
+#include "ns3/network-module.h"
+#include "ns3/ndnSIM-module.h"
+
+// for ndn::L2RateTracer
+#include <ns3/ndnSIM/utils/tracers/l2-rate-tracer.h>
+
+using namespace ns3;
+
+int
+main (int argc, char *argv[])
+{
+  CommandLine cmd;
+  cmd.Parse (argc, argv);
+
+  AnnotatedTopologyReader topologyReader ("", 10);
+  topologyReader.SetFileName ("src/ndnSIM/examples/topologies/topo-tree-25-node.txt");
+  topologyReader.Read ();
+  
+  /****************************************************************************/
+  // Install CCNx stack on all nodes
+  ndn::StackHelper ccnxHelper;
+  ccnxHelper.SetContentStore ("ns3::ndn::cs::Lru", "MaxSize", "1000");
+  ccnxHelper.SetForwardingStrategy ("ns3::ndn::fw::BestRoute");
+  ccnxHelper.InstallAll ();
+  /****************************************************************************/
+  // Installing global routing interface on all nodes
+  ndn::GlobalRoutingHelper ccnxGlobalRoutingHelper;
+  ccnxGlobalRoutingHelper.InstallAll ();
+  /****************************************************************************/
+  // Getting containers for the consumer/producer
+  Ptr<Node> consumer1 = Names::Find<Node> ("Src1");
+  Ptr<Node> consumer2 = Names::Find<Node> ("Src2");
+  Ptr<Node> consumer3 = Names::Find<Node> ("Src3");
+  Ptr<Node> consumer4 = Names::Find<Node> ("Src4");
+  Ptr<Node> consumer5 = Names::Find<Node> ("Src5");
+  Ptr<Node> consumer6 = Names::Find<Node> ("Src6");
+  Ptr<Node> consumer7 = Names::Find<Node> ("Src7");
+  Ptr<Node> consumer8 = Names::Find<Node> ("Src8");
+  Ptr<Node> consumer9 = Names::Find<Node> ("Src9");
+
+  Ptr<Node> producer1 = Names::Find<Node> ("Dst1");
+  Ptr<Node> producer2 = Names::Find<Node> ("Dst2");
+  Ptr<Node> producer3 = Names::Find<Node> ("Dst3");
+  Ptr<Node> producer4 = Names::Find<Node> ("Dst4");
+  Ptr<Node> producer5 = Names::Find<Node> ("Dst5");
+  Ptr<Node> producer6 = Names::Find<Node> ("Dst6");
+  Ptr<Node> producer7 = Names::Find<Node> ("Dst7");
+  Ptr<Node> producer8 = Names::Find<Node> ("Dst8");
+  Ptr<Node> producer9 = Names::Find<Node> ("Dst9");
+  /****************************************************************************/
+  ndn::AppHelper consumerHelper ("ns3::ndn::ConsumerCbr");
+  consumerHelper.SetAttribute ("Frequency", StringValue ("1000"));//interests per Second
+  consumerHelper.SetAttribute ("Randomize", StringValue ("uniform"));
+  /****************************************************************************/
+  // on the first to ninth consumer node install a Consumer application
+  // that will express interests in /dst1 to /dst9 namespace
+  consumerHelper.SetPrefix ("/dst9");
+  consumerHelper.Install (consumer1);
+
+  consumerHelper.SetPrefix ("/dst8");
+  consumerHelper.Install (consumer2);
+
+  consumerHelper.SetPrefix ("/dst7");
+  consumerHelper.Install (consumer3);
+
+  consumerHelper.SetPrefix ("/dst6");
+  consumerHelper.Install (consumer4);
+
+  consumerHelper.SetPrefix ("/dst5");
+  consumerHelper.Install (consumer5);
+
+  consumerHelper.SetPrefix ("/dst4");
+  consumerHelper.Install (consumer6);
+
+  consumerHelper.SetPrefix ("/dst3");
+  consumerHelper.Install (consumer7);
+
+  consumerHelper.SetPrefix ("/dst2");
+  consumerHelper.Install (consumer8);
+
+  consumerHelper.SetPrefix ("/dst1");
+  consumerHelper.Install (consumer9);
+  
+  /****************************************************************************/
+  ndn::AppHelper producerHelper ("ns3::ndn::Producer");
+  producerHelper.SetAttribute ("PayloadSize", StringValue("1024"));
+  /****************************************************************************/
+  // Register /dst1 to /dst9 prefix with global routing controller and
+  // install producer that will satisfy Interests in /dst1 to /dst9 namespace
+  ccnxGlobalRoutingHelper.AddOrigins ("/dst1", producer1);
+  producerHelper.SetPrefix ("/dst1");
+  producerHelper.Install (producer1);
+
+  ccnxGlobalRoutingHelper.AddOrigins ("/dst2", producer2);
+  producerHelper.SetPrefix ("/dst2");
+  producerHelper.Install (producer2);
+
+  ccnxGlobalRoutingHelper.AddOrigins ("/dst3", producer3);
+  producerHelper.SetPrefix ("/dst3");
+  producerHelper.Install (producer3);
+
+  ccnxGlobalRoutingHelper.AddOrigins ("/dst4", producer4);
+  producerHelper.SetPrefix ("/dst4");
+  producerHelper.Install (producer4);
+
+  ccnxGlobalRoutingHelper.AddOrigins ("/dst5", producer5);
+  producerHelper.SetPrefix ("/dst5");
+  producerHelper.Install (producer5);
+
+  ccnxGlobalRoutingHelper.AddOrigins ("/dst6", producer6);
+  producerHelper.SetPrefix ("/dst6");
+  producerHelper.Install (producer6);
+
+  ccnxGlobalRoutingHelper.AddOrigins ("/dst7", producer7);
+  producerHelper.SetPrefix ("/dst7");
+  producerHelper.Install (producer7);
+
+  ccnxGlobalRoutingHelper.AddOrigins ("/dst8", producer8);
+  producerHelper.SetPrefix ("/dst8");
+  producerHelper.Install (producer8);
+
+  ccnxGlobalRoutingHelper.AddOrigins ("/dst9", producer9);
+  producerHelper.SetPrefix ("/dst9");
+  producerHelper.Install (producer9);
+
+  /*****************************************************************************/
+  // Calculate and install FIBs
+  ccnxGlobalRoutingHelper.CalculateRoutes ();
+
+  Simulator::Stop (Seconds (10.0));
+
+  /****************************************************************************/
+  //Tracer:
+
+  boost::tuple< boost::shared_ptr<std::ostream>, std::list<Ptr<L2RateTracer> > >
+   l2tracers = L2RateTracer::InstallAll ("drop-trace.txt", Seconds (0.5));
+
+  Simulator::Run ();
+  Simulator::Destroy ();
+
+  return 0;
+}
diff --git a/examples/topologies/topo-tree-25-node.txt b/examples/topologies/topo-tree-25-node.txt
new file mode 100644
index 0000000..7b328f4
--- /dev/null
+++ b/examples/topologies/topo-tree-25-node.txt
@@ -0,0 +1,58 @@
+#Topology.Scenario3.txt
+
+router
+
+# node   comment  yPos    xPos
+Rtr1     NA        3        9
+Rtr2     NA        9        9
+Rtr3     NA        15       9
+Rtr7     NA        9        15
+Rtr4     NA        3        21
+Rtr5     NA        9        21
+Rtr6     NA        15       21
+Src1     NA        1        3
+Src2     NA        3        3
+Src3     NA        5        3
+Src4     NA        7        3
+Src5     NA        9        3
+Src6     NA        11       3
+Src7     NA        13       3
+Src8     NA        15       3
+Src9     NA        17       3
+Dst1     NA        1        27
+Dst2     NA        3        27
+Dst3     NA        5        27
+Dst4     NA        7        27
+Dst5     NA        9        27
+Dst6     NA        11       27
+Dst7     NA        13       27
+Dst8     NA        15       27
+Dst9     NA        17       27
+
+link
+# srcNode   dstNode     bandwidth   metric    delay   queue
+Src1        Rtr1        100Mbps      1        10ms     10
+Src2        Rtr1        100Mbps      1        10ms     10
+Src3        Rtr1        100Mbps      1        10ms     10
+Src4        Rtr2        100Mbps      1        10ms     10
+Src5        Rtr2        100Mbps      1        10ms     10
+Src6        Rtr2        100Mbps      1        10ms     10
+Src7        Rtr3        100Mbps      1        10ms     10
+Src8        Rtr3        100Mbps      1        10ms     10
+Src9        Rtr3        100Mbps      1        10ms     10
+Rtr1        Rtr7        10Mbps       1        10ms     10
+Rtr2        Rtr7        10Mbps       1        10ms     10
+Rtr3        Rtr7        10Mbps       1        10ms     10
+Rtr4        Rtr7        10Mbps       1        10ms     10
+Rtr5        Rtr7        10Mbps       1        10ms     10
+Rtr6        Rtr7        10Mbps       1        10ms     10
+Dst1        Rtr4        100Mbps      1        10ms     10
+Dst2        Rtr4        100Mbps      1        10ms     10
+Dst3        Rtr4        100Mbps      1        10ms     10
+Dst4        Rtr5        100Mbps      1        10ms     10
+Dst5        Rtr5        100Mbps      1        10ms     10
+Dst6        Rtr5        100Mbps      1        10ms     10
+Dst7        Rtr6        100Mbps      1        10ms     10
+Dst8        Rtr6        100Mbps      1        10ms     10
+Dst9        Rtr6        100Mbps      1        10ms     10
+