task-3261/README

   1 What fraction of our bridges are not reporting usage statistics?
   2 ================================================================
   3
   4 Usage:
   5
   6 1. Put metrics tarballs into a directory called in/.  The best parsing
   7    performance can be achieved by decompressing tarballs without
   8    extracting them.  The bridge-descriptors-* and consensuses-* tarballs
   9    are required for this analysis.
  10
  11 2. Clone metrics-lib.git, build descriptor.jar, and put it in this
  12    directory.
  13
  14 3. Download Apache Commons Codec and Compress and put the .jar files in
  15    this directory.
  16
  17 4. Parse descriptors and write all relevant parts to one file per bridge:
  18    $ javac
  19        -cp commons-codec-1.4.jar:commons-compress-1.3.jar:descriptor.jar
  20        ExtractDescriptorParts.java
  21    $ java
  22        -cp commons-codec-1.4.jar:commons-compress-1.3.jar:descriptor.jar:.
  23        ExtractDescriptorParts
  24
  25 5. Analyze descriptors parts bridge by bridge and determine whether it
  26    reported bridge stats at a given time, and if not, find out why not:
  27    $ javac AnalyzeDescriptorParts.java
  28    $ java AnalyzeDescriptorParts
  29
  30 6. Aggregate daily statistics that can be plotted:
  31    $ javac AggregateStats.java
  32    $ java AggregateStats
  33
  34 7. Plot results:
  35    $ R --slave -f plot.R
  36