OLD | NEW |
1 # APM Quality Assessment tool | 1 # APM Quality Assessment tool |
2 | 2 |
3 Python wrapper of `audioproc_f` with which quality assessment can be | 3 Python wrapper of `audioproc_f` with which quality assessment can be |
4 automatized. The tool allows to simulate different noise conditions, input | 4 automatized. The tool allows to simulate different noise conditions, input |
5 signals, APM configurations and it computes different scores. | 5 signals, APM configurations and it computes different scores. |
6 Once the scores are computed, the results can be easily exported to an HTML page | 6 Once the scores are computed, the results can be easily exported to an HTML page |
7 which allows to listen to the APM input and output signals and also the | 7 which allows to listen to the APM input and output signals and also the |
8 reference one used for evaluation. | 8 reference one used for evaluation. |
9 | 9 |
10 ## Dependencies | 10 ## Dependencies |
11 | 11 |
12 - OS: Linux | 12 - OS: Linux |
13 - Python 2.7 | 13 - Python 2.7 |
14 - Python libraries: numpy, scipy, pydub (0.17.0+) | 14 - Python libraries: numpy, scipy, pydub (0.17.0+) |
15 - `$ sudo apt install python-numpy python-scipy` | 15 - It is recommended that a dedicated Python environment is used |
16 - `$ sudo pip install pydub` | 16 - install `virtualenv` |
| 17 - `$ sudo apt-get install python-virtualenv` |
| 18 - setup a new Python environment (e.g., `my_env`) |
| 19 - `$ cd ~ && virtualenv my_env` |
| 20 - activate the new Python environment |
| 21 - `$ source ~/my_env/bin/activate` |
| 22 - add dependcies via `pip` |
| 23 - `(my_env)$ pip install numpy pydub scipy` |
17 - PolqaOem64 (see http://www.polqa.info/) | 24 - PolqaOem64 (see http://www.polqa.info/) |
18 - Tested with POLQA Library v1.180 / P863 v2.400 | 25 - Tested with POLQA Library v1.180 / P863 v2.400 |
19 - Aachen Impulse Response (AIR) Database | 26 - Aachen Impulse Response (AIR) Database |
20 - Download https://www2.iks.rwth-aachen.de/air/air_database_release_1_4.zip | 27 - Download https://www2.iks.rwth-aachen.de/air/air_database_release_1_4.zip |
21 - Input probing signals and noise tracks (you can make your own dataset - *1) | 28 - Input probing signals and noise tracks (you can make your own dataset - *1) |
22 | 29 |
23 ## Build | 30 ## Build |
24 | 31 |
25 - Compile WebRTC | 32 - Compile WebRTC |
26 - Go to `out/Default/py_quality_assessment` and check that | 33 - Go to `out/Default/py_quality_assessment` and check that |
(...skipping 64 matching lines...) Expand 10 before | Expand all | Expand 10 after Loading... |
91 Depending on the license, the POLQA tool may take “breaks” as a way to limit the | 98 Depending on the license, the POLQA tool may take “breaks” as a way to limit the |
92 throughput. When this happens, the APM Quality Assessment tool is slowed down. | 99 throughput. When this happens, the APM Quality Assessment tool is slowed down. |
93 For more details about this limitation, check Section 10.9.1 in the POLQA manual | 100 For more details about this limitation, check Section 10.9.1 in the POLQA manual |
94 v.1.18. | 101 v.1.18. |
95 | 102 |
96 In case of issues with the POLQA score computation, check | 103 In case of issues with the POLQA score computation, check |
97 `py_quality_assessment/eval_scores.py` and adapt | 104 `py_quality_assessment/eval_scores.py` and adapt |
98 `PolqaScore._parse_output_file()`. | 105 `PolqaScore._parse_output_file()`. |
99 The code can be also fixed directly into the build directory (namely, | 106 The code can be also fixed directly into the build directory (namely, |
100 `out/Default/py_quality_assessment/eval_scores.py`). | 107 `out/Default/py_quality_assessment/eval_scores.py`). |
OLD | NEW |