[tor-commits] [sbws/master] docs: explain how the generator works

juga at torproject.org juga at torproject.org
Sat Feb 23 10:57:25 UTC 2019

commit f1885b082361e4bc68db1301bb3a59d6b9eb9472
Author: juga0 <juga at riseup.net>
Date:   Thu Feb 7 12:26:07 2019 +0000

    docs: explain how the generator works
 docs/source/specification.rst | 15 +++++++++------
 1 file changed, 9 insertions(+), 6 deletions(-)

diff --git a/docs/source/specification.rst b/docs/source/specification.rst
index 06f1ca1..874adbc 100644
--- a/docs/source/specification.rst
+++ b/docs/source/specification.rst
@@ -175,13 +175,16 @@ The file is named with the current date. Every day a new file is created.
 Source code: :func:`sbws.lib.resultdump.ResultDump.enter`
-Every hour the directory authorities vote to come to a consensus about the
-state of the Tor network.  The bandwidth authorities need to use the results
-that have been gathered to inform their vote about relays' bandwidths. To do
-this they use sbws generate.
+Running the generator
-The relays' bandwidth measurements (``Results``) to be added to the Bandwidth
-File MUST be first selected and MUST be then then scaled.
+Every hour, the generator:
+#. Aggregate all the measurements (not older than 6 six days) for every relay.
+#. Filter the measurements
+#. Scale the measurements
+#. Write the bandwidth file
+Source code: :func:`sbws.lib.v3bwfile.V3BWFile.from_results`
 Selecting bandwidth measurements

More information about the tor-commits mailing list