README.md 3.06 KB
Newer Older
Pablo Aznar's avatar
Pablo Aznar committed
1
2
# SecureGrid

Pablo Aznar's avatar
Pablo Aznar committed
3
4
Deep Learning based Attack Detection System for Smart Grids

Carlos A. Iglesias's avatar
Carlos A. Iglesias committed
5
6
7
8
9
10
## Required modules
* Keras
* There is a recognized bug in numpy 1.16.3. Thus, the numpy version should be 1.16.1.
pip uninstall numpy
pip install --upgrade numpy==1.16.1

11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
# Mosaik
For running the demo number of packages are needed:
sudo apt-get install git python3-numpy python3-scipy python3-h5py

In addition, there is a bug in arrow in mosaik demo, so you should install the version arrow 0.14:
pip install arrow==0.14

Execute
python securegrid-demo.py
After finishing, you will have the simulation data in the file demo.hdf5
You can visualize this file with any hdf5 viewer. 
In our case, we are using ViTables (http://vitables.org/Download/).

If you desire to install it, follow the installation instructions.
The suggested process is:
apt install libhdf5-dev
pip install pyqt5
pip install vitables

Then execute 'vitables' in a terminal.

If you wish to visualize the scenario, you can install maverig: https://bitbucket.org/mosaik/maverig/src/master/. Basically
pip install maverig

Pablo Aznar's avatar
Pablo Aznar committed
35
36
37
38
## Usage

In order to detect attacks, the power consumption values of the houses are analyzed. For that reason, first, the needed DataFrames to feed the neural network (autoencoder) have to be created.

39

Pablo Aznar's avatar
Pablo Aznar committed
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
For this purpose, the notebook dataframe_creation is used. This notebook generates .pkl files that contain the DataFrames with the necessary data. In addition, these DataFrames contain the following features:

| Feature  | Description |
| ------------- | ------------- |
| Day  | Current day of the first window value  |
| Hour  | Current hour of the first window value  |
| Minute  | Current minute of the first window value  |
| Pn  | Power consumption window values  |
| Mean  | Mean of the window values  |
| Mean_i - Mean_i-1  | Difference between the mean of the window values and the mean of the previous window values  |
| s  | Standard deviation of the window values |
| Pn - P1  | Difference between the last and first value of the window  |
| Q1  | First quartile of the window values  |
| Q2  | Median of the window values  |
| Q3  | Third quartile of the window values  |
| IQR  | Interquartile range of the window values  |

57
58
59
60
For executing the dataframe, it is needed to install the package h5py

pip install h5py
	
Pablo Aznar's avatar
Pablo Aznar committed
61
62
63
64
65
66
67
68
69
70
71
72
73
Once the DataFrames are created, they are used to feed the autoencoder. Therefore, the conv1d_autoencoder.py file has to be configured.

The normal_data_path variable has to contain the path to the .pkl file that contains data without attacks, that is to say, a normal behaviour of the houses. In addition, the attack_data_path variable has to contain the path to the .pkl file that contains the data that is wanted to be analyzed in order to detect attacks.

Furthermore, in order to train the autoencoder, the DO_TRAINING variable has to be set to True.

Finally, the following command executes the system:

	$ python conv1d_autoencoder.py

## Results

Once the system is executed, it generates the predicted_labels.csv file that contains the labels that classify every entry of the DataFrame into attack (1) or normal behaviour (0).