modules/audio_processing/test/py_quality_assessment/README.md - Issue 3010413002: Total Harmonic Distorsion plus noise (THD+n) score in APM-QA.

Side by Side Diff: modules/audio_processing/test/py_quality_assessment/README.md

Issue 3010413002: Total Harmonic Distorsion plus noise (THD+n) score in APM-QA. (Closed)

Patch Set: merge Created 3 years, 2 months ago

Use n/p to move between diff chunks; N/P to move between comments. Draft comments are only viewable by you.

Jump to:

« no previous file with comments | « no previous file | modules/audio_processing/test/py_quality_assessment/quality_assessment/data_access.py » ('j') | no next file with comments »

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

(...skipping 15 matching lines...) Expand all Loading...
26 - Aachen Impulse Response (AIR) Database	26 - Aachen Impulse Response (AIR) Database

27 - 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

28 - 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)

29	29

30 ## Build	30 ## Build

31	31

32 - Compile WebRTC	32 - Compile WebRTC

33 - Go to `out/Default/py_quality_assessment` and check that	33 - Go to `out/Default/py_quality_assessment` and check that

34 `apm_quality_assessment.py` exists	34 `apm_quality_assessment.py` exists

35	35

	36 ## Unit tests

	37

	38 - Compile WebRTC

	39 - Go to `out/Default/py_quality_assessment`

	40 - Run `python -m unittest -p "*_unittest.py" discover`

	41

36 ## First time setup	42 ## First time setup

37	43

38 - Deploy PolqaOem64 and set the `POLQA_PATH` environment variable	44 - Deploy PolqaOem64 and set the `POLQA_PATH` environment variable

39 - e.g., `$ export POLQA_PATH=/var/opt/PolqaOem64`	45 - e.g., `$ export POLQA_PATH=/var/opt/PolqaOem64`

40 - Deploy the AIR Database and set the `AECHEN_IR_DATABASE_PATH` environment	46 - Deploy the AIR Database and set the `AECHEN_IR_DATABASE_PATH` environment

41 variable	47 variable

42 - e.g., `$ export AECHEN_IR_DATABASE_PATH=/var/opt/AIR_1_4`	48 - e.g., `$ export AECHEN_IR_DATABASE_PATH=/var/opt/AIR_1_4`

43 - Deploy probing signal tracks into	49 - Deploy probing signal tracks into

44 - `out/Default/py_quality_assessment/probing_signals` (*1)	50 - `out/Default/py_quality_assessment/probing_signals` (*1)

45 - Deploy noise tracks into	51 - Deploy noise tracks into

(...skipping 54 matching lines...) Expand 10 before \| Expand all \| Expand 10 after Loading...
100 Depending on the license, the POLQA tool may take “breaks” as a way to limit the	106 Depending on the license, the POLQA tool may take “breaks” as a way to limit the

101 throughput. When this happens, the APM Quality Assessment tool is slowed down.	107 throughput. When this happens, the APM Quality Assessment tool is slowed down.

102 For more details about this limitation, check Section 10.9.1 in the POLQA manual	108 For more details about this limitation, check Section 10.9.1 in the POLQA manual

103 v.1.18.	109 v.1.18.

104	110

105 In case of issues with the POLQA score computation, check	111 In case of issues with the POLQA score computation, check

106 `py_quality_assessment/eval_scores.py` and adapt	112 `py_quality_assessment/eval_scores.py` and adapt

107 `PolqaScore._parse_output_file()`.	113 `PolqaScore._parse_output_file()`.

108 The code can be also fixed directly into the build directory (namely,	114 The code can be also fixed directly into the build directory (namely,

109 `out/Default/py_quality_assessment/eval_scores.py`).	115 `out/Default/py_quality_assessment/eval_scores.py`).

OLD	NEW