diff --git a/README.md b/README.md index 7cef2b78b9015341a5f671e78c0b5d8a176de98c..8f475ab227e76b1c0d461815ff8157b6c0396af1 100755 --- a/README.md +++ b/README.md @@ -146,6 +146,8 @@ python other/get_md5.py experiments/characterization/P800-1/proc_final p800-1_ha ### P.800 experiments +#### Input structure for P.800 + ```bash . └── P800-1 @@ -153,13 +155,21 @@ python other/get_md5.py experiments/characterization/P800-1/proc_final p800-1_ha │ └── ├── config │ └── - ├── proc_input - │ ├── cat1 - │ │ ├── - │ │ ├── for ISM metadata - │ │ └── for MASA metadata - │ ├── cat2... - │ └── ...cat6 + └── proc_input + ├── cat1 + │ ├── [l]p[ee]a[y]s[zz].c[nn].wav + │ ├── [l]p[ee]a[y]s[zz].c[nn].wav.{0,1,2,3}.csv # for ISM metadata + │ └── [l]p[ee]a[y]s[zz].c[nn].wav.met # for MASA metadata + ├── cat2... + └── ...cat6 +``` + +#### Scripts outputs for P.800 + +```bash +. +└── P800-1 + │ # the below directories are created by the processing and collection scripts ├── proc_final │ ├── c01 │ │ └── [l]p[ee]a[y]s[zz].c[nn].wav @@ -171,7 +181,7 @@ python other/get_md5.py experiments/characterization/P800-1/proc_final p800-1_ha ├── cat1 │ ├── out_-16LKFS │ │ ├── c01 - │ │ │ └── + │ │ │ └── [l]p[ee]a[y]s[zz].c[nn].wav │ │ ├── c02... │ │ └── ...cXX │ ├── out_-26LKFS @@ -180,31 +190,75 @@ python other/get_md5.py experiments/characterization/P800-1/proc_final p800-1_ha └── ...cat6 ``` +#### Output structure for P.800 + +The folders for upload to box.com and for delivery to the listeing labs should look like the structure below. +This is essentially the contents of the `proc_final` directory produced from the collection scripts. + +```bash +. +└── P800-1 + ├── c01 + │ └── [l]p[ee]a[y]s[zz].c[nn].wav + ├── c02... + ├── ...c36 + ├── preliminaries + │ └── [l]p[ee]a[y]s[zz].c[nn].wav + └── P800-1_hashes.txt +``` + ### BS.1534 experiments +#### Input structure for BS.1534 + ```bash . └── BS1534-1 ├── config │ └── ├── proc_input[_FMT] # for multiple input formats, suffix is present - │ ├── - │ ├── for ISM metadata - │ └── for MASA metadata + │ ├── [l]m[ee]a[y]s[zz].c[nn].wav + │ ├── [l]m[ee]a[y]s[zz].c[nn].wav.{0,1,2,3}.csv # for ISM metadata + │ └── [l]m[ee]a[y]s[zz].c[nn].wav.met # for MASA metadata +``` + +#### Scripts outputs for BS.1534 + +```bash +. +└── BS1534-1 + │ # the below directories are created by the processing and collection scripts ├── proc_final │ ├── c01 - │ └── + │ │ └── [l]m[ee]a[y]s[zz].c[nn].wav │ ├── c02... │ ├── ...c08 │ └── preliminaries - │ └── + │ └── [l]m[ee]a[y]s[zz].c[nn].wav └── proc_output[_FMT] # for multiple input formats, suffix is present ├── c01 - │ └── + │ └── [l]m[ee]a[y]s[zz].c[nn].wav ├── c02... └── ...cXX ``` +#### Output structure for BS.1534 + +The folders for upload to box.com and for delivery to the listeing labs should look like the structure below. +This is essentially the contents of the `proc_final` directory produced from the collection scripts. + +```bash +. +└── BS1534-1 + ├── c01 + │ └── [l]m[ee]a[y]s[zz].c[nn].wav + ├── c02... + ├── ...c08 + ├── preliminaries + │ └── [l]m[ee]a[y]s[zz].c[nn].wav + └── BS1534-1_hashes.txt +``` + # Quick guide: How to set up a listening test This section describes step by step how to set up a listening test according to the Processing Plan (IVAS-7) and Test Plan (IVAS-8). @@ -723,7 +777,7 @@ No required arguments but the `type` key. #### MNRU and ESDRU The MNRU and ESDRU conditions each take one additional required argument. For MNRU the value `q`, which represents the ratio of speech power to modulated noise power in dB, -has to be specified. +has to be specified. For the ESDRU the spatial degradation value `alpha` in the range [0, 1] has to be defined. #### Mono downmix mono_dmx diff --git a/collection-scripts/characterization/bs1534.py b/collection-scripts/characterization/bs1534.py index e0e8c0416a232dd7ed3b9ebbac4288926db51cac..9db1ac4c61e7dbd8e6116b9bc33a87d329b838d6 100644 --- a/collection-scripts/characterization/bs1534.py +++ b/collection-scripts/characterization/bs1534.py @@ -1,10 +1,9 @@ import argparse import glob -import shutil import re +import shutil from pathlib import Path - PRELIMINARY_SUBSTRINGS = ["s13", "s14", "s15", "s16"] PRELIMINARY_PATTERN = re.compile(r"dm[0-9]*a[1-9](s[0-9]*)\.c[0-1][0-9]\.wav")