Test vectors

Test vectors are grouped with a common prefix. For example test_000012 has several files associated with it.

  • Metadata describing the test vector:test_000012.textproto.
  • Standalone IAMF bitstream: test_000012.iamf.
  • Fragmented MP4 file: test_000012_f.mp4.
  • Standalone MP4 file: test_000012_s.mp4.
  • Rendered WAV file (per mix_presentation_id x, sub mix index y, layout index z): test_000012_rendered_id_x_sub_mix_y_layout_z.wav

.textproto files

Theses file describe metadata about the test vector to encode an IA Sequence.

  • is_valid: True when the encoder can produce an IA Sequence where all mixes would be understood by a compliant decoder. False when one or more mixes exercise fields or features which would cause mixes to be ignored.
  • is_valid_to_decode: True when an IAMF-compliant decoder could decode at least one mix of the associated IA Sequence (“should-pass”). False when all mixes are non-conformant and may fail to be decoded (“should-fail”). The IAMF spec does not specify what happens when requirements are violated; a robust system may still attempt to process and create output for “should-fail” tests.
  • human_readable_descriptions: A short description of what is being tested and why.
  • mp4_fixed_timestamp: The timestamp within the MP4 file. Can be safely ignored.
  • primary_tested_spec_sections: A list of the main sections being tested. In the form X.Y.Z/class_or_field_name to represent the class_or_field_name in the IAMF specification Section X.Y.Z is being tested.
  • base_test: The recommended textproto to diff against.
  • Other fields refer to the OBUs and data within the test vector.

Input WAV files

Test vectors may have multiple substreams with several input .wav files. These .wav files may be shared with other test vectors. The .textproto file has a section which input wav file associated with each substream.

Summary

TitleSummaryChannelsSample RateFormatDuration
audiolab-acoustic-guitar_2OA_470_ALLRAD_0.5sShort clip of a guitar playing using 7.1.4.1248kHzpcm_s16le500ms
audiolab-acoustic-guitar_2OA_470_ALLRAD_5s.wavShort clip of a guitar playing using 7.1.4.1248kHzpcm_s16le5s
audiolab-acoustic-guitar_2OA_470_ALLRAD_concat.wavClip of a guitar playing which which is repeated once using 7.1.4.1248kHzpcm_s16le22.77s
dialog_clip_stereo.wavEnglish dialog.248kHzpcm_s16le5s
Mechanism_5s_32bit.wavMechanical noises using 7.1.4.1248kHzpcm_s32le5s
Mechanism_5s.wavMechanical noises using 7.1.4.1248kHzpcm_s16le5s
Mechanism_5s_44100hz_s16le.wavMechanical noises using 7.1.4.1244.1kpcm_s16le5s
sample1_48kHz_stereo.wavSawtooth wave.248kHzpcm_s16le5s
sawtooth_10000_foa_48kHz.wavSawtooth wave using first-order ambisonics.448kHzpcm_s16le500ms
sawtooth_10000_stereo_44100hz_s16le.wavSawtooth wave.244.1kHzpcm_s16le500ms
sawtooth_10000_stereo_48kHz_s24le.wavSawtooth wave.248kHzpcm_s24le500ms
sawtooth_10000_stereo_48kHz.wavSawtooth wave.248kHzpcm_s16le500ms
sawtooth_100_stereo.wavSawtooth wave.216kHzpcm_s16le500ms
sawtooth_8000_toa_48kHz.wavSawtooth wave using third-order ambisonics.1648kHzpcm_s16le500ms
sine_1000_16kHz_512ms.wavSine wave.216kHzpcm_s16le512ms
sine_1000_16khz_512ms_s32le.wavSine wave.116kHzpcm_s32le512ms
sine_1000_48kHz_512ms.wavSine wave.248kHzpcm_s16le512ms
sine_1000_48kHz.wavSine wave.248kHzpcm_s16le500ms
sine_1000_4oa_48kHz.wavSine wave using fourth-order ambisonics.2548kHzpcm_s16le5000ms
sine_1500_stereo_48khz_-15dBFS.wavSine wave using at -15dBFS.248kHzpcm_s16le5000ms
stereo_8_samples_48khz_s16le.wavTiny test file. The first channel encodes 1, 2, ... 8. The second channel encodes 65535, 65534, ... 65528.248kHzpcm_s16le8 samples
stereo_8_samples_48khz_s24le.wavTiny test file. The first channel encodes 1, 2, ... 8. The second channel encodes 16777216, 16777215, ... 16777209.248kHzpcm_s24le8 samples
Transport_TOA_5s.wavShort clip of vehicles driving by using third-order ambisonics.1648kHzpcm_s16le5s
Transport_9.1.6_5s.wavShort clip of vehicles driving by using 9.1.6.1648kHzpcm_s16le5s

Output WAV files

Output wav files are based on the layout in the mix presentation. Typically the ordering of channels is based on the related ITU-2051-3 layout.

Mix Presentation LayoutChannel Order ConventionChannel Order
Sound System A (0+2+0)ITU-2051-3L, R
Sound System B (0+5+0)ITU-2051-3L, R, C, LFE, Ls, Rs
Sound System C (2+5+0)ITU-2051-3L, R, C, LFE, Ls, Rs, Ltf, Rtf
Sound System D (4+5+0)ITU-2051-3L, R, C, LFE, Ls, Rs, Ltf, Rtf, Ltr, Rtr
Sound System E (4+5+1)ITU-2051-3L, R, C, LFE, Ls, Rs, Ltf, Rtf, Ltr, Rtr, Cbf
Sound System F (3+7+0)ITU-2051-3C, L, R, LH, RH, LS, LB, RB, CH, LFE1, LFE2
Sound System G (4+9+0)ITU-2051-3L, R, C, LFE, Lss, Rss, Lrs, Rrs, Ltf, Rtf, Ltb, Rtb, Lsc, Rsc
Sound System H (9+10+3)ITU-2051-3FL, FR, FC, LFE1, BL, BR, FLc, FRc, BC, LFE2, SiL, SiR, TpFL, TpFR, TpFC, TpC, TpBL, TpBR, TpSiL, TpSiR, TpBC, BtFC, BtFL, BtFR
Sound System I (0+7+0)ITU_2051-3L, R, C, LFE, Lss, Rss, Lrs, Rrs
Sound System J (4+7+0)ITU_2051-3L, R, C, LFE, Lss, Rss, Lrs, Rrs, Ltf, Rtf, Ltb, Rtb
Sound System 10IAMFL7, R7, C, LFE, Lss7, Rss7, Lrs7, Rrs7, Ltf2, Rtf2
Sound System 11IAMFL3, R3, C, LFE, Ltf3, Rtf3,
Sound System 12IAMFC
Sound System 13IAMFFL, FR, FC, LFE, BL, BR, FLc, FRc, SiL, SiR, TpFL, TpFR, TpBL, TpBR, TpSiL, TpSiR
Binaural LayoutIAMFL2, R2