Skip to content
This repository was archived by the owner on Feb 3, 2023. It is now read-only.

Commit 5362496

Browse files
authored
Minor Changes to readme.md
2 parents 4084f4a + 62cc06d commit 5362496

File tree

2 files changed

+23
-13
lines changed

2 files changed

+23
-13
lines changed

README.md

Lines changed: 23 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -1,14 +1,17 @@
11
# Misbehaviour Prediction for Autonomous Driving Systems
22

3-
This repository contains the code attached to the paper "Misbehaviour Prediction for Autonomous Driving Systems" by A. Stocco, M. Weiss, M. Calzana, P. Tonella, to be published in the proceedings of the 42nd International Conference in Software Engineering (ICSE 2020).
4-
See LICENSE.md for more information if you want to use the code.
3+
This repository contains the code attached to the paper "Misbehaviour Prediction for Autonomous Driving Systems"
4+
by A. Stocco, M. Weiss, M. Calzana, P. Tonella, to be published in the proceedings of the 42nd International Conference in Software Engineering (ICSE 2020).
55

6+
A preprint of the paper can be found on [arXiv](https://arxiv.org/abs/1910.04443).
67
## Dependencies
78

89
**Software setup:**
910
We adopted the [PyCharm](https://www.jetbrains.com/pycharm/) Professional 2019.3.1, a Python IDE by JetBrains.
1011

11-
If you have [anaconda](https://www.continuum.io/downloads) or [miniconda](https://conda.io/miniconda.html) installed on your machine, you can create and install all dependencies on a dedicated virtual environment, by running the following command:
12+
If you have [anaconda](https://www.continuum.io/downloads) or [miniconda](https://conda.io/miniconda.html)
13+
installed on your machine, you can create and install all dependencies on a dedicated virtual environment,
14+
by running the following command:
1215

1316
```python
1417
# Use TensorFlow with GPU
@@ -17,7 +20,9 @@ conda env create -f code-sdc/conda-env.yml
1720

1821
Alternatively you can manually install the required libraries (see the contents of the conda-env.yml files) using ```pip```.
1922

20-
**Hardware setup:** Training the DNN models (self-driving cars and anomaly detectors) on our datasets is computationally expensive. Therefore we recommend using a machine powered by a GPU. In our setting, we ran our experiments on a machine equipped with a i9 processor, 32 GB of memory, and an Nvidia GPU GeForce RTX 2080 Ti with 11GB of dedicated memory.
23+
**Hardware setup:** Training the DNN models (self-driving cars and anomaly detectors) on our datasets is computationally expensive.
24+
Therefore we recommend using a machine powered by a GPU.
25+
In our setting, we ran our experiments on a machine equipped with a i9 processor, 32 GB of memory, and an Nvidia GPU GeForce RTX 2080 Ti with 11GB of dedicated memory.
2126

2227
## Repository Structure
2328

@@ -28,18 +33,22 @@ The repository is structured as follows:
2833
| This folder contains all the code to run the training and evaluation of the misbehavior predictors.
2934
- code-sdc
3035
| This folder contains all the code to train the self-driving car models and record them when they are driving.
31-
- evaluation-results
32-
| This folder contains sqlite databases containing the results of our evaluation
3336
</pre>
3437

3538
### Other Artefacts
3639

37-
We made the following artifacts available as a torrent file [here](https://academictorrents.com/details/221c3c71ac0b09b1bb31698534d50168dc394cc7). The files have a combined size of 24.9 GB, and the torrent contains:
40+
We made the following artifacts available as a torrent file [here](https://academictorrents.com/details/221c3c71ac0b09b1bb31698534d50168dc394cc7). The files have a combined size of 25 GB (compressed: 7.93 GB) , and the torrent contains:
3841

42+
<pre/>
3943
- Trained SDC Models
44+
| Contains the weights of the trained self driving car models.
4045
- Trained Failure Predictor Models
41-
- Training Dataset
42-
- Evaluation Dataset
46+
| Contains the weights of the failure predictor models (i.e., the autoencoders and the deeproad pca).
47+
- Training Dataset & Evaluation Dataset
48+
| These folders contain the datasets of images used for training and evaluation.
49+
- Evaluation Results
50+
| This folders contains the sqlite databases containing the results of the evaluation.
51+
</pre>
4352

4453
## Usage
4554

@@ -96,7 +105,8 @@ Our improved Udacity simulator is available as binary file for Windows and macOS
96105

97106
## Reference
98107

99-
If use our work in your research, or it helps it, or if you simply like it, please cite SelfOracle in your publications. Here is an example BibTeX entry:
108+
If use our work in your research, or it helps it, or if you simply like it, please cite SelfOracle in your publications.
109+
Here is an example BibTeX entry:
100110

101111
```
102112
@inproceedings{2020-icse-misbehaviour-prediction,
@@ -111,8 +121,9 @@ If use our work in your research, or it helps it, or if you simply like it, plea
111121
```
112122

113123
## License
114-
See the [LICENSE.md](https://github.com/testingautomated-usi/selforacle/blob/master/LICENSE.md) file.
124+
MIT. See the [LICENSE.md](https://github.com/testingautomated-usi/selforacle/blob/master/LICENSE.md) file.
115125

116126
## Contacts
117127

118-
For any questions, feel free to contact Andrea Stocco ([[email protected]](mailto:[email protected])) or Michael Weiss ([[email protected]](mailto:[email protected])).
128+
For any questions, feel free to contact Andrea Stocco ([[email protected]](mailto:[email protected]))
129+
or Michael Weiss ([[email protected]](mailto:[email protected])).

evaluation-results/README.txt

Lines changed: 0 additions & 1 deletion
This file was deleted.

0 commit comments

Comments
 (0)