Commit d936bbd3 authored by Anika Treffehn's avatar Anika Treffehn
Browse files

Merge branch 'more_info_binaries_readme' into 'main' 

added info in readme

See merge request !28
parents df968add cefdc138

README.md

+15 −14
Original line number Diff line number Diff line
@@ -508,19 +508,20 @@ The processing chain is as follows: 
The following additional executables are needed for the different processing steps:



| Processing step                                 | Executable            | Where to find                                                                                               |

|---------------------------------|-----------------------|-------------------------------------------------------------------------------------------------------------|

| Loudness adjustment             | bs1770demo            | https://github.com/openitu/STL                                                                              |

|-------------------------------------------------|-----------------------|-------------------------------------------------------------------------------------------------------------|

| Loudness measurement and 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                                       |

| Random offset/seed generation (necessary for background noise and FER bitstream processing)   | random                | https://www.3gpp.org/ftp/tsg_sa/WG4_CODEC/TSGS4_76/docs/S4-131277.zip                                       |

| JBM network simulator                           | 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                               |

| MASA rendering (also used in loudness measurement of MASA items)        | 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 most of the tools it is sufficient to copy the binaries while it is necessary to add some additional files for the MASA renderer.

The necessary binaries have to be either placed in the [ivas_processing_scripts/bin](./ivas_processing_scripts/bin) folder or the path has to be specified in 

[ivas_processing_scripts/binary_paths.yml](./ivas_processing_scripts/binary_paths.yml).

For most of the tools it is sufficient to copy the binaries while it is necessary to add the associated *.bin files for the MASA renderer.



---

ivas_processing_scripts/bin/README.txt

+11 −11
Original line number Diff line number Diff line
@@ -2,13 +2,13 @@ 
Necessary additional executables:



| Processing step                                 | Executable            | Where to find                                                                                               |

|---------------------------------|-----------------------|-------------------------------------------------------------------------------------------------------------|

| Loudness adjustment             | bs1770demo            | https://github.com/openitu/STL                                                                              |

|-------------------------------------------------|-----------------------|-------------------------------------------------------------------------------------------------------------|

| Loudness measurement and 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                                       |

| Random offset/seed generation (necessary for background noise and FER bitstream processing)   | random                | https://www.3gpp.org/ftp/tsg_sa/WG4_CODEC/TSGS4_76/docs/S4-131277.zip                                       |

| JBM network simulator                           | 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                               |
 
| MASA rendering (also used in loudness measurement of MASA items)        | masaRenderer        | https://www.3gpp.org/ftp/TSG_SA/WG4_CODEC/TSGS4_122_Athens/Docs/S4-230221.zip         |