Merge branch 'main' into 22-add-foa-item-generation-to-scripts

  script:

    - *print-common-info

    - *get-codec-binaries

    - python3 -m pytest -n auto tests/test_experiments.py

    - python3 -m pytest tests/test_experiments.py -n auto | tee log.txt

  artifacts:

    paths:

      - experiments/selection/*/proc_output/*.log

      - log.txt

    when: on_failure

    expire_in: 1 week

# run some test configs for item creation

test_processing:

| Filtering, Resampling                           | filter                | 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 (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         |

| MASA rendering (also used in loudness measurement of MASA items)        | masaRenderer, masaAnalyzer   | https://www.3gpp.org/ftp/TSG_SA/WG4_CODEC/TSGS4_122_Athens/Docs/S4-230221.zip         |

| EVS reference conditions        | EVS_cod, EVS_dec      | https://www.3gpp.org/ftp/Specs/archive/26_series/26.443/26443-h00.zip                                       |

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 

---

# audiotools CLI for format conversion and rendering

# Audiotools CLI for format conversion and rendering

Please refer to [the notebook](./examples/audiotools.ipynb) for an overview.

# Selection test experiments

The folder `experiments/selection` contains a directory skeleton for processing items for the various selection test experiments including the config files. E.g. for processing the items for BS1534-1a, the input files need to be put into `experiments/selection/BS1534-1a/proc_input`, then execute `python3 -m ivas_processing_scripts experiments/selection/BS1534-1a/config/BS1534-1a.yml`. The output files will be in `experiments/selection/BS1534-1a/proc_output`, in subfolders per conditions.

Note that for P800 experiments, there are separate configs per category as different background noises need to be specified. Thus, there are several config files with `-catX` suffix available. The background noise files need to be put into `experiments/selection/P800-X/background_noise`. To generate all categories, there is a convenience script `create_items_p800.py` in the repository root folder.

 No newline at end of file

#! /usr/bin/env python3

import argparse

from pathlib import Path

from ivas_processing_scripts import main as generate_test

from ivas_processing_scripts.utils import apply_func_parallel

P800_TESTS = [f"P800-{i}" for i in range(1, 8)]

class Arguments:

    def __init__(self, config):

        self.config = config

        self.debug = False

        # used to overwrite the multiprocessing key in the configs to rather parallelize on category level

        self.multiprocessing = False

def create_items(testname):

    p800_path = Path(f"experiments/selection/{testname}")

    p800_cfgs = p800_path.joinpath("config").glob("P800*cat*.yml")

    args = [Arguments(str(cfg)) for cfg in p800_cfgs]

    apply_func_parallel(generate_test, zip(args), type="mp")

# if is necessary here so that multiprocessing does not crash

if __name__ == "__main__":

    parser = argparse.ArgumentParser()

    parser.add_argument("testname", choices=P800_TESTS)

    args = parser.parse_args()

    create_items(args.testname)

### Post-processing step performed after core processing for all conditions

### Post-processing is required and can not be omitted

postprocessing:

    ### REQUIRED: Target format for output

    ### REQUIRED: Target format for output, this can be a string as below, or a list, e.g. ["FOA", "BINAURAL"].

    ###           Conversion will be applied in order and the last format is the final output forma. This was introduced to 

    ###           accomodate for the MASA tests where masaRenderer is used as binaural renderer for all conditions.

    fmt: "BINAURAL"

    ### REQUIRED: Target sampling rate in Hz for resampling

    fs: 48000