Sofaconventions - User contributions [en]

Files

2018-05-03T15:54:38Z

Hagenw: Add SADIE dummy head HRTFs as extzra entry

The [http://sofacoustics.org/data main SOFA repository] aims at collect the worldwide available HRTFs, BRIRs, DRIRs, and other SOFA-related data at a single place. It is just in the process of being created: Partial download, metadata access, and database search is not available (yet, we are investigating the possibility of using [http://www.opendap.org/ OPeNDAP] for SOFA repositories). Currently, the data can be accessed and downloaded as they are and the metadata are provided in the particular files.

== General purpose [http://sofacoustics.org/data/database database]: ==

Standard (in-the-ear canal) HRTFs of humans:
* [http://sofacoustics.org/data/database/ari ARI]: HRTFs from the [http://www.kfs.oeaw.ac.at/hrtf ARI database]. In-the-ear HRTFs and DTFs for over 120 listeners.
** hrtf, dtf: HRTFs and DTFs, respectively, equalized between 300 Hz and 18 kHz
** hrtf b, dtf b: HRTFs and DTFs, equalized between 50 Hz and 18 kHz for hi-fi auralizations
* [http://sofacoustics.org/data/database/ari%20(altb) ARI (ALTB)]: HRTFs from the ARI database. Measurements for some of the listeners from the ARI database, repeated and evaluated a few years later, see [http://www.researchgate.net/publication/236111930_Sound_localization_in_individualized_and_non-individualized_crosstalk_cancellation_systems Majdak et al. (2013)].
* [http://sofacoustics.org/data/database/cipic CIPIC]: HRTFs from the [http://interface.cipic.ucdavis.edu/data/ CIPIC database]. 45 listeners, partially antropometric data available.
* [http://sofacoustics.org/data/database/riec RIEC]: Far-field HRTFs from the [http://www.riec.tohoku.ac.jp/pub/hrtf/index.html RIEC] database of over 100 human listeners. ''(Credit: Kajni Watanabe, Japan)''
* [http://www.york.ac.uk/sadie-project/binaural.html SADIE]: Far-field HRTFs from the [http://www.york.ac.uk/sadie-project/binaural.html SADIE] database of over 20 human listeners. ''(Credit: Gavin Kearney, York)''
* [http://sofacoustics.org/data/database/aachen Aachen]: HRTFs from the [http://www.akustik.rwth-aachen.de/go/id/lsly Aachen HRTF database], combined with anthropometric data and 3D ear models of of 48 listeners. See the [http://gershwin.akustik.rwth-aachen.de/hrtf/hrtf-lic.php license]. ''(Credit: Janina Fels, Aachen)''

HRTFs of artificial heads:
* [http://sofacoustics.org/data/database/mit MIT-KEMAR]: HRTFs from [http://sound.media.mit.edu/resources/KEMAR/ MIT of the KEMAR] dummy head. Reference HRTFs used in many publications.
* [http://sofacoustics.org/data/database/ari%20(artificial) ARI (ARTIFICIAL)] HRTFs of mannequins (dummy heads) measured at ARI using the same setup as for human listeners:
** NH169: HRTFs, DTFs, and raw data of a printed head of the corresponding human listener
** NH172: HRTFs, DTFs, raw and reference data of the dummy head Neumann KU 100. Also part of Club Fritz, see below.
* [http://sofacoustics.org/data/database/fhk FHK]: HRTFs of the dummy-head Neumann K100 provided by the Fachhochschule Köln:
** [http://www.audiogroup.web.fh-koeln.de/ku100hrir.html Far-field HRTFs:] Gapless data, high spatial resolution ''(Credit: Benjamin Bernschütz, Germany).''
**[http://audiogroup.web.th-koeln.de/ku100nfhrir.html Near-field HRTFs]: High spatial resolution done for various distances ''(Credit: Johannes Arend, Germany)''.
* [http://sofacoustics.org/data/database/scut SCUT]: Near-field HRTFs from SCUT database of the KEMAR (Radius: 0.2 to 1.0 m). ''(Credit: Bosun Xie, China)''
* [https://www.york.ac.uk/sadie-project/binaural.html SADIE]: HRTFs measured on a [https://www.york.ac.uk/sadie-project/Measurementconfig.html#Dummyheadang sphere] at a distance of 1.5 m with a KEMAR and a Neumann dummy head. ''(Credit: Gavin Kearney, York)''
* [http://sofacoustics.org/data/database/tu-berlin TU-Berlin]:
** HRTFs from [http://doi.org/10.5281/zenodo.55418 TU-Berlin of the KEMAR] dummy-head. HRTFs for several distances (>0.5 m). ''(Credit: Hagen Wierstorf, Germany)''
** HRTFs from [https://depositonce.tu-berlin.de/handle/11303/6153 TU-Berlin of the FABIAN] dummy-head. Acoustically measured and numerically calculated HRTFs. ''(Credit: Fabian Brinkmann, Germany)''
* [http://sofacoustics.org/data/database/clubfritz Club Fritz]: HRTFs of Neumann KU 100 measured as part of the Club Fritz project where many institutions measured the exact same artificial head, see [http://dx.doi.org/10.1109/JSTSP.2015.2400417 Andreopoulou et al, (2015)]. ''(Credit: Brian Katz, France)''.

Special HRTFs:
* [http://sofacoustics.org/data/database/ari%20(bte) ARI (BTE)]: Behind-the-ear HRTFs and DTFs from the [http://www.kfs.oeaw.ac.at/hrtf ARI database].

RIRs/BRIRs/DRIRs:
* [http://sofacoustics.org/data/database/oldenburg Oldenburg] DRIRs from [http://medi.uni-oldenburg.de/hrir/html/download.html Oldenburg]. Recordings in an office under several conditions ''(Credit: Stephan Ewert and Daryl Kelvasa, Germany)''.
* [http://sofacoustics.org/data/database/tuburo TuBuRo]: RIRs (from omnidirectional mic) and BRIRs (from KEMAR) recorded with 64-channel loudspeaker array in a room under various absorbing conditions, see [http://dx.doi.org/10.14279/depositonce-87.2 the source], [https://depositonce.tu-berlin.de/bitstream/11303/245.2/11/AdditionalInformation.pdf notes on the file naming] and [https://secure.aes.org/forum/pubs/ebriefs/?elib=17624 Erbes et al. (2015)]. ''(Credit: Vera Erbes, Rostock, Germany)''.
* '''New: [http://sofacoustics.org/data/database/sbsbrir SBSBRIR]: BRIRs from the [http://www.bbc.co.uk/rd/publications/sbsbrir Salford-BBC dataset] measured in a recording room for 12 loudspekears, each for 15 head orientations ([http://usir.salford.ac.uk/30868/ details]). ''' ''(Credit: Chris Pike, Salford)''.

== Headphone impulse responses (HpIRs) ==
'''New: HpIRs of humans: '''
* [http://sofacoustics.org/data/headphones/ari ARI]: HpIRs from the ARI database. Single headphone, five measurements (with repositioned headphone in-between) for over 100 listeners.
* [http://sofacoustics.org/data/headphones/btdei BT-DEI]: HpIRs from the [http://padva.dei.unipd.it/?page_id=345 BT-DEI] database provided. 16 Listeners, 3 headphones ''(Credit: Michele Geronazzo, Italy)''.
* '''New: HpIRs from [https://depositonce.tu-berlin.de/handle/11303/6153 TU-Berlin of the FABIAN] dummy-head.''' Acoustically measured for 34 headphones. ''(Credit: Fabian Brinkmann, Germany)''

== Special purpose: ==

* [http://sofacoustics.org/data/amt amt]: HRTFs for the various models from the [http://amtoolbox.sourceforge.net AMToolbox]
* [http://sofacoustics.org/data/sofa_api_mo_test sofa_api_mo_test] HRTFs resulting from tests of the [http://sourceforge.net/projects/sofacoustics/ SOFA API for Matlab/Octave]

== Other repositories ==

This is a list of other repositories providing HRTFs, BRIRs, and DRIRs available as SOFA files.

* '''ARI free-field HRTF database'''. HRTFs available for in-the-ear (ITE) and behind-the-ear (BTE) HRTFs. Link: http://www.kfs.oeaw.ac.at/hrtf
* '''Example files''' created by the Matlab/Octave API. Link: http://tinyurl.com/sofaHRTFs
* '''RIEC database''': Database from the Advanced Acoustic Information Systems Laboratory, Research Institute of Electrical Communication, Tohoku University, Japan. Link: http://www.riec.tohoku.ac.jp/pub/hrtf/index.html

Files

2017-07-14T16:02:39Z

Hagenw: /* General purpose database: */

The [http://sofacoustics.org/data main SOFA repository] aims at collect the worldwide available HRTFs, BRIRs, DRIRs, and other SOFA-related data at a single place. It is just in the process of being created: Partial download, metadata access, and database search is not available (yet, we are investigating the possibility of using [http://www.opendap.org/ OPeNDAP] for SOFA repositories). Currently, the data can be accessed and downloaded as they are and the metadata are provided in the particular files.

== General purpose [http://sofacoustics.org/data/database database]: ==

Standard (in-the-ear canal) HRTFs of humans:
* [http://sofacoustics.org/data/database/ari ARI]: HRTFs from the [http://www.kfs.oeaw.ac.at/hrtf ARI database]. In-the-ear HRTFs and DTFs for over 120 listeners.
** hrtf, dtf: HRTFs and DTFs, respectively, equalized between 300 Hz and 18 kHz
** hrtf b, dtf b: HRTFs and DTFs, equalized between 50 Hz and 18 kHz for hi-fi auralizations
* [http://sofacoustics.org/data/database/ari%20(altb) ARI (ALTB)]: HRTFs from the ARI database. Measurements for some of the listeners from the ARI database, repeated and evaluated a few years later, see [http://www.researchgate.net/publication/236111930_Sound_localization_in_individualized_and_non-individualized_crosstalk_cancellation_systems Majdak et al. (2013)].
* [http://sofacoustics.org/data/database/cipic CIPIC]: HRTFs from the [http://interface.cipic.ucdavis.edu/data/ CIPIC database]. 45 listeners, partially antropometric data available.
* [http://sofacoustics.org/data/database/riec RIEC]: Far-field HRTFs from the [http://www.riec.tohoku.ac.jp/pub/hrtf/index.html RIEC] database of over 100 human listeners. ''(Credit: Kajni Watanabe, Japan)''
* [http://www.york.ac.uk/sadie-project/binaural.html SADIE]: Far-field HRTFs from the [http://www.york.ac.uk/sadie-project/binaural.html SADIE] database of over 20 human listeners. ''(Credit: Gavin Kearney, York)''

HRTFs of artificial heads:
* [http://sofacoustics.org/data/database/mit MIT-KEMAR]: HRTFs from [http://sound.media.mit.edu/resources/KEMAR/ MIT of the KEMAR] dummy head. Reference HRTFs used in many publications.
* [http://sofacoustics.org/data/database/ari%20(artificial) ARI (ARTIFICIAL)] HRTFs of mannequins (dummy heads) measured at ARI using the same setup as for human listeners:
** NH169: HRTFs, DTFs, and raw data of a printed head of the corresponding human listener
** NH172: HRTFs, DTFs, raw and reference data of the dummy head Neumann KU 100. Also part of Club Fritz, see below.
* [http://sofacoustics.org/data/database/fhk FHK]: HRTFs of the dummy-head Neumann K100 provided by the Fachhochschule Köln:
** [http://www.audiogroup.web.fh-koeln.de/ku100hrir.html Far-field HRTFs:] Gapless data, high spatial resolution ''(Credit: Benjamin Bernschütz, Germany).''
**[http://audiogroup.web.th-koeln.de/ku100nfhrir.html Near-field HRTFs]: High spatial resolution done for various distances ''(Credit: Johannes Arend, Germany)''.
* [http://sofacoustics.org/data/database/scut SCUT]: Near-field HRTFs from SCUT database of the KEMAR (Radius: 0.2 to 1.0 m). ''(Credit: Bosun Xie, China)''
* [http://sofacoustics.org/data/database/tu-berlin TU-Berlin]:
** HRTFs from [http://doi.org/10.5281/zenodo.55418 TU-Berlin of the KEMAR] dummy-head. HRTFs for several distances (>0.5 m). ''(Credit: Hagen Wierstorf, Germany)''
** '''New: HRTFs from [https://depositonce.tu-berlin.de/handle/11303/6153 TU-Berlin of the FABIAN] dummy-head.''' Acoustically measured and numerically calculated HRTFs. ''(Credit: Fabian Brinkmann, Germany)''
* [http://sofacoustics.org/data/database/clubfritz Club Fritz]: HRTFs of Neumann KU 100 measured as part of the Club Fritz project where many institutions measured the exact same artificial head, see [http://dx.doi.org/10.1109/JSTSP.2015.2400417 Andreopoulou et al, (2015)]. ''(Credit: Brian Katz, France)''.

Special HRTFs:
* [http://sofacoustics.org/data/database/ari%20(bte) ARI (BTE)]: Behind-the-ear HRTFs and DTFs from the [http://www.kfs.oeaw.ac.at/hrtf ARI database].

RIRs/BRIRs/DRIRs:
* [http://sofacoustics.org/data/database/oldenburg Oldenburg] DRIRs from [http://medi.uni-oldenburg.de/hrir/html/download.html Oldenburg]. Recordings in an office under several conditions ''(Credit: Stephan Ewert and Daryl Kelvasa, Germany)''.
* [http://sofacoustics.org/data/database/tuburo TuBuRo]: RIRs (from omnidirectional mic) and BRIRs (from KEMAR) recorded with 64-channel loudspeaker array in a room under various absorbing conditions, see [http://dx.doi.org/10.14279/depositonce-87.2 the source], [https://depositonce.tu-berlin.de/bitstream/11303/245.2/11/AdditionalInformation.pdf notes on the file naming] and [https://secure.aes.org/forum/pubs/ebriefs/?elib=17624 Erbes et al. (2015)]. ''(Credit: Vera Erbes, Rostock, Germany)''.

== Headphone impulse responses (HpIRs) ==
'''New: HpIRs of humans: '''
* [http://sofacoustics.org/data/headphones/ari ARI]: HpIRs from the ARI database. Single headphone, five measurements (with repositioned headphone in-between) for over 100 listeners.
* [http://sofacoustics.org/data/headphones/btdei BT-DEI]: HpIRs from the [http://padva.dei.unipd.it/?page_id=345 BT-DEI] database provided. 16 Listeners, 3 headphones ''(Credit: Michele Geronazzo, Italy)''.
* '''New: HpIRs from [https://depositonce.tu-berlin.de/handle/11303/6153 TU-Berlin of the FABIAN] dummy-head.''' Acoustically measured for 34 headphones. ''(Credit: Fabian Brinkmann, Germany)''

== Special purpose: ==

* [http://sofacoustics.org/data/amt amt]: HRTFs for the various models from the [http://amtoolbox.sourceforge.net AMToolbox]
* [http://sofacoustics.org/data/sofa_api_mo_test sofa_api_mo_test] HRTFs resulting from tests of the [http://sourceforge.net/projects/sofacoustics/ SOFA API for Matlab/Octave]

== Other repositories ==

This is a list of other repositories providing HRTFs, BRIRs, and DRIRs available as SOFA files.

* '''ARI free-field HRTF database'''. HRTFs available for in-the-ear (ITE) and behind-the-ear (BTE) HRTFs. Link: http://www.kfs.oeaw.ac.at/hrtf
* '''Example files''' created by the Matlab/Octave API. Link: http://tinyurl.com/sofaHRTFs
* '''RIEC database''': Database from the Advanced Acoustic Information Systems Laboratory, Research Institute of Electrical Communication, Tohoku University, Japan. Link: http://www.riec.tohoku.ac.jp/pub/hrtf/index.html

SingleRoomDRIR

2014-10-31T13:41:17Z

Hagenw:

==Description==
[[File:SingleRoomDRIR.png|right|thumb|225px]]

This conventions defines a setup used for measuring DRIRs in a single room with a single excitation source and a microphone array containing an arbitrary number of omnidirectional microphones (i.e., receivers). The positions of both the source and the listener are considered as variant. The DRIRs are represented as FIR filters for a single room per file. SingleRoomDRIR consists of:
* General metadata: RoomType: revereberant with a mandatory global attribute RoomDescription.
* Data: Datatype: FIR, the amount of the receivers varies, thus, the size of Data.IR is [M R N].
* Source: The position and the orientation of the source may vary and is given by SourcePosition, SourceUp, and SourceView. The coordinate type is cartesian and unit is meter.
* Emitters: Source consists of a single omnidirectional emitter, which position is fixed, EmitterPosition: (0 0 0). EmitterUp and EmitterView are optional.
* Listener: Position and the orientation of the listener vary and thus ListenerPosition, ListenerView, and ListenerUp are mandatory. The coordinate type is cartesian and unit is meter. An additional rotation of the listener is can be considered, thus, ListenerRotation is optional.
* Receivers: the position of all receivers via ReceiverPosition is provided. The coordinate type is cartesian and unit is meter. The receivers are considered to be omnidirectional, thus, ReceiverUp and ReceiverView are omitted.

== Version 0.1 ==
{| border="1"
!Name
!Default
!Flags
!Dimensions
!Type
!Comment
|-
|GLOBAL:Conventions||SOFA||rm||||attribute||
|-
|GLOBAL:Version||0.5||rm||||attribute||
|-
|GLOBAL:SOFAConventions||SingleRoomDRIR||rm||||attribute||This convention stores arbitrary number of receivers while providing an information about the room. The main application is to store DRIRs for a single room.
|-
|GLOBAL:SOFAConventionsVersion||0.1||rm||||attribute||
|-
|GLOBAL:APIName||||rm||||attribute||
|-
|GLOBAL:APIVersion||||rm||||attribute||
|-
|GLOBAL:ApplicationName||||m||||attribute||
|-
|GLOBAL:ApplicationVersion||||m||||attribute||
|-
|GLOBAL:AuthorContact||||m||||attribute||
|-
|GLOBAL:Comment||||m||||attribute||
|-
|GLOBAL:DataType||FIR||rm||||attribute||
|-
|GLOBAL:History||||m||||attribute||
|-
|GLOBAL:License||No license provided, ask the author for permission||m||||attribute||
|-
|GLOBAL:Organization||||m||||attribute||
|-
|GLOBAL:References||||m||||attribute||
|-
|GLOBAL:RoomType||reverberant||m||||attribute||
|-
|GLOBAL:Source||||m||||attribute||
|-
|GLOBAL:TimeCreated||||m||||attribute||
|-
|GLOBAL:TimeModified||||m||||attribute||
|-
|GLOBAL:Title||||m||||attribute||
|-
|ListenerPosition||[0 0 0] ||m||IC, MC||double||
|-
|ListenerPosition:Type||cartesian||m||||attribute||
|-
|ListenerPosition:Units||meter||m||||attribute||
|-
|ReceiverPosition||[0 0 0]||m||rCI, rCM||double||
|-
|ReceiverPosition:Type||cartesian||m||||attribute||
|-
|ReceiverPosition:Units||meter||m||||attribute||
|-
|SourcePosition||[0 0 0]||m||IC, MC||double||
|-
|SourcePosition:Type||cartesian||m||||attribute||
|-
|SourcePosition:Units||meter||m||||attribute||
|-
|EmitterPosition||[0 0 0]||m||eCI, eCM||double||
|-
|EmitterPosition:Type||cartesian||m||||attribute||
|-
|EmitterPosition:Units||meter||m||||attribute||
|-
|GLOBAL:DatabaseName||||m||||attribute||
|-
|GLOBAL:RoomDescription||||m||||attribute||
|-
|ListenerUp||[0 0 1]||m||IC, MC||double||
|-
|ListenerView||[1 0 0]||m||IC, MC||double||
|-
|SourceUp||[0 0 1]||m||IC, MC||double||
|-
|SourceView||[-1 0 0]||m||IC, MC||double||
|-
|Data.IR||[1 1]||m||mRn||double||
|-
|Data.SamplingRate||48000||m||I||double||
|-
|Data.SamplingRate:Units||hertz||m||||attribute||
|-
|Data.Delay||[0 0]||m||IR, MR||double||
|}

SimpleFreeFieldTF

2014-10-31T13:39:30Z

Hagenw:

== Description ==

This SOFA Conventions is similar to [[SimpleFreeFieldHRIR]]. The most apparent difference is the DataType, which is TF. This Conventions was requested to cover the needs coming from HRTF simulations where results are given as complex values in the frequency domain for some discrete frequencies.

== Version 0.4 ==

{| border="1"
!Name
!Default
!Flags
!Dimensions
!Type
!Comment
|-
|GLOBAL:Conventions||SOFA||rm||||attribute||
|-
|GLOBAL:Version||0.6||rm||||attribute||
|-
|GLOBAL:SOFAConventions||SimpleFreeFieldTF||rm||||attribute||This conventions is for TFs created under conditions where room information is irrelevant
|-
|GLOBAL:SOFAConventionsVersion||0.4||rm||||attribute||
|-
|GLOBAL:APIName||||rm||||attribute||
|-
|GLOBAL:APIVersion||||rm||||attribute||
|-
|GLOBAL:ApplicationName||||||||attribute||
|-
|GLOBAL:ApplicationVersion||||||||attribute||
|-
|GLOBAL:AuthorContact||||m||||attribute||
|-
|GLOBAL:Comment||||m||||attribute||
|-
|GLOBAL:DataType||TF||rm||||attribute||
|-
|GLOBAL:History||||||||attribute||
|-
|GLOBAL:License||No license provided, ask the author for permission||m||||attribute||
|-
|GLOBAL:Organization||||m||||attribute||
|-
|GLOBAL:References||||||||attribute||
|-
|GLOBAL:RoomType||free field||m||||attribute||
|-
|GLOBAL:Origin||||||||attribute||
|-
|GLOBAL:DateCreated||||m||||attribute||
|-
|GLOBAL:DateModified||||m||||attribute||
|-
|GLOBAL:Title||||m||||attribute||
|-
|ListenerPosition||[0 0 0] ||m||IC, MC||double||
|-
|ListenerPosition:Type||cartesian||m||||attribute||
|-
|ListenerPosition:Units||meter||m||||attribute||
|-
|ReceiverPosition||[0 -0.09 0; 0 0.09 0]||m||rCI, rCM||double||
|-
|ReceiverPosition:Type||cartesian||m||||attribute||
|-
|ReceiverPosition:Units||meter||m||||attribute||
|-
|SourcePosition||[0 0 1]||m||IC, MC||double||Source position is assumed to vary for different directions/positions around the listener
|-
|SourcePosition:Type||spherical||m||||attribute||
|-
|SourcePosition:Units||degree, degree, meter||m||||attribute||
|-
|EmitterPosition||[0 0 0]||m||eCI, eCM||double||
|-
|EmitterPosition:Type||cartesian||m||||attribute||
|-
|EmitterPosition:Units||meter||m||||attribute||
|-
|GLOBAL:DatabaseName||||m||||attribute||name of the database to which these data belong
|-
|GLOBAL:SubjectID||||m||||attribute||ID of the subject from the database
|-
|ListenerUp||[0 0 1]||m||IC, MC||double||
|-
|ListenerView||[1 0 0]||m||IC, MC||double||
|-
|Data.Real||[1 1]||m||mRn||double||
|-
|Data.Imag||[0 0]||m||MRN||double||
|-
|N||0||m||N||double||
|-
|N_LongName||frequency||||||attribute||
|-
|N_Units||hertz||||||attribute||
|}

== Old, deprecated versions ==

For historical reasons the older versions of the SimpleFreeFieldTF Convention are listed below.

=== Version 0.3 (deprecated) ===

{| border="1"
!Name
!Default
!Flags
!Dimensions
!Type
!Comment
|-
|GLOBAL:Conventions||SOFA||rm||||attribute||
|-
|GLOBAL:Version||0.5||rm||||attribute||
|-
|GLOBAL:SOFAConventions||GeneralTF||rm||||attribute||This conventions stores TFs for general purposes, i.e., only the mandatory, SOFA general metadata are pre-defined. This convention is based on GeneralFIR.
|-
|GLOBAL:SOFAConventionsVersion||0.1||rm||||attribute||
|-
|GLOBAL:APIName||||rm||||attribute||
|-
|GLOBAL:APIVersion||||rm||||attribute||
|-
|GLOBAL:ApplicationName||||m||||attribute||
|-
|GLOBAL:ApplicationVersion||||m||||attribute||
|-
|GLOBAL:AuthorContact||||m||||attribute||
|-
|GLOBAL:Comment||||m||||attribute||
|-
|GLOBAL:DataType||FIR||rm||||attribute||We store frequency-dependent data here
|-
|GLOBAL:History||||m||||attribute||
|-
|GLOBAL:License||No license provided, ask the author for permission||m||||attribute||
|-
|GLOBAL:Organization||||m||||attribute||
|-
|GLOBAL:References||||m||||attribute||
|-
|GLOBAL:RoomType||free field||m||||attribute||The room information can be arbitrary
|-
|GLOBAL:Source||||m||||attribute||
|-
|GLOBAL:TimeCreated||||m||||attribute||
|-
|GLOBAL:TimeModified||||m||||attribute||
|-
|GLOBAL:Title||||m||||attribute||
|-
|ListenerPosition||[0 0 0] ||m||IC, MC||double||
|-
|ListenerPosition:Type||cartesian||m||||attribute||
|-
|ListenerPosition:Units||meter||m||||attribute||
|-
|ReceiverPosition||[0 -0.09 0; 0 0.09 0]||m||rCI, rCM||double||
|-
|ReceiverPosition:Type||cartesian||m||||attribute||
|-
|ReceiverPosition:Units||meter||m||||attribute||
|-
|SourcePosition||[0 0 1]||m||IC, MC||double||In order to store different directions/positions around the listener, SourcePosition is assumed to vary
|-
|SourcePosition:Type||spherical||m||||attribute||
|-
|SourcePosition:Units||degree, degree, meter||m||||attribute||
|-
|EmitterPosition||[0 0 0]||m||eCI, eCM||double||
|-
|EmitterPosition:Type||cartesian||m||||attribute||
|-
|EmitterPosition:Units||meter||m||||attribute||
|-
|Data.Real||[1 1]||m||mRn||double||
|-
|Data.Imag||[0 0]||m||MRN||double||
|-
|N||0||m||N||double||
|-
|N_LongName||frequency||||||attribute||
|-
|N_Units||hertz||||||attribute||
|}

SimpleFreeFieldTF

2014-10-31T13:38:26Z

Hagenw:

SimpleHeadphoneIR

2014-10-31T13:35:13Z

Hagenw:

== Description ==

Conventions for IRs with a 1-to-1 correspondence between emitter and receiver. The main application for this convention is to store headphone IRs recorded for each emitter and each ear.

== Proposed version 0.1 ==

[[File:SimpleHeadphoneIR-0.1.png|right|thumb|225px]]

In conventions ''SimpleHeadphoneIR'' we store IRs of the system headphone-ear, i.e. headphone IRs. The most important properties of ''SimpleHeadphoneIR'' are:
* '''One-to-one correspondence between emitters and receivers''': When measuring headphones, we usually have two headphones (=two emitters, E1 and E2) and we have two mics places in the ears (=two receivers, R1 and R2). In the first measurement we measure E1-->R1,R2; in the second one we measure: E2-->R1, R2. Usually, IRs E1-->R1 and E2-->R2 are the interesting IRs and are further processed. Note the correspondence of the emitter and receiver indices: This one-to-one correspondence of emitters and receivers is '''a strict property''' of ''SimpleHeadphoneIR''. (If you also need the crosstalk IRs, i.e., E1-->R2 and E2-->R1, ''GeneralFIR'' is recommended).
* '''Single listener''': in a single file, IRs of a single listener are stored. Note that multiple measurements of the same listener can still be stored in a single file. Note the correspondence to ''SimpleFreeFieldHRIR'', in which the HRTFs are also restricted to those of a single listener. To this end:
** DatabaseName: represents the name of the database, ideally corresponding to an existing HRTF database
** ListenerShortName: represents the ID of the subject from the DatabaseName, ideally corresponding to the same subject on the corresponding HRTF database
* '''Multiple measurements''' (of the single listener): multiple measurements are described as repeated measurements of the same listener. The repetition might have various reasons:
** No modifications at all, i.e., simple re-measuring the IRs. It that case, the measurement time/date has changed, which will be captured by MeasurementDate for each M.
** Position of the headphones change: It that case, the measurement time/date and the source/emitter position/orientation have changed, which will be captured by the corresponding variables for each M.
** The headphones might change, e.g. by measuring IRs of different headphones. In that case, the metadata describing the headphones are a function of M and are represented as string variables. Note that these metadata, when being not M-dependent are represented as mandatory global attributes. At the moment, we consider the following metadata as being potentially a function of M:
*** SourceManufacturer: name of the headphones manufacturer (global attribute: mandatory; M-dependent variable: optional)
*** SourceModel: name of the headphone model. Must uniquely describe the headphones of a manufacturer (global attribute: mandatory; M-dependent variable: optional).
*** SourceURI: URI to the specs of the headphones (global attribute: mandatory; M-dependent variable: optional).
*** ReceiverDescription: stores narrative information about the microphones (global attribute: mandatory; M-dependent variable: optional).
*** EmitterDescription: stores narrative information about the headphones emitter (global attribute: mandatory; M-dependent variable: optional).

{| border="1"
!Name
!Default
!Flags
!Dimensions
!Type
!Comment
|-
|GLOBAL:Conventions||<nowiki>SOFA</nowiki>||rm||||attribute||
|-
|GLOBAL:Version||<nowiki>0.6</nowiki>||rm||||attribute||
|-
|GLOBAL:SOFAConventions||<nowiki>SimpleHeadphoneIR</nowiki>||rm||||attribute||Conventions for IRs with a 1-to-1 correspondence between emitter and receiver. The main application for this convention is to store headphone IRs recorded for each emitter and each ear.
|-
|GLOBAL:SOFAConventionsVersion||<nowiki>0.1</nowiki>||rm||||attribute||
|-
|GLOBAL:APIName||<nowiki></nowiki>||rm||||attribute||
|-
|GLOBAL:APIVersion||<nowiki></nowiki>||rm||||attribute||
|-
|GLOBAL:ApplicationName||<nowiki></nowiki>||||||attribute||
|-
|GLOBAL:ApplicationVersion||<nowiki></nowiki>||||||attribute||
|-
|GLOBAL:AuthorContact||<nowiki></nowiki>||m||||attribute||
|-
|GLOBAL:Comment||<nowiki></nowiki>||m||||attribute||
|-
|GLOBAL:DataType||<nowiki>FIR</nowiki>||rm||||attribute||We will store IRs here
|-
|GLOBAL:History||<nowiki></nowiki>||||||attribute||
|-
|GLOBAL:License||<nowiki>No license provided, ask the author for permission</nowiki>||m||||attribute||
|-
|GLOBAL:Organization||<nowiki></nowiki>||m||||attribute||
|-
|GLOBAL:References||<nowiki></nowiki>||||||attribute||
|-
|GLOBAL:RoomType||<nowiki>free field</nowiki>||m||||attribute||Room type is not relevant here
|-
|GLOBAL:Origin||<nowiki></nowiki>||||||attribute||
|-
|GLOBAL:DateCreated||<nowiki></nowiki>||m||||attribute||
|-
|GLOBAL:DateModified||<nowiki></nowiki>||m||||attribute||
|-
|GLOBAL:Title||<nowiki></nowiki>||m||||attribute||
|-
|ListenerPosition||<nowiki>[0 0 0] </nowiki>||m||IC, MC||double||
|-
|ListenerPosition:Type||<nowiki>cartesian</nowiki>||m||||attribute||
|-
|ListenerPosition:Units||<nowiki>meter</nowiki>||m||||attribute||
|-
|ReceiverPosition||<nowiki>[0 0.09 0; 0 -0.09 0]</nowiki>||m||rCI, rCM||double||
|-
|ReceiverPosition:Type||<nowiki>cartesian</nowiki>||m||||attribute||
|-
|ReceiverPosition:Units||<nowiki>meter</nowiki>||m||||attribute||
|-
|SourcePosition||<nowiki>[0 0 0]</nowiki>||m||IC, MC||double||Default: Headphones are located at the position of the listener
|-
|SourcePosition:Type||<nowiki>spherical</nowiki>||m||||attribute||
|-
|SourcePosition:Units||<nowiki>degree, degree, meter</nowiki>||m||||attribute||
|-
|EmitterPosition||<nowiki>[0 0.09 0; 0 -0.09 0]</nowiki>||m||eCI, eCM||double||Default: Reflects the correspondence of each emitter to each receiver
|-
|EmitterPosition:Type||<nowiki>cartesian</nowiki>||m||||attribute||
|-
|EmitterPosition:Units||<nowiki>meter</nowiki>||m||||attribute||
|-
|Data.IR||<nowiki>[1 1]</nowiki>||m||mRn||double||
|-
|Data.SamplingRate||<nowiki>48000</nowiki>||m||I||double||
|-
|Data.SamplingRate:Units||<nowiki>hertz</nowiki>||m||||attribute||
|-
|Data.Delay||<nowiki>[0 0]</nowiki>||m||IR, MR||double||
|-
|GLOBAL:DatabaseName||<nowiki></nowiki>||m||||attribute||Correspondence to a database
|-
|GLOBAL:ListenerShortName||<nowiki></nowiki>||m||||attribute||Correspondence to a subject from the database
|-
|GLOBAL:ListenerDescription||<nowiki></nowiki>||m||||attribute||Narrative description of the listener (or mannequin)
|-
|GLOBAL:SourceDescription||<nowiki></nowiki>||m||||attribute||Narrative description of the headphones
|-
|GLOBAL:SourceManufacturer||<nowiki></nowiki>||m||||attribute||Name of the headphones manufacturer
|-
|SourceManufacturer||<nowiki>{''}</nowiki>||||MS||string||Optional M-dependent version of the attribute SourceManufucturer
|-
|GLOBAL:SourceModel||<nowiki></nowiki>||m||||attribute||Name of the headphone model. Must uniquely describe the headphones of the manufacturer
|-
|SourceModel||<nowiki>{''}</nowiki>||||MS||string||Optional M-dependent version of the attribute SourceModel
|-
|GLOBAL:SourceURI||<nowiki></nowiki>||m||||attribute||URI of the headphone specifications
|-
|GLOBAL:ReceiverDescription||<nowiki></nowiki>||m||||attribute||Narrative description of the microphones
|-
|ReceiverDescription||<nowiki>{''}</nowiki>||||MS||string||Optional M-dependent version of the attribute ReceiverDescription
|-
|GLOBAL:EmitterDescription||<nowiki></nowiki>||m||||attribute||Narrative description of the headphone drivers
|-
|EmitterDescription||<nowiki>{''}</nowiki>||||MS||string||Optional M-dependent version of the attribute EmitterDescription
|-
|MeasurementDate||<nowiki>0</nowiki>||||M||double||Optional M-dependent date and time of the measurement
|}

== Old, deprecated versions ==

For historical reasons the older versions of the SimpleHeadphoneIR (or HeadphoneIR) Convention are listed below.

=== Previously proposed for HeadphoneIR, version 0.1 (deprecated) ===

'''This conventions proposal is deprecated - a new proposal is currently under development. Contribute by discussing with us (use the "Discussion" tab).'''

{| border="1"
!Name
!Default
!Flags
!Dimensions
!Type
!Comment
|-
|GLOBAL:Conventions||SOFA||rm||||attribute||
|-
|GLOBAL:Version||0.5||rm||||attribute||
|-
|GLOBAL:SOFAConventions||SimpleHeadphoneIR||rm||||attribute||Conventions for IRs with a 1-to-1 correspondence between emitter and receiver. The main application for this convention is to store headphone IRs recorded for each emitter and each ear.
|-
|GLOBAL:SOFAConventionsVersion||0.1||rm||||attribute||
|-
|GLOBAL:APIName||||rm||||attribute||
|-
|GLOBAL:APIVersion||||rm||||attribute||
|-
|GLOBAL:ApplicationName||||m||||attribute||
|-
|GLOBAL:ApplicationVersion||||m||||attribute||
|-
|GLOBAL:AuthorContact||||m||||attribute||
|-
|GLOBAL:Comment||||m||||attribute||
|-
|GLOBAL:DataType||FIR||rm||||attribute||We will store IRs here
|-
|GLOBAL:History||||m||||attribute||
|-
|GLOBAL:License||No license provided, ask the author for permission||m||||attribute||
|-
|GLOBAL:Organization||||m||||attribute||
|-
|GLOBAL:References||||m||||attribute||
|-
|GLOBAL:RoomType||free field||m||||attribute||Room type is not relevant here
|-
|GLOBAL:Source||||m||||attribute||
|-
|GLOBAL:TimeCreated||||m||||attribute||
|-
|GLOBAL:TimeModified||||m||||attribute||
|-
|GLOBAL:Title||||m||||attribute||
|-
|ListenerPosition||[0 0 0] ||m||IC, MC||double||
|-
|ListenerPosition:Type||cartesian||m||||attribute||
|-
|ListenerPosition:Units||meter||m||||attribute||
|-
|ReceiverPosition||[0 -0.09 0; 0 0.09 0]||m||rCI, rCM||double||
|-
|ReceiverPosition:Type||cartesian||m||||attribute||
|-
|ReceiverPosition:Units||meter||m||||attribute||
|-
|SourcePosition||[0 0 0]||m||IC, MC||double||Headphones are located at the position of the listener
|-
|SourcePosition:Type||spherical||m||||attribute||
|-
|SourcePosition:Units||degree, degree, meter||m||||attribute||
|-
|EmitterPosition||[0 -0.09 0; 0 0.09 0]||m||eCI, eCM||double||Reflects the correspondence of each emitter to each receiver
|-
|EmitterPosition:Type||cartesian||m||||attribute||
|-
|EmitterPosition:Units||meter||m||||attribute||
|-
|GLOBAL:DatabaseName||||m||||attribute||to which HRTF database these data correspond?
|-
|GLOBAL:SubjectID||||m||||attribute||to which subject from the database these data correspond?
|-
|GLOBAL:SourceProducer||||||||attribute||who produced the headphones?
|-
|GLOBAL:SourceModel||||||||attribute||how is this headphone called?
|-
|GLOBAL:ProcessingState||||||||attribute||how are the IRs processed (raw, equalized, etc)?
|-
|GLOBAL:ListenerDescription||||||||attribute||describe the listener here (human, dummy head, etc)
|-
|GLOBAL:SourceDescription||||||||attribute||describe the headphones here
|-
|GLOBAL:ReceiverDescription||||||||attribute||describe the microphones here
|-
|GLOBAL:EmitterDescription||||||||attribute||describe the drivers of the headphones here
|-
|Data.IR||[1 1]||m||mRn||double||
|-
|Data.SamplingRate||48000||m||I||double||
|-
|Data.SamplingRate:Units||hertz||m||||attribute||
|-
|Data.Delay||[0 0]||m||IR, MR||double||
|}

SimpleHeadphoneIR

2014-10-31T13:32:36Z

Hagenw:

Conventions for IRs with a 1-to-1 correspondence between emitter and receiver. The main application for this convention is to store headphone IRs recorded for each emitter and each ear.

== Proposed version 0.1 ==

[[File:SimpleHeadphoneIR-0.1.png|right|thumb|225px]]

In conventions ''SimpleHeadphoneIR'' we store IRs of the system headphone-ear, i.e. headphone IRs. The most important properties of ''SimpleHeadphoneIR'' are:
* '''One-to-one correspondence between emitters and receivers''': When measuring headphones, we usually have two headphones (=two emitters, E1 and E2) and we have two mics places in the ears (=two receivers, R1 and R2). In the first measurement we measure E1-->R1,R2; in the second one we measure: E2-->R1, R2. Usually, IRs E1-->R1 and E2-->R2 are the interesting IRs and are further processed. Note the correspondence of the emitter and receiver indices: This one-to-one correspondence of emitters and receivers is '''a strict property''' of ''SimpleHeadphoneIR''. (If you also need the crosstalk IRs, i.e., E1-->R2 and E2-->R1, ''GeneralFIR'' is recommended).
* '''Single listener''': in a single file, IRs of a single listener are stored. Note that multiple measurements of the same listener can still be stored in a single file. Note the correspondence to ''SimpleFreeFieldHRIR'', in which the HRTFs are also restricted to those of a single listener. To this end:
** DatabaseName: represents the name of the database, ideally corresponding to an existing HRTF database
** ListenerShortName: represents the ID of the subject from the DatabaseName, ideally corresponding to the same subject on the corresponding HRTF database
* '''Multiple measurements''' (of the single listener): multiple measurements are described as repeated measurements of the same listener. The repetition might have various reasons:
** No modifications at all, i.e., simple re-measuring the IRs. It that case, the measurement time/date has changed, which will be captured by MeasurementDate for each M.
** Position of the headphones change: It that case, the measurement time/date and the source/emitter position/orientation have changed, which will be captured by the corresponding variables for each M.
** The headphones might change, e.g. by measuring IRs of different headphones. In that case, the metadata describing the headphones are a function of M and are represented as string variables. Note that these metadata, when being not M-dependent are represented as mandatory global attributes. At the moment, we consider the following metadata as being potentially a function of M:
*** SourceManufacturer: name of the headphones manufacturer (global attribute: mandatory; M-dependent variable: optional)
*** SourceModel: name of the headphone model. Must uniquely describe the headphones of a manufacturer (global attribute: mandatory; M-dependent variable: optional).
*** SourceURI: URI to the specs of the headphones (global attribute: mandatory; M-dependent variable: optional).
*** ReceiverDescription: stores narrative information about the microphones (global attribute: mandatory; M-dependent variable: optional).
*** EmitterDescription: stores narrative information about the headphones emitter (global attribute: mandatory; M-dependent variable: optional).

{| border="1"
!Name
!Default
!Flags
!Dimensions
!Type
!Comment
|-
|GLOBAL:Conventions||<nowiki>SOFA</nowiki>||rm||||attribute||
|-
|GLOBAL:Version||<nowiki>0.6</nowiki>||rm||||attribute||
|-
|GLOBAL:SOFAConventions||<nowiki>SimpleHeadphoneIR</nowiki>||rm||||attribute||Conventions for IRs with a 1-to-1 correspondence between emitter and receiver. The main application for this convention is to store headphone IRs recorded for each emitter and each ear.
|-
|GLOBAL:SOFAConventionsVersion||<nowiki>0.1</nowiki>||rm||||attribute||
|-
|GLOBAL:APIName||<nowiki></nowiki>||rm||||attribute||
|-
|GLOBAL:APIVersion||<nowiki></nowiki>||rm||||attribute||
|-
|GLOBAL:ApplicationName||<nowiki></nowiki>||||||attribute||
|-
|GLOBAL:ApplicationVersion||<nowiki></nowiki>||||||attribute||
|-
|GLOBAL:AuthorContact||<nowiki></nowiki>||m||||attribute||
|-
|GLOBAL:Comment||<nowiki></nowiki>||m||||attribute||
|-
|GLOBAL:DataType||<nowiki>FIR</nowiki>||rm||||attribute||We will store IRs here
|-
|GLOBAL:History||<nowiki></nowiki>||||||attribute||
|-
|GLOBAL:License||<nowiki>No license provided, ask the author for permission</nowiki>||m||||attribute||
|-
|GLOBAL:Organization||<nowiki></nowiki>||m||||attribute||
|-
|GLOBAL:References||<nowiki></nowiki>||||||attribute||
|-
|GLOBAL:RoomType||<nowiki>free field</nowiki>||m||||attribute||Room type is not relevant here
|-
|GLOBAL:Origin||<nowiki></nowiki>||||||attribute||
|-
|GLOBAL:DateCreated||<nowiki></nowiki>||m||||attribute||
|-
|GLOBAL:DateModified||<nowiki></nowiki>||m||||attribute||
|-
|GLOBAL:Title||<nowiki></nowiki>||m||||attribute||
|-
|ListenerPosition||<nowiki>[0 0 0] </nowiki>||m||IC, MC||double||
|-
|ListenerPosition:Type||<nowiki>cartesian</nowiki>||m||||attribute||
|-
|ListenerPosition:Units||<nowiki>meter</nowiki>||m||||attribute||
|-
|ReceiverPosition||<nowiki>[0 0.09 0; 0 -0.09 0]</nowiki>||m||rCI, rCM||double||
|-
|ReceiverPosition:Type||<nowiki>cartesian</nowiki>||m||||attribute||
|-
|ReceiverPosition:Units||<nowiki>meter</nowiki>||m||||attribute||
|-
|SourcePosition||<nowiki>[0 0 0]</nowiki>||m||IC, MC||double||Default: Headphones are located at the position of the listener
|-
|SourcePosition:Type||<nowiki>spherical</nowiki>||m||||attribute||
|-
|SourcePosition:Units||<nowiki>degree, degree, meter</nowiki>||m||||attribute||
|-
|EmitterPosition||<nowiki>[0 0.09 0; 0 -0.09 0]</nowiki>||m||eCI, eCM||double||Default: Reflects the correspondence of each emitter to each receiver
|-
|EmitterPosition:Type||<nowiki>cartesian</nowiki>||m||||attribute||
|-
|EmitterPosition:Units||<nowiki>meter</nowiki>||m||||attribute||
|-
|Data.IR||<nowiki>[1 1]</nowiki>||m||mRn||double||
|-
|Data.SamplingRate||<nowiki>48000</nowiki>||m||I||double||
|-
|Data.SamplingRate:Units||<nowiki>hertz</nowiki>||m||||attribute||
|-
|Data.Delay||<nowiki>[0 0]</nowiki>||m||IR, MR||double||
|-
|GLOBAL:DatabaseName||<nowiki></nowiki>||m||||attribute||Correspondence to a database
|-
|GLOBAL:ListenerShortName||<nowiki></nowiki>||m||||attribute||Correspondence to a subject from the database
|-
|GLOBAL:ListenerDescription||<nowiki></nowiki>||m||||attribute||Narrative description of the listener (or mannequin)
|-
|GLOBAL:SourceDescription||<nowiki></nowiki>||m||||attribute||Narrative description of the headphones
|-
|GLOBAL:SourceManufacturer||<nowiki></nowiki>||m||||attribute||Name of the headphones manufacturer
|-
|SourceManufacturer||<nowiki>{''}</nowiki>||||MS||string||Optional M-dependent version of the attribute SourceManufucturer
|-
|GLOBAL:SourceModel||<nowiki></nowiki>||m||||attribute||Name of the headphone model. Must uniquely describe the headphones of the manufacturer
|-
|SourceModel||<nowiki>{''}</nowiki>||||MS||string||Optional M-dependent version of the attribute SourceModel
|-
|GLOBAL:SourceURI||<nowiki></nowiki>||m||||attribute||URI of the headphone specifications
|-
|GLOBAL:ReceiverDescription||<nowiki></nowiki>||m||||attribute||Narrative description of the microphones
|-
|ReceiverDescription||<nowiki>{''}</nowiki>||||MS||string||Optional M-dependent version of the attribute ReceiverDescription
|-
|GLOBAL:EmitterDescription||<nowiki></nowiki>||m||||attribute||Narrative description of the headphone drivers
|-
|EmitterDescription||<nowiki>{''}</nowiki>||||MS||string||Optional M-dependent version of the attribute EmitterDescription
|-
|MeasurementDate||<nowiki>0</nowiki>||||M||double||Optional M-dependent date and time of the measurement
|}

== Old, deprecated versions ==

For historical reasons the older versions of the SimpleHeadphoneIR (or HeadphoneIR) Convention are listed below.

=== Previously proposed for HeadphoneIR, version 0.1 (deprecated) ===

'''This conventions proposal is deprecated - a new proposal is currently under development. Contribute by discussing with us (use the "Discussion" tab).'''

{| border="1"
!Name
!Default
!Flags
!Dimensions
!Type
!Comment
|-
|GLOBAL:Conventions||SOFA||rm||||attribute||
|-
|GLOBAL:Version||0.5||rm||||attribute||
|-
|GLOBAL:SOFAConventions||SimpleHeadphoneIR||rm||||attribute||Conventions for IRs with a 1-to-1 correspondence between emitter and receiver. The main application for this convention is to store headphone IRs recorded for each emitter and each ear.
|-
|GLOBAL:SOFAConventionsVersion||0.1||rm||||attribute||
|-
|GLOBAL:APIName||||rm||||attribute||
|-
|GLOBAL:APIVersion||||rm||||attribute||
|-
|GLOBAL:ApplicationName||||m||||attribute||
|-
|GLOBAL:ApplicationVersion||||m||||attribute||
|-
|GLOBAL:AuthorContact||||m||||attribute||
|-
|GLOBAL:Comment||||m||||attribute||
|-
|GLOBAL:DataType||FIR||rm||||attribute||We will store IRs here
|-
|GLOBAL:History||||m||||attribute||
|-
|GLOBAL:License||No license provided, ask the author for permission||m||||attribute||
|-
|GLOBAL:Organization||||m||||attribute||
|-
|GLOBAL:References||||m||||attribute||
|-
|GLOBAL:RoomType||free field||m||||attribute||Room type is not relevant here
|-
|GLOBAL:Source||||m||||attribute||
|-
|GLOBAL:TimeCreated||||m||||attribute||
|-
|GLOBAL:TimeModified||||m||||attribute||
|-
|GLOBAL:Title||||m||||attribute||
|-
|ListenerPosition||[0 0 0] ||m||IC, MC||double||
|-
|ListenerPosition:Type||cartesian||m||||attribute||
|-
|ListenerPosition:Units||meter||m||||attribute||
|-
|ReceiverPosition||[0 -0.09 0; 0 0.09 0]||m||rCI, rCM||double||
|-
|ReceiverPosition:Type||cartesian||m||||attribute||
|-
|ReceiverPosition:Units||meter||m||||attribute||
|-
|SourcePosition||[0 0 0]||m||IC, MC||double||Headphones are located at the position of the listener
|-
|SourcePosition:Type||spherical||m||||attribute||
|-
|SourcePosition:Units||degree, degree, meter||m||||attribute||
|-
|EmitterPosition||[0 -0.09 0; 0 0.09 0]||m||eCI, eCM||double||Reflects the correspondence of each emitter to each receiver
|-
|EmitterPosition:Type||cartesian||m||||attribute||
|-
|EmitterPosition:Units||meter||m||||attribute||
|-
|GLOBAL:DatabaseName||||m||||attribute||to which HRTF database these data correspond?
|-
|GLOBAL:SubjectID||||m||||attribute||to which subject from the database these data correspond?
|-
|GLOBAL:SourceProducer||||||||attribute||who produced the headphones?
|-
|GLOBAL:SourceModel||||||||attribute||how is this headphone called?
|-
|GLOBAL:ProcessingState||||||||attribute||how are the IRs processed (raw, equalized, etc)?
|-
|GLOBAL:ListenerDescription||||||||attribute||describe the listener here (human, dummy head, etc)
|-
|GLOBAL:SourceDescription||||||||attribute||describe the headphones here
|-
|GLOBAL:ReceiverDescription||||||||attribute||describe the microphones here
|-
|GLOBAL:EmitterDescription||||||||attribute||describe the drivers of the headphones here
|-
|Data.IR||[1 1]||m||mRn||double||
|-
|Data.SamplingRate||48000||m||I||double||
|-
|Data.SamplingRate:Units||hertz||m||||attribute||
|-
|Data.Delay||[0 0]||m||IR, MR||double||
|}

SimpleHeadphoneIR

2014-10-31T13:32:07Z

Hagenw:

SOFA conventions

2014-10-31T13:26:19Z

Hagenw: /* Stable SOFA Conventions */

SOFA conventions specify the description of data and metadata for a particular kind of measured data.

This is important in order to meet the different requirements coming from different application fields, specified. For example, description of HRTFs, BRIRs, and DRIRs requires different metadata. Also, some applications may prefer to see the data stored in a different way. These conventions, once approved by the peer group are defined in SOFA conventions.

==Stable SOFA Conventions==
Stable SOFA conventions are those for which SOFA files are publicly available and can be read/modified by a software package. The following stable SOFA conventions are available now in the latest official release of SOFA:
* [[GeneralFIR]]: General convention with FIR as DataType (no restrictions but DataType)
* [[GeneralTF]]: General convention with TF as DataType (no restrictions but DataType)
* [[HeadphoneIR]]: deprecated and will be replaced by [[SimpleHeadphoneIR]]
* [[MultiSpeakerBRIR]]
* [[SimpleFreeFieldHRIR]]: Free-field HRTFs stored as impulse responses, measured with an omnidirectional source for a single listener.
* [[SimpleFreeFieldTF]]: as SimpleFreeFieldHRIR, but uses TF as DataType covering special needs coming from HRTF simulations
* [[SingleRoomDRIR]]: Room impulse responses measured with an arbitrary number of receivers (such as a microphone array) and an omnidirectional source in a single room.

==Proposed SOFA Conventions==
Proposed SOFA conventions are currently being discussed. We consider following rules for new SOFA conventions:
* Data must exist (do not foresee the future)
* Data can not be described by existing SOFA conventions
* Relevant information about the data available

The following SOFA conventions are being discussed. Measured data exist but their description must be fixed in order to create publicly available SOFA files and corresponding software interfaces.

* [[SimpleBRIR]]: Binaural room impulse responses measured with an omnidirectional source in a single reverberant space. Somebody wanted to have this, but the work stopped at the moment.
* [[SimpleFreeFieldSOS]]: as SimpleFreeFieldHRIR, but uses SOS as DataType (second-order sections) covering special needs coming from HRTF rendering
* [[SimpleHeadphoneIR]]: Conventions to store headphone IRs recorded for each emitter and each ear, single listener and no directionality of emitter/receiver considered.

== Unsorted topics ==
Here we list the suggestions and feedback from the peer group:
* Include anthropometric data
* Crosstalk cancellation filters
* Include calibration data from the measurement
* Include room pictures

Please use the "Discussion" function to discuss these topics.

== Feedback and Contribution ==

If you would like to contribute or propose new SOFA conventions:
* Send an e-mail to the [mailto:sofacoustics-devel@lists.sourceforge.net mailing list]. You don't have to be a member of the mailing list to send a message to the moderator.
* Go to one of the SOFA pages of your interest and use the "Discussion" for your contribution.
We appreciate your feedback!

SOFA conventions

2014-10-31T13:20:49Z

Hagenw:

SOFA conventions specify the description of data and metadata for a particular kind of measured data.

This is important in order to meet the different requirements coming from different application fields, specified. For example, description of HRTFs, BRIRs, and DRIRs requires different metadata. Also, some applications may prefer to see the data stored in a different way. These conventions, once approved by the peer group are defined in SOFA conventions.

==Stable SOFA Conventions==
Stable SOFA conventions are those for which SOFA files are publicly available and can be read/modified by a software package. The following stable SOFA conventions are available now in the latest official release of SOFA:
* [[GeneralFIR]]: General convention with FIR as DataType (no restrictions but DataType)
* [[GeneralTF]]: General convention with TF as DataType (no restrictions but DataType)
* [[HeadphoneIR]]: deprecated and will be replaced by [[SimpleHeadphoneIR]]
* [[MultiSpeakerBRIR]]
* [[SingleRoomDRIR]]: Room impulse responses measured with an arbitrary number of receivers (such as a microphone array) and an omnidirectional source in a single room.
* [[SimpleFreeFieldHRIR]]: Free-field HRTFs stored as impulse responses, measured with an omnidirectional source for a single listener.
* [[SimpleFreeFieldTF]]: as SimpleFreeFieldHRIR, but uses TF as DataType covering special needs coming from HRTF simulations

==Proposed SOFA Conventions==
Proposed SOFA conventions are currently being discussed. We consider following rules for new SOFA conventions:
* Data must exist (do not foresee the future)
* Data can not be described by existing SOFA conventions
* Relevant information about the data available

The following SOFA conventions are being discussed. Measured data exist but their description must be fixed in order to create publicly available SOFA files and corresponding software interfaces.

* [[SimpleBRIR]]: Binaural room impulse responses measured with an omnidirectional source in a single reverberant space. Somebody wanted to have this, but the work stopped at the moment.
* [[SimpleFreeFieldSOS]]: as SimpleFreeFieldHRIR, but uses SOS as DataType (second-order sections) covering special needs coming from HRTF rendering
* [[SimpleHeadphoneIR]]: Conventions to store headphone IRs recorded for each emitter and each ear, single listener and no directionality of emitter/receiver considered.

== Unsorted topics ==
Here we list the suggestions and feedback from the peer group:
* Include anthropometric data
* Crosstalk cancellation filters
* Include calibration data from the measurement
* Include room pictures

Please use the "Discussion" function to discuss these topics.

== Feedback and Contribution ==

If you would like to contribute or propose new SOFA conventions:
* Send an e-mail to the [mailto:sofacoustics-devel@lists.sourceforge.net mailing list]. You don't have to be a member of the mailing list to send a message to the moderator.
* Go to one of the SOFA pages of your interest and use the "Discussion" for your contribution.
We appreciate your feedback!

SOFA conventions

2014-10-31T13:19:30Z

Hagenw:

SOFA conventions specify the description of data and metadata for a particular kind of measured data.

This is important in order to meet the different requirements coming from different application fields, specified. For example, description of HRTFs, BRIRs, and DRIRs requires different metadata. Also, some applications may prefer to see the data stored in a different way. These conventions, once approved by the peer group are defined in SOFA conventions.

==Stable SOFA Conventions==
Stable SOFA conventions are those for which SOFA files are publicly available and can be read/modified by a software package. The following stable SOFA conventions are available now in the latest official release of SOFA:
* [[GeneralFIR]]: General convention with FIR as DataType (no restrictions but DataType)
* [[GeneralTF]]: General convention with TF as DataType (no restrictions but DataType)
* [[SimpleFreeFieldHRIR]]: Free-field HRTFs stored as impulse responses, measured with an omnidirectional source for a single listener.
* [[SimpleFreeFieldTF]]: as SimpleFreeFieldHRIR, but uses TF as DataType covering special needs coming from HRTF simulations
* [[HeadphoneIR]]: deprecated and will be replaced by [[SimpleHeadphoneIR]]
* [[SingleRoomDRIR]]: Room impulse responses measured with an arbitrary number of receivers (such as a microphone array) and an omnidirectional source in a single room.
* [[MultiSpeakerBRIR]]

==Proposed SOFA Conventions==
Proposed SOFA conventions are currently being discussed. We consider following rules for new SOFA conventions:
* Data must exist (do not foresee the future)
* Data can not be described by existing SOFA conventions
* Relevant information about the data available

The following SOFA conventions are being discussed. Measured data exist but their description must be fixed in order to create publicly available SOFA files and corresponding software interfaces.

* [[SimpleHeadphoneIR]]: Conventions to store headphone IRs recorded for each emitter and each ear, single listener and no directionality of emitter/receiver considered.
* [[SimpleFreeFieldSOS]]: as SimpleFreeFieldHRIR, but uses SOS as DataType (second-order sections) covering special needs coming from HRTF rendering
* [[SimpleBRIR]]: Binaural room impulse responses measured with an omnidirectional source in a single reverberant space. Somebody wanted to have this, but the work stopped at the moment.

== Unsorted topics ==
Here we list the suggestions and feedback from the peer group:
* Include anthropometric data
* Crosstalk cancellation filters
* Include calibration data from the measurement
* Include room pictures

Please use the "Discussion" function to discuss these topics.

== Feedback and Contribution ==

If you would like to contribute or propose new SOFA conventions:
* Send an e-mail to the [mailto:sofacoustics-devel@lists.sourceforge.net mailing list]. You don't have to be a member of the mailing list to send a message to the moderator.
* Go to one of the SOFA pages of your interest and use the "Discussion" for your contribution.
We appreciate your feedback!

SOFA conventions

2014-10-31T13:18:08Z

Hagenw: /* Stable SOFA Conventions */

SOFA conventions specify the description of data and metadata for a particular kind of measured data.

This is important in order to meet the different requirements coming from different application fields, specified. For example, description of HRTFs, BRIRs, and DRIRs requires different metadata. Also, some applications may prefer to see the data stored in a different way. These conventions, once approved by the peer group are defined in SOFA conventions.

==Stable SOFA Conventions==
Stable SOFA conventions are those for which SOFA files are publicly available and can be read/modified by a software package. The following stable SOFA conventions are available now in the latest official release of SOFA:
* [[GeneralFIR]]: General convention with FIR as DataType (no restrictions but DataType)
* [[GeneralTF]]: General convention with TF as DataType (no restrictions but DataType)
* [[SimpleFreeFieldHRIR]]: Free-field HRTFs stored as impulse responses, measured with an omnidirectional source for a single listener.
* [[HeadphoneIR]]: deprecated and will be replaced by [[SimpleHeadphoneIR]]

==Proposed SOFA Conventions==
Proposed SOFA conventions are currently being discussed. We consider following rules for new SOFA conventions:
* Data must exist (do not foresee the future)
* Data can not be described by existing SOFA conventions
* Relevant information about the data available

The following SOFA conventions are being discussed. Measured data exist but their description must be fixed in order to create publicly available SOFA files and corresponding software interfaces.

* [[SimpleFreeFieldTF]]: as SimpleFreeFieldHRIR, but uses TF as DataType covering special needs coming from HRTF simulations
* [[SingleRoomDRIR]]: Room impulse responses measured with an arbitrary number of receivers (such as a microphone array) and an omnidirectional source in a single room.
* [[SimpleHeadphoneIR]]: Conventions to store headphone IRs recorded for each emitter and each ear, single listener and no directionality of emitter/receiver considered.
* [[SimpleFreeFieldSOS]]: as SimpleFreeFieldHRIR, but uses SOS as DataType (second-order sections) covering special needs coming from HRTF rendering
* [[MultiSpeakerBRIR]]

* [[SimpleBRIR]]: Binaural room impulse responses measured with an omnidirectional source in a single reverberant space. Somebody wanted to have this, but the work stopped at the moment.

== Unsorted topics ==
Here we list the suggestions and feedback from the peer group:
* Include anthropometric data
* Crosstalk cancellation filters
* Include calibration data from the measurement
* Include room pictures

Please use the "Discussion" function to discuss these topics.

== Feedback and Contribution ==

If you would like to contribute or propose new SOFA conventions:
* Send an e-mail to the [mailto:sofacoustics-devel@lists.sourceforge.net mailing list]. You don't have to be a member of the mailing list to send a message to the moderator.
* Go to one of the SOFA pages of your interest and use the "Discussion" for your contribution.
We appreciate your feedback!

SOFA conventions

2014-10-31T13:16:21Z

Hagenw: /* Stable SOFA Conventions */

SOFA conventions specify the description of data and metadata for a particular kind of measured data.

This is important in order to meet the different requirements coming from different application fields, specified. For example, description of HRTFs, BRIRs, and DRIRs requires different metadata. Also, some applications may prefer to see the data stored in a different way. These conventions, once approved by the peer group are defined in SOFA conventions.

==Stable SOFA Conventions==
Stable SOFA conventions are those for which SOFA files are publicly available and can be read/modified by a software package. The following stable SOFA conventions are available now:
* [[GeneralFIR]]: General convention with FIR as DataType (no restrictions but DataType)
* [[GeneralTF]]: General convention with TF as DataType (no restrictions but DataType)
* [[SimpleFreeFieldHRIR]]: Free-field HRTFs stored as impulse responses, measured with an omnidirectional source for a single listener.
* [[HeadphoneIR]]: deprecated and will be replaced by [[SimpleHeadphoneIR]]

==Proposed SOFA Conventions==
Proposed SOFA conventions are currently being discussed. We consider following rules for new SOFA conventions:
* Data must exist (do not foresee the future)
* Data can not be described by existing SOFA conventions
* Relevant information about the data available

The following SOFA conventions are being discussed. Measured data exist but their description must be fixed in order to create publicly available SOFA files and corresponding software interfaces.

* [[SimpleFreeFieldTF]]: as SimpleFreeFieldHRIR, but uses TF as DataType covering special needs coming from HRTF simulations
* [[SingleRoomDRIR]]: Room impulse responses measured with an arbitrary number of receivers (such as a microphone array) and an omnidirectional source in a single room.
* [[SimpleHeadphoneIR]]: Conventions to store headphone IRs recorded for each emitter and each ear, single listener and no directionality of emitter/receiver considered.
* [[SimpleFreeFieldSOS]]: as SimpleFreeFieldHRIR, but uses SOS as DataType (second-order sections) covering special needs coming from HRTF rendering
* [[MultiSpeakerBRIR]]

* [[SimpleBRIR]]: Binaural room impulse responses measured with an omnidirectional source in a single reverberant space. Somebody wanted to have this, but the work stopped at the moment.

== Unsorted topics ==
Here we list the suggestions and feedback from the peer group:
* Include anthropometric data
* Crosstalk cancellation filters
* Include calibration data from the measurement
* Include room pictures

Please use the "Discussion" function to discuss these topics.

== Feedback and Contribution ==

If you would like to contribute or propose new SOFA conventions:
* Send an e-mail to the [mailto:sofacoustics-devel@lists.sourceforge.net mailing list]. You don't have to be a member of the mailing list to send a message to the moderator.
* Go to one of the SOFA pages of your interest and use the "Discussion" for your contribution.
We appreciate your feedback!

SOFA conventions

2014-10-31T13:16:05Z

Hagenw: /* Stable SOFA Conventions */

SOFA conventions specify the description of data and metadata for a particular kind of measured data.

This is important in order to meet the different requirements coming from different application fields, specified. For example, description of HRTFs, BRIRs, and DRIRs requires different metadata. Also, some applications may prefer to see the data stored in a different way. These conventions, once approved by the peer group are defined in SOFA conventions.

==Stable SOFA Conventions==
Stable SOFA conventions are those for which SOFA files are publicly available and can be read/modified by a software package. The following stable SOFA conventions are available now:
* [[GeneralFIR]]: General convention with FIR as DataType (no restrictions but DataType)
* [[GeneralTF]]: General convention with TF as DataType (no restrictions but DataType)
* [[SimpleFreeFieldHRIR]]: Free-field HRTFs stored as impulse responses, measured with an omnidirectional source for a single listener.
* HeadphoneIR: deprecated and will be replaced by [[SimpleHeadphoneIR]]

==Proposed SOFA Conventions==
Proposed SOFA conventions are currently being discussed. We consider following rules for new SOFA conventions:
* Data must exist (do not foresee the future)
* Data can not be described by existing SOFA conventions
* Relevant information about the data available

The following SOFA conventions are being discussed. Measured data exist but their description must be fixed in order to create publicly available SOFA files and corresponding software interfaces.

* [[SimpleFreeFieldTF]]: as SimpleFreeFieldHRIR, but uses TF as DataType covering special needs coming from HRTF simulations
* [[SingleRoomDRIR]]: Room impulse responses measured with an arbitrary number of receivers (such as a microphone array) and an omnidirectional source in a single room.
* [[SimpleHeadphoneIR]]: Conventions to store headphone IRs recorded for each emitter and each ear, single listener and no directionality of emitter/receiver considered.
* [[SimpleFreeFieldSOS]]: as SimpleFreeFieldHRIR, but uses SOS as DataType (second-order sections) covering special needs coming from HRTF rendering
* [[MultiSpeakerBRIR]]

* [[SimpleBRIR]]: Binaural room impulse responses measured with an omnidirectional source in a single reverberant space. Somebody wanted to have this, but the work stopped at the moment.

== Unsorted topics ==
Here we list the suggestions and feedback from the peer group:
* Include anthropometric data
* Crosstalk cancellation filters
* Include calibration data from the measurement
* Include room pictures

Please use the "Discussion" function to discuss these topics.

== Feedback and Contribution ==

If you would like to contribute or propose new SOFA conventions:
* Send an e-mail to the [mailto:sofacoustics-devel@lists.sourceforge.net mailing list]. You don't have to be a member of the mailing list to send a message to the moderator.
* Go to one of the SOFA pages of your interest and use the "Discussion" for your contribution.
We appreciate your feedback!

SOFA conventions

2014-10-31T13:15:24Z

Hagenw:

SOFA conventions specify the description of data and metadata for a particular kind of measured data.

This is important in order to meet the different requirements coming from different application fields, specified. For example, description of HRTFs, BRIRs, and DRIRs requires different metadata. Also, some applications may prefer to see the data stored in a different way. These conventions, once approved by the peer group are defined in SOFA conventions.

==Stable SOFA Conventions==
Stable SOFA conventions are those for which SOFA files are publicly available and can be read/modified by a software package. The following stable SOFA conventions are available now:
* [[GeneralFIR]]: General convention with FIR as DataType (no restrictions but DataType)
* [[GeneralTF]]: General convention with TF as DataType (no restrictions but DataType)
* [[SimpleFreeFieldHRIR]]: Free-field HRTFs stored as impulse responses, measured with an omnidirectional source for a single listener.
* [[HeadphoneIR]]: deprecated and will be replaced by [[SimpleHeadphoneIR]]

==Proposed SOFA Conventions==
Proposed SOFA conventions are currently being discussed. We consider following rules for new SOFA conventions:
* Data must exist (do not foresee the future)
* Data can not be described by existing SOFA conventions
* Relevant information about the data available

The following SOFA conventions are being discussed. Measured data exist but their description must be fixed in order to create publicly available SOFA files and corresponding software interfaces.

* [[SimpleFreeFieldTF]]: as SimpleFreeFieldHRIR, but uses TF as DataType covering special needs coming from HRTF simulations
* [[SingleRoomDRIR]]: Room impulse responses measured with an arbitrary number of receivers (such as a microphone array) and an omnidirectional source in a single room.
* [[SimpleHeadphoneIR]]: Conventions to store headphone IRs recorded for each emitter and each ear, single listener and no directionality of emitter/receiver considered.
* [[SimpleFreeFieldSOS]]: as SimpleFreeFieldHRIR, but uses SOS as DataType (second-order sections) covering special needs coming from HRTF rendering
* [[MultiSpeakerBRIR]]

* [[SimpleBRIR]]: Binaural room impulse responses measured with an omnidirectional source in a single reverberant space. Somebody wanted to have this, but the work stopped at the moment.

== Unsorted topics ==
Here we list the suggestions and feedback from the peer group:
* Include anthropometric data
* Crosstalk cancellation filters
* Include calibration data from the measurement
* Include room pictures

Please use the "Discussion" function to discuss these topics.

== Feedback and Contribution ==

If you would like to contribute or propose new SOFA conventions:
* Send an e-mail to the [mailto:sofacoustics-devel@lists.sourceforge.net mailing list]. You don't have to be a member of the mailing list to send a message to the moderator.
* Go to one of the SOFA pages of your interest and use the "Discussion" for your contribution.
We appreciate your feedback!

SOFA conventions

2014-10-31T13:13:54Z

Hagenw: /* Proposed SOFA Conventions */

SOFA conventions specify the description of data and metadata for a particular kind of measured data.

This is important in order to meet the different requirements coming from different application fields, specified. For example, description of HRTFs, BRIRs, and DRIRs requires different metadata. Also, some applications may prefer to see the data stored in a different way. These conventions, once approved by the peer group are defined in SOFA conventions.

==Stable SOFA Conventions==
Stable SOFA conventions are those for which SOFA files are publicly available and can be read/modified by a software package. The following stable SOFA conventions are available now:
* [[GeneralFIR]]: General convention with FIR as DataType (no restrictions but DataType)
* [[GeneralTF]]: General convention with TF as DataType (no restrictions but DataType)
* [[SimpleFreeFieldHRIR]]: Free-field HRTFs stored as impulse responses, measured with an omnidirectional source for a single listener.
* [[SimpleHeadphoneIR]]: Conventions to store headphone IRs recorded for each emitter and each ear, single listener and no directionality of emitter/receiver considered.

==Proposed SOFA Conventions==
Proposed SOFA conventions are currently being discussed. We consider following rules for new SOFA conventions:
* Data must exist (do not foresee the future)
* Data can not be described by existing SOFA conventions
* Relevant information about the data available

The following SOFA conventions are being discussed. Measured data exist but their description must be fixed in order to create publicly available SOFA files and corresponding software interfaces.

* [[SimpleFreeFieldTF]]: as SimpleFreeFieldHRIR, but uses TF as DataType covering special needs coming from HRTF simulations
* [[SingleRoomDRIR]]: Room impulse responses measured with an arbitrary number of receivers (such as a microphone array) and an omnidirectional source in a single room.
* [[SimpleFreeFieldSOS]]: as SimpleFreeFieldHRIR, but uses SOS as DataType (second-order sections) covering special needs coming from HRTF rendering
* [[MultiSpeakerBRIR]]

* [[SimpleBRIR]]: Binaural room impulse responses measured with an omnidirectional source in a single reverberant space. Somebody wanted to have this, but the work stopped at the moment.

== Unsorted topics ==
Here we list the suggestions and feedback from the peer group:
* Include anthropometric data
* Crosstalk cancellation filters
* Include calibration data from the measurement
* Include room pictures

Please use the "Discussion" function to discuss these topics.

== Feedback and Contribution ==

If you would like to contribute or propose new SOFA conventions:
* Send an e-mail to the [mailto:sofacoustics-devel@lists.sourceforge.net mailing list]. You don't have to be a member of the mailing list to send a message to the moderator.
* Go to one of the SOFA pages of your interest and use the "Discussion" for your contribution.
We appreciate your feedback!

SimpleFreeFieldHRIR

2014-10-31T12:40:53Z

Hagenw:

==Description==

This conventions essentially defines the setup used to measure HRTFs in free field. The measured HRTFs are represented as FIR filters, with a single HRTF set of a listener per file. We defined this conventions to describe data from databases like [http://www.kfs.oeaw.ac.at/hrtf ARI], LISTEN, FIU, CIPIC, and others.

In SimpleFreeFieldHRIR version 0.2, we used ListenerRotation to describe the different measurement directions, and the source was assumed to be in the center of the measurement setup. This, however, limited the use of SimpleFreeFieldHRIR, thus, in version 0.3, we assume the listener being in the center of the measurement setup, and the source moving around the listener in order to represent the different HRTF directions. Further, the apparent position vector, APV, can be used to more simple provide the apparent position for each measured HRTFs. Note that with SimpleFreeFieldHRIR version 0.3, more complex data can be described where the tilt of the head is varied, or the listener is not exactly in the center of the measurement setup.

In SimpleFreeFieldHRIR version 0.4, the currently most recent version, we adapted the Conventions to SOFA 0.6. The most striking changes are:
* ''Source'' has been renamed to '''Origin''' (in order to reduce the confusion with the object source)
* ''SubjectID'' has been renamed to '''ListenerShortName''' (in order to be more consistent with the general naming of the metadata).

== Version 0.4 ==

[[File:SimpleFreeFieldHRIR-0.3.png|right|thumb|225px]]
This conventions essentially defines the setup used in the [http://www.kfs.oeaw.ac.at/hrtf ARI], LISTEN, FIU, CIPIC, and other similar HRTF databases. The measurements are done in free field with a single excitation source assuming an omnidirectional loudspeaker. Human listeners are considered and thus, the number of receivers is two. Note that usually, only the apparent azimuth and elevation angles are provided and this information is modeled as the variation of the source position. This conventions can, however, also be used to describe more complex data where the tilt of the head is varied or the listener is not exactly in the center of the measurement setup. The measured HRTFs are represented as FIR filters, with a single HRTF set of a listener per file.

* General attributes: SOFAConventions: SimpleFreeFieldHRIR, Datatype: FIR, RoomType: free field, other general attributes...

* Listener: The listener is in the origin of the setup, facing in the direction of the y-axis. Thus, for default values, ListenerPosition=[0 0 0], ListenerView=[1 0 0], ListenerUp=[0 0 1], all given in cartesian coordinates.
* Receivers: Two receivers (=ears) on a head with radius H (in meter, default: 0.09): ReceiverPosition=[0 -H 0; 0 +H 0].
* Source: Source consists of a single emitter. For default values, EmitterPosition=[0 0 0] in cartesian coordinates. SourcePosition (in spherical coordinates!) varies corresponding to the different azimuth and elevation angles of the measurement directions. For default, SourcePosition=[0 0 1] (azimuth 0°, elevation 0°, distance 1 m). SourceUp, SourceView, and SourceRotation are not considered and optional.

{| border="1"
!Name
!Default
!Flags
!Dimensions
!Type
!Comment
|-
|GLOBAL:Conventions||SOFA||rm||||attribute||
|-
|GLOBAL:Version||0.6||rm||||attribute||
|-
|GLOBAL:SOFAConventions||SimpleFreeFieldHRIR||rm||||attribute||This convention set is for HRIRs recorded under free-field conditions or other IRs created under conditions where room information is irrelevant
|-
|GLOBAL:SOFAConventionsVersion||0.4||rm||||attribute||
|-
|GLOBAL:APIName||||rm||||attribute||
|-
|GLOBAL:APIVersion||||rm||||attribute||
|-
|GLOBAL:ApplicationName||||||||attribute||
|-
|GLOBAL:ApplicationVersion||||||||attribute||
|-
|GLOBAL:AuthorContact||||m||||attribute||
|-
|GLOBAL:Comment||||||||attribute||
|-
|GLOBAL:DataType||FIR||rm||||attribute||
|-
|GLOBAL:History||||||||attribute||
|-
|GLOBAL:License||No license provided, ask the author for permission||m||||attribute||
|-
|GLOBAL:Organization||||m||||attribute||
|-
|GLOBAL:References||||||||attribute||
|-
|GLOBAL:RoomType||free field||m||||attribute||
|-
|GLOBAL:Origin||||||||attribute||
|-
|GLOBAL:DateCreated||||m||||attribute||
|-
|GLOBAL:DateModified||||m||||attribute||
|-
|GLOBAL:Title||||m||||attribute||
|-
|ListenerPosition||[0 0 0] ||m||IC, MC||double||
|-
|ListenerPosition:Type||cartesian||m||||attribute||
|-
|ListenerPosition:Units||meter||m||||attribute||
|-
|ReceiverPosition||[0 -0.09 0; 0 0.09 0]||m||rCI, rCM||double||
|-
|ReceiverPosition:Type||cartesian||m||||attribute||
|-
|ReceiverPosition:Units||meter||m||||attribute||
|-
|SourcePosition||[0 0 1]||m||IC, MC||double||Source position is assumed to vary for different directions/positions around the listener
|-
|SourcePosition:Type||spherical||m||||attribute||
|-
|SourcePosition:Units||degree, degree, meter||m||||attribute||
|-
|EmitterPosition||[0 0 0]||m||eCI, eCM||double||
|-
|EmitterPosition:Type||cartesian||m||||attribute||
|-
|EmitterPosition:Units||meter||m||||attribute||
|-
|GLOBAL:DatabaseName||||m||||attribute||name of the database to which these data belong
|-
|GLOBAL:ListenerShortName||||m||||attribute||ID of the subject from the database
|-
|ListenerUp||[0 0 1]||m||IC, MC||double||
|-
|ListenerView||[1 0 0]||m||IC, MC||double||
|-
|ListenerView:Type||cartesian||m||||attribute||
|-
|ListenerView:Units||meter||m||||attribute||
|-
|Data.IR||[1 1]||m||mRn||double||
|-
|Data.SamplingRate||48000||m||I||double||
|-
|Data.SamplingRate:Units||hertz||m||||attribute||
|-
|Data.Delay||[0 0]||m||IR, MR||double||
|}

Legend:
* '''Name''': the name of the metadata
** A colon: the metadata is an attribute
*** "GLOBAL:": the metadata is a global attribute
*** "X:Y": the metadata is an attribute Y of the variable X
** No colon: the metadata is a variable
** Data.X: the metadata is structured within the data
* '''Default''': default value for the metadata
** An asterisk (*): special handling required, mentioned in the column Comment
* '''Flags''':
** r: read-only, must be the default value
** m: mandatory, must be saved in the file
* '''Dimensions''': dimensions of the metadata (see [[SOFA specifications]] for more explanations)
** lower case: the variable size in that dimension determines the dimension size in the file
** upper case: variable must be of that dimension (or one of these dimensions)

== Old, deprecated versions ==

For historical reasons the older versions of the SimpleFreeFieldHRIR Convention are listed below.

=== Proposed for version 0.3 (deprecated) ===

[[File:SimpleFreeFieldHRIR-0.3.png|right|thumb|225px]]
This conventions essentially defines the setup used in the [http://www.kfs.oeaw.ac.at/hrtf ARI], LISTEN, FIU, CIPIC, and other similar HRTF databases. The measurements are done in free field with a single excitation source assuming an omnidirectional loudspeaker. Human listeners are considered and thus, the number of receivers is two. Note that usually, only the apparent azimuth and elevation angles are provided and this information is modeled as the variation of the source position. This conventions can, however, also be used to describe more complex data where the tilt of the head is varied or the listener is not exactly in the center of the measurement setup. The measured HRTFs are represented as FIR filters, with a single HRTF set of a listener per file.

* General attributes: SOFAConventions: SimpleFreeFieldHRIR, Datatype: FIR, RoomType: free field, other general attributes...

* Listener: The listener is in the origin of the setup, facing in the direction of the y-axis. Thus, for default values, ListenerPosition=[0 0 0], ListenerView=[1 0 0], ListenerUp=[0 0 1], all given in cartesian coordinates.
* Receivers: Two receivers (=ears) on a head with radius H (in meter, default: 0.09): ReceiverPosition=[0 -H 0; 0 +H 0].
* Source: Source consists of a single emitter. For default values, EmitterPosition=[0 0 0] in cartesian coordinates. SourcePosition (in spherical coordinates!) varies corresponding to the different azimuth and elevation angles of the measurement directions. For default, SourcePosition=[0 0 1] (azimuth 0°, elevation 0°, distance 1 m). SourceUp, SourceView, and SourceRotation are not considered and optional.

{| border="1"
!Name
!Default
!Flags
!Dimensions
!Type
!Comment
|-
|GLOBAL:Conventions||SOFA||rm||||attribute||
|-
|GLOBAL:Version||0.5||rm||||attribute||
|-
|GLOBAL:SOFAConventions||SimpleFreeFieldHRIR||rm||||attribute||This conventions is for HRIRs recorded under free-field conditions or other IRs created under conditions where room information is irrelevant
|-
|GLOBAL:SOFAConventionsVersion||0.3||rm||||attribute||
|-
|GLOBAL:APIName||||rm||||attribute||
|-
|GLOBAL:APIVersion||||rm||||attribute||
|-
|GLOBAL:ApplicationName||||m||||attribute||
|-
|GLOBAL:ApplicationVersion||||m||||attribute||
|-
|GLOBAL:AuthorContact||||m||||attribute||
|-
|GLOBAL:Comment||||m||||attribute||
|-
|GLOBAL:DataType||FIR||rm||||attribute||
|-
|GLOBAL:History||||m||||attribute||
|-
|GLOBAL:License||No license provided, ask the author for permission||m||||attribute||
|-
|GLOBAL:Organization||||m||||attribute||
|-
|GLOBAL:References||||m||||attribute||
|-
|GLOBAL:RoomType||free field||m||||attribute||
|-
|GLOBAL:Source||||m||||attribute||
|-
|GLOBAL:TimeCreated||||m||||attribute||
|-
|GLOBAL:TimeModified||||m||||attribute||
|-
|GLOBAL:Title||||m||||attribute||
|-
|ListenerPosition||[0 0 0] ||m||IC, MC||double||
|-
|ListenerPosition:Type||cartesian||m||||attribute||
|-
|ListenerPosition:Units||meter||m||||attribute||
|-
|ReceiverPosition||[0 -0.09 0; 0 0.09 0]||m||rCI, rCM||double||
|-
|ReceiverPosition:Type||cartesian||m||||attribute||
|-
|ReceiverPosition:Units||meter||m||||attribute||
|-
|SourcePosition||[0 0 1]||m||IC, MC||double||Source position is assumed to vary for different directions/positions around the listener
|-
|SourcePosition:Type||spherical||m||||attribute||
|-
|SourcePosition:Units||degree, degree, meter||m||||attribute||
|-
|EmitterPosition||[0 0 0]||m||eCI, eCM||double||
|-
|EmitterPosition:Type||cartesian||m||||attribute||
|-
|EmitterPosition:Units||meter||m||||attribute||
|-
|GLOBAL:DatabaseName||||m||||attribute||name of the database to which these data belong
|-
|GLOBAL:SubjectID||||m||||attribute||ID of the subject from the database
|-
|ListenerUp||[0 0 1]||m||IC, MC||double||
|-
|ListenerView||[1 0 0]||m||IC, MC||double||
|-
|Data.IR||[1 1]||m||mRn||double||
|-
|Data.SamplingRate||48000||m||I||double||
|-
|Data.SamplingRate:Units||hertz||m||||attribute||
|-
|Data.Delay||[0 0]||m||IR, MR||double||
|}

Legend:
* '''Name''': the name of the metadata
** A colon: the metadata is an attribute
*** "GLOBAL:": the metadata is a global attribute
*** "X:Y": the metadata is an attribute Y of the variable X
** No colon: the metadata is a variable
** Data.X: the metadata is structured within the data
* '''Default''': default value for the metadata
** An asterisk (*): special handling required, mentioned in the column Comment
* '''Flags''':
** r: read-only, must be the default value
** m: mandatory, must be saved in the file
* '''Dimensions''': dimensions of the metadata (see [[SOFA specifications]] for more explanations)
** lower case: the variable size in that dimension determines the dimension size in the file
** upper case: variable must be of that dimension (or one of these dimensions)

=== Version 0.2 (deprecated) ===

[[File:SimpleFreeFieldHRIR-0.2.png|right|thumb|225px]]
This conventions essentially defines the setup used in the [http://www.kfs.oeaw.ac.at/hrtf ARI], LISTEN, FIU, CIPIC, and other similar HRTF databases. The measurements are done in free field with a single excitation source assuming an omnidirectional loudspeaker. Human listeners are considered and thus, the number of receivers is two. Azimuth and elevation angles are varied and the tilt of the head is not considered during the measurement. The measured HRTFs are represented as FIR filters, with a single HRTF set of a listener per file.

* General attributes: SOFAConventions: SimpleFreeFieldHRIR, Datatype: FIR, RoomType: free field, other general attributes...
* Source: Source is in the origin of the setup and consists of a single emitter. For default values, SourcePosition: (0 0 0), and EmitterPosition: (0 0 0). SourceUp, SourceView, and SourceRotation are not considered and optional.
* Listener: The listener is in the measurement distance X (in meter) from the source, facing the source. For default values, we consider a single distance X, thus, ListenerPosition: (X 0 0), ListenerView: (0 0 0), ListenerUp: (X 0 1).
* Receivers: Two receivers (=ears) on a head with radius H (in meter): ReceiverPosition: (0 -H 0; 0 +H 0).
* The different azimuth and elevation angles of the measurement are described by the ListenerRotation as [M 3] matrix (in degrees). The coordinate type is [http://en.wikipedia.org/wiki/Axes_conventions DIN 9300].

{| border="1"
!Name
!Default
!Flags
!Dimensions
!Type
!Comment
|-
|GLOBAL_Conventions||SOFA||rm||||||
|-
|GLOBAL_Version||0.4||rm||||||
|-
|GLOBAL_SOFAConventions||SimpleFreeFieldHRIR||rm||||||
|-
|GLOBAL_SOFAConventionsVersion||0.2||rm||||||
|-
|GLOBAL_APIName||||rm||||||Insert the API Name here
|-
|GLOBAL_APIVersion||||rm||||||Insert the API Version here
|-
|GLOBAL_AuthorContact||||m||||||
|-
|GLOBAL_License||No license provided, ask the author for permission||m||||||
|-
|GLOBAL_Organization||||m||||||
|-
|GLOBAL_RoomType||free field||m||||||
|-
|GLOBAL_DataType||FIR||rm||||||
|-
|GLOBAL_History||||m||||||
|-
|GLOBAL_Source||||m||||||
|-
|GLOBAL_Title||||m||||||
|-
|GLOBAL_References||||m||||||
|-
|GLOBAL_Comment||||m||||||
|-
|GLOBAL_TimeCreated||||m||||||will be updated when saving and not existing or empty
|-
|GLOBAL_TimeModified||||m||||||will be updated each time when saving
|-
|GLOBAL_ApplicationName||||m||||||
|-
|GLOBAL_ApplicationVersion||||m||||||
|-
|GLOBAL_DatabaseName||||m||||||
|-
|GLOBAL_SubjectID||||m||||||
|-
|ListenerPosition||[1 0 0] ||m||IC, MC||double||
|-
|ListenerPosition_Type||cartesian||m||||||
|-
|ListenerPosition_Units||meter||m||||||
|-
|ListenerUp||[0 0 1]||m||IC, MC||double||
|-
|ListenerView||[-1 0 0]||m||IC, MC||double||
|-
|ListenerRotation||[0 0 0]||m||IC, MC||double||
|-
|ListenerRotation_Type||din9300||m||||||
|-
|ListenerRotation_Units||degrees||m||||||
|-
|ReceiverPosition||[0 -0.09 0; 0 0.09 0]||m||rCI, rCM||double||
|-
|ReceiverPosition_Type||cartesian||m||||||
|-
|ReceiverPosition_Units||meter||m||||||
|-
|SourcePosition||[0 0 0]||m||IC, MC||double||
|-
|SourcePosition_Type||cartesian||m||||||
|-
|SourcePosition_Units||meter||m||||||
|-
|EmitterPosition||[0 0 0]||m||eCI, eCM||double||
|-
|EmitterPosition_Type||cartesian||m||||||
|-
|EmitterPosition_Units||meter||m||||||
|-
|Data.IR||[1 1]||m||mRn||double||
|-
|Data.SamplingRate||48000||m||I||double||
|-
|Data.SamplingRate_Units||hertz||m||||||
|-
|Data.Delay||[0 0]||m||IR, MR||double||
|}

Legend:
* '''Name''': the name of the metadata
** An underscore (_): the metadata is an attribute
*** GLOBAL_: the metadata is a global attribute
*** X_Y: the metadata is an attribute Y of the variable X
** No underscore: the metadata is a variable
** Data.X: the metadata is structured within the data
* '''Default''': default value for the metadata
** An asterisk (*): special handling required, mentioned in the column Comment
* '''Flags''':
** r: read-only, must be the default value
** m: mandatory, must be saved in the file
* '''Dimensions''': dimensions of the metadata (see [[SOFA specifications]] for more explanations)
** lower case: the variable size in that dimension determines the dimension size in the file
** upper case: variable must be of that dimension (or one of these dimensions)

=== Version 0.1 (deprecated) ===
{| border="1"
!Name
!Default
!Flags
!Dimensions
!Comment
|-
|GLOBAL_Conventions||SOFA||rm|| ||
|-
|GLOBAL_Version||0.3||rm|| ||
|-
|GLOBAL_SOFAConventions||SimpleFreeFieldHRIR||rm ||||
|-
|GLOBAL_SOFAConventionsVersion||0.1||m|| ||
|-
|GLOBAL_APIName||*||rm|| ||Insert the API Name here
|-
|GLOBAL_APIVersion||*||rm || ||Insert the API Version here
|-
|GLOBAL_ApplicationName||||m ||||
|-
|GLOBAL_ApplicationVersion||||m ||||
|-
|GLOBAL_AuthorContact||||m ||||
|-
|GLOBAL_License||No license provided, ask the author for permission||m||||
|-
|GLOBAL_Organization||||m ||||
|-
|GLOBAL_DatabaseName||||m||||
|-
|GLOBAL_SubjectID||||m ||||
|-
|GLOBAL_RoomType||free field||m||||
|-
|GLOBAL_DataType||FIR||m||||
|-
|GLOBAL_History||||||||
|-
|GLOBAL_Comment||||||||
|-
|GLOBAL_DatabaseTimeCreated||*||m|||| will be updated when saving and not existing or empty
|-
|GLOBAL_DatabaseTimeModified||*||m ||||will be updated each time when saving
|-
|I||1||rm||I||
|-
|I_LongName||singleton dimension||rm|| ||
|-
|R||2||rm||R||
|-
|R_LongName||number of receivers||rm||||
|-
|E||1||rm||E||
|-
|E_LongName||number of emitters||rm||||
|-
|N|| - ||m||N||
|-
|N_LongName||time||m|| ||
|-
|N_Units||samples||m|| ||
|-
|M|| - ||m||M||
|-
|M_LongName||number of measurements||rm ||||
|-
|C||3||rm||C||
|-
|C_LongName||coordinate triplet||rm||||
|-
|ListenerPosition|| [1 0 0] ||m||IC, MC||
|-
|ListenerPosition_Type||cartesian||m|| ||
|-
|ListenerPosition_Unitsmeter||||m||||
|-
|ListenerUp||[1.2 0 1]||m||IC, MC||
|-
|ListenerUp_Type||cartesian||m||||
|-
|ListenerUp_Units||meter||m||||
|-
|ListenerView||[0 0 0]||m||IC, MC||
|-
|ListenerView_Type||cartesian||m||||
|-
|ListenerView_Units||meter||m||||
|-
|ListenerRotation||[0 0 0]||m||IC, MC||
|-
|-
|ListenerRotation_Type||din9300||m||||
|-
|ListenerRotation_Units||degrees||m ||||
|-
|ReceiverPosition||[0 -0.09 0; 0 0.09 0]||m||rCI, rCM||
|-
|ReceiverPosition_Type||cartesian||m||||
|-
|ReceiverPosition_Units||meter||m ||||
|-
|SourcePosition||[0 0 0]||m||IC, MC||
|-
|SourcePosition_Type||cartesian||m||||
|-
|SourcePosition_Units||meter||m ||||
|-
|SourceUp||[0 0 1]||m||IC, MC||
|-
|SourceUp_Type||cartesian||m||||
|-
|SourceUp_Units||meter||m||||
|-
|SourceView||[1 0 0]||m||IC, MC||
|-
|SourceView_Type||cartesian||m||||
|-
|SourceView_Units||meter||m||||
|-
|EmitterPosition||[0 0 0]||m||eCI, eCM||
|-
|EmitterPosition_Type||cartesian||m||||
|-
|EmitterPosition_Units||meter||m ||||
|-
|Data.IR||[1 1]||m||mRn||
|-
|Data.SamplingRate||48000||m||I||
|-
|Data.SamplingRate_Units||hertz||m||||
|}

Legend:
* '''Name''': the name of the metadata
** An underscore (_): the metadata is an attribute
*** GLOBAL_: the metadata is a global attribute
*** X_Y: the metadata is an attribute Y of the variable X
** No underscore: the metadata is a variable
** Data.X: the metadata is structured within the data
* '''Default''': default value for the metadata
** An asterisk (*): special handling required, mentioned in the column Comment
* '''Flags''':
** r: read-only, must be the default value
** m: mandatory, must be saved in the file
* '''Dimensions''': dimensions of the metadata (see [[SOFA specifications]] for more explanations)
** lower case: the variable size in that dimension determines the dimension size in the file
** upper case: variable must be of that dimension (or one of these dimensions)