Commit 78510d93 authored by Anika Treffehn's avatar Anika Treffehn
Browse files

added executable info in main README

parent b655e94b
Loading
Loading
Loading
Loading
Loading
+12 −18
Original line number Diff line number Diff line
@@ -472,28 +472,22 @@ The processing chain is as follows:
---
## ITU Tools

This module uses the ITU audio processing tools. These tools can be found here: https://github.com/openitu/STL (except for the filter binary which is deprecated). <br />
The filter binary with all necessary filter types can be found here: https://www.3gpp.org/ftp/tsg_sa/WG4_CODEC/TSGS4_76/docs/S4-131277.zip. <br />
It also makes use of the MASA tools provided by Nokia. These can be found here: https://www.3gpp.org/ftp/TSG_SA/WG4_CODEC/TSGS4_122_Athens/Docs/S4-230221.zip.

The following binaries/executables are needed for the different processing steps:

| processing step         			  | Exectuable      		  | Where to find |
|-------------------------------------|---------------------------|---------------|
| LP filtering           			  |    filter       		  |               |
| HP filtering          			  |    filter       		  |               |
| Resampling            			  |    filter       		  |               |
| Loudness adjustment   			  |    bs1770demo   		  |               |
| MNRU                  			  |    p50fbmnru			  |               |
| ESDRU                  			  |    esdru       			  |               |
| MASA rendering          		      |    masaRenderer			  |               |
| Frame error pattern generation      |    gen-patt    			  |               |
| Frame error pattern application     |    eid-xor     			  |               |
| Random seed generation for gen-patt |    random      			  |               |
| JBM error pattern generation        |    networkSimulator_g192  |               |
| Processing step                 | Executable            | Where to find                                                                                               |
|---------------------------------|-----------------------|-------------------------------------------------------------------------------------------------------------|
| Loudness adjustment             | bs1770demo            | https://github.com/openitu/STL                                                                              |
| MNRU                            | p50fbmnru             | https://github.com/openitu/STL                                                                              |
| ESDRU                           | esdru                 | https://github.com/openitu/STL                                                                              |
| Frame error pattern application | eid-xor               | https://github.com/openitu/STL                                                                              |
| Error pattern generation        | gen-patt              | https://www.itu.int/rec/T-REC-G.191-201003-S/en (Note: Version in https://github.com/openitu/STL is buggy!) |
| Filtering, Resampling           | filter                | https://www.3gpp.org/ftp/tsg_sa/WG4_CODEC/TSGS4_76/docs/S4-131277.zip                                       |
| Random offset/seed generation   | random                | https://www.3gpp.org/ftp/tsg_sa/WG4_CODEC/TSGS4_76/docs/S4-131277.zip                                       |
| JBM network similulator         | networkSimulator_g192 | https://www.3gpp.org/ftp/tsg_sa/WG4_CODEC/TSGS4_76/docs/S4-131277.zip                                       |
| MASA rendering                  | masaRenderer          | https://www.3gpp.org/ftp/TSG_SA/WG4_CODEC/TSGS4_122_Athens/Docs/S4-230221.zip                               |

The necessary binaries have to be placed in the [ivas_processing_scripts/bin](./ivas_processing_scripts/bin) folder.
For the ITU tools it is sufficient to copy the binaries while it is necessary to add some additional files for the MASA renderer.
For most of the tools it is sufficient to copy the binaries while it is necessary to add some additional files for the MASA renderer.

---