Skip to content

Commit 54a9d82

Browse files
author
Malfait, Ludovic
committed
[G191] Updated text of the Recommendation with P.50 FB MNRU and WMC Tool information.
1 parent 8f96984 commit 54a9d82

File tree

2 files changed

+52
-31
lines changed

2 files changed

+52
-31
lines changed

‎doc/g191.md‎

Lines changed: 6 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -12,17 +12,17 @@ Please refer to the official Recommendation ITU-T G.191 for the complete text: [
1212

1313
Recommendation ITU-T G.191 provides source code for speech and audio processing modules for narrowband, wideband and super-wideband telephony applications. The set includes codecs, filters, noise generators.
1414

15-
This edition introduces changes to Annex A, which describes the ITU-T Software Tools (STL) containing a high-quality, portable C code library for speech processing applications. This release of the STL, also known as STL2022, incorporates:
15+
This edition introduces changes to Annex A, which describes the ITU-T Software Tools (STL) containing a high-quality, portable C code library for speech processing applications. This release of the STL, also known as STL2023, incorporates:
1616

17-
* An implementation of ESDRU (energy-based spatial distortion reference unit) as described in ITU-T P.811.
17+
* An implementation of P.50 fullband MNRU as described in ITU-T P.810.
1818

19-
* An implementation of the loudness measurement algorithm as in ITU-R Rec. BS.1770-4.
19+
* A tool for automatic instrumentation of speech and audio codecs to measure their computational complexity and memory.
2020

21-
Recommendation ITU-T G.191 includes an electronic attachment containing STL2022 and manual.
21+
Recommendation ITU-T G.191 includes an electronic attachment containing STL2023 and manual.
2222

2323
## Keywords
2424

25-
DSP operators, filters, MNRU, open source, reverb, STL2022, G.711, G.722, G.726, G.728, sv56, BS.1770, ESDRU
25+
DSP operators, filters, MNRU, P.50 FB MNRU, open source, reverb, STL2022, G.711, G.722, G.726, G.728, sv56, BS.1770, ESDRU, WMC Tool
2626

2727
## 1. Scope
2828

@@ -55,7 +55,7 @@ The following ITU-T Recommendations and other references contain provisions whic
5555
[ITU-T P.48] Recommendation ITU-T P.48 (1988), *Specification for an intermediate reference system*
5656
[ITU-T P.56] Recommendation ITU-T P.56 (2011), *Objective measurement of active speech level*
5757
[ITU-T P.341] Recommendation ITU-T P.341 (2011), *Transmission characteristics for wideband digital loudspeaking and hands-free telephony terminals*
58-
[ITU-T P.810] Recommendation ITU-T P.810 (1996), *Modulated noise reference unit (MNRU)*
58+
[ITU-T P.810] Recommendation ITU-T P.810 (2023), *Modulated noise reference unit (MNRU)*
5959
[ITU-T P.811] Recommendation ITU-T P.811 (2019), *Subjective test methodology for evaluating Speech oriented stereo communication systems over headphones*
6060
[ITU-R BS.1770] Recommendation ITU-R BS.1770-4 (2015), *Algorithms to measure audio programme loudness and true-peak audio level*
6161
-----------------------------------------------

‎doc/g191_Annex_A.md‎

Lines changed: 46 additions & 25 deletions
Original file line numberDiff line numberDiff line change
@@ -11,32 +11,37 @@ Associated header file: `ugstdemo.h`
1111
The following programs are examples of the use of the modules:
1212

1313
|||
14-
|-------|-----------------------------------------------------------|
15-
| `g711demo.c` | on the use of the ITU‑T G.711 module. |
16-
| `g726demo.c` | on the use of the ITU‑T G.726 module. |
17-
| `g727demo.c` | on the use of the ITU‑T G.727 module |
18-
| `g722demo.c` | on the use of the ITU‑T G.722 module. |
19-
| `g728enc.c` | on the use of the ITU‑T G.728 floating-point encoder. |
20-
| `g728dec.c` | on the use of the ITU‑T G.728 floating-point decoder. |
21-
| `g728fpenc.c` | on the use of the ITU‑T G.728 fixed-point encoder. |
22-
| `g728fpdec.c` | on the use of the ITU‑T G.728 fixed-point decoder. |
23-
| `rpedemo.c` | on the use of the full-rate GSM 06.10 speech codec module. |
24-
| `sv56demo.c` | on the use of the speech voltmeter module, and also the gain/loss routine. |
25-
| `eiddemo.c` | on the use of the error insertion device for bit error insertion and frame erasure. |
26-
| `eid-ev.c` | on the use of the error insertion device for bit error insertion for layered bitstreams, which can be used to apply errors to individual layers in layered bitstreams, such as [ITU‑T G.718] or [ITU‑T G.729.1]. |
27-
| `gen-patt.c` | on the use of generating bit error pattern files for error insertion in serial bitstreams encoded files that comply with [ITU‑T G.192]. |
14+
|----------------------|-----------------------------------------------|
15+
| `g711demo.c` | on the use of the ITU‑T G.711 module. |
16+
| `g726demo.c` | on the use of the ITU‑T G.726 module. |
17+
| `g727demo.c` | on the use of the ITU‑T G.727 module |
18+
| `g722demo.c` | on the use of the ITU‑T G.722 module. |
19+
| `g728enc.c` | on the use of the ITU‑T G.728 floating-point encoder. |
20+
| `g728dec.c` | on the use of the ITU‑T G.728 floating-point decoder. |
21+
| `g728fpenc.c` | on the use of the ITU‑T G.728 fixed-point encoder. |
22+
| `g728fpdec.c` | on the use of the ITU‑T G.728 fixed-point decoder. |
23+
| `rpedemo.c` | on the use of the full-rate GSM 06.10 speech codec module. |
24+
| `sv56demo.c` | on the use of the speech voltmeter module, and also the gain/loss routine. |
25+
| `eiddemo.c` | on the use of the error insertion device for bit error insertion and frame erasure. |
26+
| `eid-ev.c` | on the use of the error insertion device for bit error insertion for layered bitstreams, which can be used to apply errors to individual layers in layered bitstreams, such as [ITU‑T G.718] or [ITU‑T G.729.1]. |
27+
| `gen-patt.c` | on the use of generating bit error pattern files for error insertion in serial bitstreams encoded files that comply with [ITU‑T G.192]. |
2828
| `gen_rate_profile.c` | on the use of the fast switching rate profile generation tool. |
29-
| `firdemo.c` | on the use of the finite impulse response (FIR) high-quality low-pass and band-pass filters and of the FIR-IRS filters, associated with the rate change module. |
30-
| `pcmdemo.c` | on the use of the ITU‑T G.712 (standard PCM) IIR (infinite impulse response) filters, associated with the rate change module. |
31-
| `filter.c` | on the use of both the IIR and the FIR filters available in the rate change module. |
32-
| `mnrudemo.c` | on the use of the narrow-band and wideband modulated noise reference unity (ITU‑T P.810) module. |
33-
| `spdemo.c` | on the use of the serialization and parallelization routines of the utility module. |
34-
| `g711iplc.c` | on the use of the packet loss concealment module of Appendix I of [G.711]. |
35-
| `reverb.c` | on the use of the reverberation module. |
36-
| `truncate.c` | on the use of the bitstream truncation module. |
37-
| `freqresp.c` | on the use of the frequency response computation tool. |
38-
| `stereoop.c` | on the use of stereo file operations. |
39-
| `esdru.c` | on the use of energy-based spatial distortion reference unit [ITU-T P.811]. | ||
29+
| `firdemo.c` | on the use of the finite impulse response (FIR) high-quality low-pass and band-pass filters and of the FIR-IRS filters, associated with the rate change module. |
30+
| `pcmdemo.c` | on the use of the ITU‑T G.712 (standard PCM) IIR (infinite impulse response) filters, associated with the rate change module. |
31+
| `filter.c` | on the use of both the IIR and the FIR filters available in the rate change module. |
32+
| `mnrudemo.c` | on the use of the narrow-band and wideband modulated noise reference unity (ITU‑T P.810) module. |
33+
| `p50fbmnru.c` | on the use of the P.50 fullband MNRU.
34+
|
35+
| `spdemo.c` | on the use of the serialization and parallelization routines of the utility module. |
36+
| `g711iplc.c` | on the use of the packet loss concealment module of Appendix I of [G.711]. |
37+
| `reverb.c` | on the use of the reverberation module. |
38+
| `truncate.c` | on the use of the bitstream truncation module. |
39+
| `freqresp.c` | on the use of the frequency response computation tool. |
40+
| `stereoop.c` | on the use of stereo file operations. |
41+
| `esdru.c` | on the use of energy-based spatial distortion reference unit [ITU-T P.811]. |
42+
| `wmc_tool.cpp` | on the use of WMC tool for speech and audio codecs complexity and memory measurement. |
43+
||
44+
4045

4146
NOTE - The module for the basic operators does not have a demo program but it is supplemented by two tools: one to evaluate program read only memory (ROM) complexity for fixed-point code (`basop_cnt.c`), and another to evaluate complexity (including program ROM) of floating-point implementations (`flc_example.c`). Both reside in the basic operators module.
4247

@@ -185,6 +190,7 @@ The functions included are as follows.
185190
|||
186191
|---------------------|-----------------------------------------------------------|
187192
| `MNRU_process` | module for addition of modulated noise to a vector of samples, according to [ITU-T P.810], for both the narrow-band and the wideband models. |
193+
| `P50_MNRU_process` | module for addition of modulated noise to a vector of samples, according to [ITU-T P.810], for P.50 full band model. |
188194

189195
## i) Speech voltmeter module
190196

@@ -689,4 +695,19 @@ The functions included are as follows.
689695
`find_scaling_factor` Iterative process to derive the most appropriate scaling factor.
690696
------------------------------------------------------------------------------------------
691697

698+
699+
## t) WMC Tool
700+
701+
Name: `wmc_tool.cpp`
702+
703+
The main program for WMC Tool. Depends on:
704+
705+
-------------------- --------------------------------------------------------------------
706+
`c_parser.cpp` Routines for parsing C functions.
707+
`text_utils.cpp` Text and string processing functions.
708+
`output.cpp` Warning and error messages.
709+
`wmc_auto_h.txt` Auto-generated header file for inclusion in projects.
710+
`wmc_auto_c.txt` Auto-generated C source file for inclusion in projects.
711+
------------------------------------------------------------------------------------------
712+
692713
-=Pagebreak=-

0 commit comments

Comments
 (0)