Просмотр исходного кода

Improve description of script with/without --fast flag

Vecna 1 месяц назад
Родитель
Сommit
799609848e
1 измененных файлов с 17 добавлено и 10 удалено
  1. 17 10
      README.md

+ 17 - 10
README.md

@@ -26,16 +26,23 @@ Dependencies:
 
 To reproduce our results, just run `./run.sh`. **This will take a long
 time (about 12.5 hours on my device) and require a few GB of free
-space.** The reason is that it needs to download all extra-info records
-for all bridges from 2020-07 to 2021-04 from the Tor Project's CollecTor
-service (734 MB compressed, about 20 GB uncompressed), extract that
-data, and obtain the needed information (bridge fingerprint, record
-date, and connection count from Belarus) from each record. There are A
-LOT of these records.
-
-If you want to avoid spending all the time to do that, you can run
-`./run.sh --fast`, which starts with a 6.7 MB archive (87 MB
-uncompressed) containing only the information we need.
+space.** The reason is that it downloads all extra-info records for all
+bridges from 2020-07 to 2021-04 from the Tor Project's CollecTor service
+(734 MB compressed, about 20 GB uncompressed), extract that data, and
+obtain the needed information (bridge fingerprint, record date, and
+connection count from Belarus) from each record. We reduce the disk
+space required by extracting only one archive at a time, then deleting
+the resulting files after processing. Nevertheless, there are A LOT of
+these records (about 4 million), and it takes a long time to process
+them all.
+
+Alternatively, you can run `./run.sh --fast`, which starts with a 6.7 MB
+archive (87 MB uncompressed) containing only the information we need.
+Thils is *much* faster (1-2 minutes on my device) and requires much less
+disk space (around 250 MB).
+
+Full results will be available in the `output` file, and the relevant
+summary will be printed to the console.
 
 ## Julian dates