Commit bb7feadf authored by malenovsky's avatar malenovsky
Browse files

Merge branch... 

Merge branch '102-bring-back-support-of-the-overlap-parameter-in-item-generation-scripts' into 'main'

Resolve "Bring back support of the overlap parameter in item-generation scripts"

See merge request !194
parents 7c150828 a8b5728f

README.md

+2 −4
Original line number Diff line number Diff line
@@ -76,13 +76,11 @@ Each entry under `scenes:` describes one test item, specifying: 
- `input`: list of mono `.wav` files

- `azimuth` / `elevation`: spatial placement (°)

- `level`: loudness in dB

- `shift`: timing offsets in seconds

- `shift`: signal offset/overlap in seconds

- `background`: background noise file (applicable to STEREO and SBA only)

- `background_level`: level of the background noise (applicable to STEREO and SBA only)



Dynamic positioning (e.g., `"-20:1.0:360"`) means the source will move over time, stepping every 20 ms.



The total duration of the output signal can be controlled using the `duration` field. The output signal may optionally be rendered to the BINAURAL format by specifying the `binaural_output` field.

Dynamic positioning (e.g., `"-20:1.0:360"`) means the source will move over time, stepping every 20 ms. The maximum total duration of the output signal can be controlled using the `duration` field. The output signal may optionally be rendered to the BINAURAL format by specifying the `binaural_output` field. The `shift` parameter ensures time adjustment (offset) of the input signal (positive value delays the signal). Aternatively, the notation `X(i_ref)` generates overlap by `X` seconds from the reference signal `i_ref` (0-based index) (positive value creates gap).



Start by running a single scene to verify settings. Output includes both audio and optional metadata files. You can enable multiprocessing by setting `multiprocessing: true`.

examples/ITEM_GENERATION_3ISM.yml

+5 −2
Original line number Diff line number Diff line
@@ -37,7 +37,7 @@ duration: 8 
add_low_level_random_noise: true



### Process with parallel streams

multiprocessing: False

multiprocessing: false



################################################

### Item generation - Filename conventions
@@ -93,7 +93,10 @@ provider: "va" 
###   input:       input filename(s)

###   azimuth:     azimuth in the range [-180,180]; positive values point to the left

###   elevation:   elevation in the range [-90,90]; positive values indicate up

###   shift:       time adjustment of the input signal (negative value delays the signal)

###   shift:       time adjustment of the input signal (positive value delays the signal)

###                alternatively, the notation X(i_ref) generates overlap by X seconds from the reference signal i_ref (0-based index) (positive value creates gap)

###   background:  background noise filename (if used, the 'add_low_level_random_noise' parameter is ignored)

###   background_level:  normalized background noise loudness to X dB LKFS

###

### Note 0: you can use relative paths in filenames (the program assumes that the root directory is the parent directory of the ivas_processing_scripts subfolder)

### Note 1: use brackets [val1, val2, ...] when specifying multiple values

examples/ITEM_GENERATION_5_1_4.yml

+2 −1
Original line number Diff line number Diff line
@@ -94,7 +94,8 @@ provider: "va" 
###   IR:          filenames(s) of the input IRs 

###   azimuth:     azimuth in the range [-180,180]; positive values point to the left

###   elevation:   elevation in the range [-90,90]; positive values indicate up

###   shift:       time adjustment of the input signal (negative value delays the signal)

###   shift:       time adjustment of the input signal (positive value delays the signal)

###                alternatively, the notation X(i_ref) generates overlap by X seconds from the reference signal i_ref (0-based index) (positive value creates gap)

###   background:  background noise filename (if used, the 'add_low_level_random_noise' parameter is ignored)

###   background_level:  normalized background noise loudness to X dB LKFS

###

examples/ITEM_GENERATION_FOA.yml

+4 −3
Original line number Diff line number Diff line
@@ -34,10 +34,10 @@ fade_in_out: 0.5 
duration: 8



### Add low-level random background noise (amplitude +-4) instead of silence; default = false (silence)

add_low_level_random_noise: False

add_low_level_random_noise: false



### Process with parallel streams

multiprocessing: False

multiprocessing: false



################################################

### Item generation - Filename conventions
@@ -94,7 +94,8 @@ use_output_prefix: "leee" 
###   IR:          filenames(s) of the input IRs 

###   azimuth:     azimuth in the range [-180,180]; positive values point to the left

###   elevation:   elevation in the range [-90,90]; positive values indicate up

###   shift:       time adjustment of the input signal (negative value delays the signal)

###   shift:       time adjustment of the input signal (positive value delays the signal)

###                alternatively, the notation X(i_ref) generates overlap by X seconds from the reference signal i_ref (0-based index) (positive value creates gap)

###   background:  background noise filename (if used, the 'add_low_level_random_noise' parameter is ignored)

###   background_level:  normalized background noise loudness to X dB LKFS

###

examples/ITEM_GENERATION_MASA.yml

+2 −1
Original line number Diff line number Diff line
@@ -94,7 +94,8 @@ provider: "va" 
###   IR:          filenames(s) of the input IRs 

###   azimuth:     azimuth in the range [-180,180]; positive values point to the left

###   elevation:   elevation in the range [-90,90]; positive values indicate up

###   shift:       time adjustment of the input signal (negative value delays the signal)

###   shift:       time adjustment of the input signal (positive value delays the signal)

###                alternatively, the notation X(i_ref) generates overlap by X seconds from the reference signal i_ref (0-based index) (positive value creates gap)

###   background:  background noise filename (if used, the 'add_low_level_random_noise' parameter is ignored)

###   background_level:  normalized background noise loudness to X dB LKFS

###