-
Notifications
You must be signed in to change notification settings - Fork 2
/
Copy pathREADME.md.txt
104 lines (56 loc) · 11.1 KB
/
README.md.txt
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
# Robust dual-tone multi-frequency tone detection using k-nearest neighbour classifier for a noisy environment
Link to publication - https://doi.org/10.1108/ACI-10-2020-0105
**NOTE:**
- The entire modelling, simulation and analysis has been done on MATLAB R2019b environment and the code is not backwards-compatible with older versions of MATLAB due to the usage of the novel functions which have been added only in this version such as 'audioDataAugmenter' and 'audioDatastore' which are part of the 'Machine Learning and Deep Learning for Audio Toolbox'.
- The following instructions will be given in the same order as the proposed methodology of the project, i.e. data acquisition, data augmentation, data exploration followed by modelling of all the KNN classifier models (A, B, C, D, E and F).
**INSTRUCTIONS:**
_Data Acquisition: (All files are inside 'Data Handling' folder)_
1. The dataset used for the KNN models A, B and C were acquired through repetitive downloading of dual-tone audio files from the website 'audiocheck.net' using a selenium script written on python. This python script is named ' **autodownload\_dtmftones.py'**. Upon execution, the script starts downloading all 2032 files serially in the default downloads folder of the browser.
**NOTE:** The file directory for the web - driver needs to be changed according to the file location of the user's default web browser application.
2. All files are downloaded with their filenames in accordance with the nomenclature of 'audiocheck.net'. In order to rename the files to a more legible format, run ' **rename\_for\_dataset.m'**. This is a MATLAB code which simply renames all files into this format 'lower_freq'+'higher_freq'_'index number'.wav. Ex. '770+1336_522.wav'
**NOTE:** The 'source' and 'destination' variables need to be changed to the required source (browser's download folder) and destination file path according to the user's computer. **The above codes have been executed and the files have already been downloaded, renamed and stored under the folder 'dataset'.**
_Data Augmentation: (All files are inside 'Data Handling' folder)_
1. The augmented dataset required for training KNN models D, E and F as well as for testing all KNN models is created through the MATLAB code named ' **augmented\_dataset\_create.m'**.
**NOTE:** The variable 'data\_loc' needs to be changed to the file path of the originally downloaded dataset and the variable 'augmented\_dataset\_loc' needs to be changed to the required file path of the augmented dataset. **The above code has been executed and the augmented dataset is already stored in the folder named 'augmented\_dataset'.**
_Data Exploration: (All files are inside 'Data Exploration' folder)_
1. In order to plot the melspectrogram of various audio files to visually identify if MFCCs are viable features, ' **plot\_melspec.m**' MATLAB code is executed.
**NOTE:** The value of the variable 'dest' must be changed to the names of the audio files whose melspectrogram is required to be plotted. The value of the variable 'prefix' needs to be changed to the file path of the dataset folder containing the audio files.
1. In order to plot the DFT coefficients values using Goertzel's algorithm to visually identify if they are viable features, ' **plot\_goertzel.m**' MATLAB code is executed.
**NOTE:** The value of the variable 'loc' must be changed to the file path pf the audio file whose plot is to be constructed.
_KNN Classifier Modelling:_
_KNN Model A: (All files are inside 'KNN MODEL A' folder)_
1. In order to extract relevant features to train KNN Model A, ' **data\_prep\_features\_extract\_without\_da\_mfcc.m**' MATLAB code is executed.
**NOTE:** The value of the variable 'finaldataset\_loc' must be changed to file path of audio file dataset downloaded using 'autodownload\_dtmftones.py' which is basically the folder named 'dataset' and has been provided.
1. In order to train KNN classifier Model A using features computed from the above-mentioned code, ' **KNN\_classifier\_without\_DA\_mfcc.m**' MATLAB code is executed.The code trains the model and then prints the 5-fold stratified cross validation accuracy and then plots the confusion charts for Validation and Testing Accuracy.
2. In order to test the model using real-world imitating augmented dataset, ' **test\_accuracy\_augmented\_data.m**' MATLAB code is executed to feed the augmented testing dataset to the model and plot the resulting confusion chart.
**NOTE:** The value of the variable 'augmented\_dataset\_loc' must be changed to the file path of the augmented dataset folder which is basically the folder named 'augmented\_dataset' and has been provided.
1. The MATLAB codes named ' **HelperComputePitchAndMFCC.m**' and ' **HelperTestKNNClassifier.m**' are helper functions and do not need to be explicitly executed. They are automatically invoked from the main MATLAB codes mentioned above.
_KNN Model B: (All files are inside 'KNN MODEL B' folder)_
1. In order to extract relevant features to train KNN Model B, ' **data\_prep\_features\_extract\_without\_da\_g\_without\_sh.m**' MATLAB code is executed.
**NOTE:** The value of the variable 'finaldataset\_loc' must be changed to file path of audio file dataset downloaded using 'autodownload\_dtmftones.py' which is basically the folder named 'dataset' and has been provided.
1. In order to train KNN classifier Model B using features computed from the above-mentioned code, ' **KNN\_classifier\_without\_DA\_g\_without\_sh.m**' MATLAB code is executed.The code trains the model and then prints the 5-fold stratified cross validation accuracy and then plots the confusion charts for Validation and Testing Accuracy.
2. In order to test the model using real-world imitating augmented dataset, ' **test\_accuracy\_augmented\_data.m**' MATLAB code is executed to feed the augmented testing dataset to the model and plot the resulting confusion chart.
**NOTE:** The value of the variable 'augmented\_dataset\_loc' must be changed to the file path of the augmented dataset folder which is basically the folder named 'augmented\_dataset' and has been provided.
1. The MATLAB codes named ' **HelperComputeGoertzelFreq.m**' and ' **HelperTestKNNClassifier.m**' are helper functions and do not need to be explicitly executed. They are automatically invoked from the main MATLAB codes mentioned above.
_KNN Model C: (All files are inside 'KNN MODEL C' folder)_
1. In order to extract relevant features to train KNN Model C, ' **data\_prep\_features\_extract\_without\_da\_g\_with\_sh.m**'MATLAB code is executed.
**NOTE:** The value of the variable 'finaldataset\_loc' must be changed to file path of audio file dataset downloaded using 'autodownload\_dtmftones.py' which is basically the folder named 'dataset' and has been provided.
1. In order to train KNN classifier Model C using features computed from the above-mentioned code, ' **KNN\_classifier\_without\_DA\_g\_with\_sh.m**' MATLAB code is executed.The code trains the model and then prints the 5-fold stratified cross validation accuracy and then plots the confusion charts for Validation and Testing Accuracy.
2. In order to test the model using real-world imitating augmented dataset, ' **test\_accuracy\_augmented\_data.m**' MATLAB code is executed to feed the augmented testing dataset to the model and plot the resulting confusion chart.
**NOTE:** The value of the variable 'augmented\_dataset\_loc' must be changed to the file path of the augmented dataset folder which is basically the folder named 'augmented\_dataset' and has been provided.
1. The MATLAB codes named ' **HelperComputeGoertzelFreq.m**' and ' **HelperTestKNNClassifier.m**' are helper functions and do not need to be explicitly executed. They are automatically invoked from the main MATLAB codes mentioned above.
_KNN Model D: (All files are inside 'KNN MODEL D' folder)_
1. In order to extract relevant features to train KNN Model D, ' **data\_prep\_features\_extract\_with\_da\_mfcc.m**' MATLAB code is executed.
**NOTE:** The value of the variable 'augmented\_dataset\_loc' must be changed to file path of augmented audio file dataset which is basically the folder named 'augmented\_dataset' and has been provided.
1. In order to train KNN classifier Model D using features computed from the above-mentioned code, ' **KNN\_classifier\_with\_DA\_mfcc.m**' MATLAB code is executed.The code trains the model and then prints the 5-fold stratified cross validation accuracy and then plots the confusion charts for Validation and Testing Accuracy.
2. The MATLAB codes named ' **HelperComputePitchAndMFCC.m**' and ' **HelperTestKNNClassifier.m**' are helper functions and do not need to be explicitly executed. They are automatically invoked from the main MATLAB codes mentioned above.
_KNN Model E: (All files are inside 'KNN MODEL E' folder)_
1. In order to extract relevant features to train KNN Model E, ' **data\_prep\_features\_extract\_with\_da\_g\_without\_sh.m**' MATLAB code is executed.
**NOTE:** The value of the variable 'augmented\_dataset\_loc' must be changed to file path of augmented audio file dataset which is basically the folder named 'augmented\_dataset' and has been provided.
1. In order to train KNN classifier Model E using features computed from the above-mentioned code, ' **KNN\_classifier\_with\_DA\_mfcc.m**' MATLAB code is executed.The code trains the model and then prints the 5-fold stratified cross validation accuracy and then plots the confusion charts for Validation and Testing Accuracy.
2. The MATLAB codes named ' **HelperComputeGoertzelFreq.m**' and ' **HelperTestKNNClassifier.m**' are helper functions and do not need to be explicitly executed. They are automatically invoked from the main MATLAB codes mentioned above.
_KNN Model F: (All files are inside 'KNN MODEL F' folder)_
1. In order to extract relevant features to train KNN Model F, ' **data\_prep\_features\_extract\_with\_da\_g\_with\_sh.m**' MATLAB code is executed.
**NOTE:** The value of the variable 'augmented\_dataset\_loc' must be changed to file path of augmented audio file dataset which is basically the folder named 'augmented\_dataset' and has been provided.
1. In order to train KNN classifier Model F using features computed from the above-mentioned code, ' **KNN\_classifier\_with\_DA\_g\_with\_sh.m**' MATLAB code is executed.The code trains the model and then prints the 5-fold stratified cross validation accuracy and then plots the confusion charts for Validation and Testing Accuracy.
2. The MATLAB codes named ' **HelperComputeGoertzelFreq.m**' and ' **HelperTestKNNClassifier.m**' are helper functions and do not need to be explicitly executed. They are automatically invoked from the main MATLAB codes mentioned above.