You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: README.md
+12-16Lines changed: 12 additions & 16 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -12,51 +12,47 @@ Nemesis contains implementations of the following attacks:
12
12
* Universal Perturbation ([Moosavi-Dezfooli et al., 2016](https://arxiv.org/abs/1610.08401))
13
13
* Virtual Adversarial Method ([Moosavi-Dezfooli et al., 2015](https://arxiv.org/abs/1507.00677))
14
14
* C&W Attack ([Carlini and Wagner, 2016](https://arxiv.org/abs/1608.04644))
15
+
* NewtonFool ([Jang et al., 2017](http://doi.acm.org/10.1145/3134600.3134635))
15
16
16
17
The following defense methods are also supported:
17
18
* Feature squeezing ([Xu et al., 2017](http://arxiv.org/abs/1704.01155))
19
+
* Spatial smoothing ([Xu et al., 2017](http://arxiv.org/abs/1704.01155))
18
20
* Label smoothing (Warde-Farley and Goodfellow, 2016)
19
21
* Adversarial training ([Szegedy et al., 2013](http://arxiv.org/abs/1312.6199))
20
22
* Virtual adversarial training ([Miyato et al., 2017](https://arxiv.org/abs/1704.03976))
21
23
22
24
## Setup
23
25
24
-
### Requirements
25
-
26
26
Nemesis is designed to run with Python 3 (and most likely Python 2 with small changes). You can either download the source code of Nemesis or clone the repository in your directory of choice:
To install the project dependencies, use the requirements file:
32
32
```bash
33
-
pip install -r requirements.txt
33
+
pip install .
34
34
```
35
35
36
-
You will additionally need to download [Cleverhans](https://github.com/tensorflow/cleverhans).
37
-
38
-
### Installation
36
+
The library comes with a basic set of unit tests. To check your install, you can run all the unit tests by calling in the Nemesis folder:
37
+
```bash
38
+
bash run_tests.sh
39
+
```
39
40
40
-
Nemesis is linked against Cleverhans through the configuration file `config/config.ini`. When installing Nemesis on your local machine, you need to set the appropriate paths and the `LOCAL` configuration profile as follows:
41
+
The configuration file `config/config.ini` allows to set custom paths for data. By default, data is downloaded in the `nemesis/data` folder as follows:
41
42
42
43
```text
43
44
[DEFAULT]
44
45
profile=LOCAL
45
46
46
47
[LOCAL]
47
-
data_path=/local/path/here
48
-
mnist_path=/local/path/here
49
-
cifar10_path=/local/path/here
50
-
stl10_path=/local/path/here
51
-
cleverhans_path=/local/path/here
48
+
data_path=./data
49
+
mnist_path=./data/mnist
50
+
cifar10_path=./data/cifar-10
51
+
stl10_path=./data/stl-10
52
52
```
53
53
54
54
If the datasets are not present at the indicated path, loading them will also download the data.
55
55
56
-
The library comes with a basic set of unit tests. To check that the installation has succeeded, you can run all the unit tests by calling in the Nemesis folder:
0 commit comments