|
|
@@ -212,10 +212,13 @@ Our entire artifact can be run with the `./run.sh` script, which accepts the fol
|
|
|
-s (Experiment 2) Run ./scripts/belarus.sh sequentially, instead of in parallel.
|
|
|
--fast (Experiment 2) Start with pre-processed data.
|
|
|
|
|
|
+This will run the scripts for both [Experiment 1](#experiment-1-lox-benchmarking) and [Experiment 2](#experiment-2-belarus-case-study), passing the arguments to those scripts as appropriate.
|
|
|
See [Experiment 1](#experiment-1-lox-benchmarking) for examples of using the `-n` and `-N` options.
|
|
|
This process should take around 1–2 hours and requires 20 GB of free disk space.
|
|
|
(`-s` or `--fast` will change the time and disk space requirements. See [Experiment 2](#experiment-2-belarus-case-study) for details.)
|
|
|
|
|
|
+Alternatively, the scripts for the experiments can be run individually, as documented in the experiment descriptions below.
|
|
|
+
|
|
|
#### Experiment 1: Lox Benchmarking
|
|
|
|
|
|
- Time: 1 human-minute + 5–20 compute-minutes
|
|
|
@@ -225,6 +228,8 @@ This process should take around 1–2 hours and requires 20 GB of free disk spac
|
|
|
./scripts/process-lox-results.sh
|
|
|
```
|
|
|
|
|
|
+(This will run only Experiment 1. Alternatively, you can run both Experiment 1 and [Experiment 2](#experiment-2-belarus-case-study) with the `./run.sh` script, as documented above.)
|
|
|
+
|
|
|
By default, the script will use all available threads (up to the number of processes to be run, which is 16), but you can use `-n NUM_PERFORMANCE_CORES` to restrict it to use only the first `NUM_PERFORMANCE_CORES` threads.
|
|
|
If these are not the ones you want to use, you can instead specify `-N PERFORMANCE_CORE_RANGE` to indicate the specific threads to use.
|
|
|
|
|
|
@@ -253,6 +258,8 @@ table-2-results.pdf and table-3-results.pdf can be used to verify Main Results [
|
|
|
./scripts/belarus.sh [-s|--fast]
|
|
|
```
|
|
|
|
|
|
+(This will run only Experiment 2. Alternatively, you can run both [Experiment 1](#experiment-1-lox-benchmarking) and Experiment 2 with the `./run.sh` script, as documented above.)
|
|
|
+
|
|
|
The recommended way to run this script is without any arguments.
|
|
|
It will download 8 bridge extra-info archives from the Tor Project for the period of July 2020–April 2021, extract and process this data to learn daily connection counts from Belarus for each bridge, then use Algorithms 1–3 to try to detect which bridges were blocked starting in late February 2021 and which were not.
|
|
|
This takes about 1 hour and requires 20 GB of storage.
|
