Project

General

Profile

IR file formats

All datasets are available in three different formats.

  • MAT format, which comes with a set of m-files that allow an easy usage of the datasets within GNU octave or Matlab
  • OpenDAFF format, an upcoming open standard format for directional audio data
  • WAV format, which can be directly used in the SoundScape Renderer, our Open Source tool for 3D audio reproduction

MAT Format

Quick usage:

irs = read_irs('QU_KEMAR_anechoic_3m.mat');
ir = get_ir(irs,45);
figure; plot(ir(:,1),'-b',ir(:,2),'-r');

This format was created for the use with HRIR and BRIR data and contains the following entries.

Name Description Dimension Unit
.description description for IR set string
.head used dummy head string
.ears used artificial ears string
.room measurement room string
.source used source (loudspeaker) string
.distance norm(head_position-source_position), distance between head and source 1 x 1 m
.fs sampling rate 1 x 1 Hz
.head_position [x y z] position of head 1 x 3 m
.head_reference [x y z] head pointing to this location without any movement 1 x 3 m
.source_position [x y z] position of source 1 x 3 m
.source_reference [x y z] source pointing to this location 1 x 3 m
.head_azimuth azimuth angle of head position relative to torso 1 x number of IRs or 1x1 rad
.head_elevation elevation angle of head position relative to torso 1 x number of IRs or 1x1 rad
.torso_azimuth azimuth angle of torso position 1 x number of IRs or 1x1 rad
.torso_elevation elevation angle of torso position 1 x number of IRs or 1x1 rad
.apparent_azimuth azimuth of the source to the head direction 1 x number of IRs rad
.apparent_elevation elevation of the source to the head direction 1 x number of IRs rad
.left left signals of IR set length of IR x number of IRs
.right right signals of IR set length of IR x number of IRs

The geometry for the entries is described in the following picture:

Note that for a classical HRIR measurement, normally only the torso is rotated and alpha = 0.

OpenDAFF format

The first stable version of OpenDAFF will be available soon (spring 2012), see there: http://www.opendaff.org/.

Until then, the file format can change, therefore we don't offer OpenDAFF files yet for public download.

If you can't wait for the stable version, please contact us, then we can send you the files.

Quick usage (in Matlab):

h = DAFF('open','QU_KEMAR_anechoic_3m.daff');
props = DAFF('getProperties', h)
metadata = DAFF('getMetadata', h)
ir = DAFF('getNearestNeighbourRecord', h, 'object', 45, 0);
figure; plot(ir(1,:),'-b',ir(2,:),'-r');

WAV format

Quick usage:

ssr --binaural --hrirs=QU_KEMAR_anechoic_3m.wav

Usage in configuration file (e.g. $HOME/.ssr/ssr.conf):

HRIR_FILE_NAME = QU_KEMAR_anechoic_3m.wav

For further information have a look at the SSR Manual here: https://dev.qu.tu-berlin.de/projects/ssr/files.


attachments:

IR_format.png View (40.4 KB) Hagen Wierstorf, 2011-05-09 17:08