Commit a5a3ff26 authored by Archit Tamarapu's avatar Archit Tamarapu
Browse files

Merge branch 'main' of... 

Merge branch 'main' of ssh://forge.3gpp.org:29419/ivas-codec-pc/ivas-processing-scripts into enable-ivasrend-prerendering
parents d94ae23f de39f219

README.md

+12 −5
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`.
@@ -435,6 +433,13 @@ conditions_to_generate: 
      # fs: 48000

      ### Additional commandline options; default = null

      # opts: ["-q", "-no_delay_cmp"]

      ### Per-item renderer configuration. Set to true to search for a file with suffix .cfg; default = false

      # render_config: true

      ### Head-tracking trajectory file for binaural output OR 'true' which will search for a file with the suffix .ht.csv next to the input; default = null

      ###   NOTE: this automatically configures the '-T' argument to the decoder, so may conflict if also specified in `opts`

      # trajectory: "path/to/file"

      ### Limit the trajectory to 3DoF via truncation; default = false

      # only_3dof: false



  ### IVAS condition ###############################

  c07:
@@ -520,8 +525,10 @@ postprocessing: 
  # bin_lfe_gain: 1

  ### Flag whether output should be limited to avoid clipping (can alter target loudness); default = true

  # limit: false

  ### Head-tracking trajectory file for binaural output; default = null

  ### Head-tracking trajectory file for binaural output OR 'true' which will search for a file with the suffix .ht.csv in the input dir; default = null

  # trajectory: "path/to/file"

  ### Limit the trajectory to 3DoF via truncation; default = false

  # only_3dof: false

```



</details>

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

###