Sofaconventions - User contributions [en]

GeneralFIRE

2014-11-14T15:59:57Z

Verade:

==Description==

This convention defines only that FIRE is the DataType. All other metadata follow the general SOFA specifications.

This convention can be used to save data which are too general to store in more specific conventions.

== Version 0.1 ==

{| 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>GeneralFIRE</nowiki>||rm||||attribute||This conventions stores IRs for general purposes, i.e., only the mandatory, SOFA general metadata are pre-defined
|-
|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>FIRE</nowiki>||rm||||attribute||We use FIR datatype which in addition depends on Emitters (E)
|-
|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||The room information can be arbitrary
|-
|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 1]</nowiki>||m||IC, MC||double||
|-
|SourcePosition:Type||<nowiki>spherical</nowiki>||m||||attribute||
|-
|SourcePosition:Units||<nowiki>degree, degree, meter</nowiki>||m||||attribute||
|-
|EmitterPosition||<nowiki>[0 0 0]</nowiki>||m||eCI, eCM||double||Each speaker is represented as an emitter. Use EmitterPosition to represent the position of a particular speaker. Size of EmitterPosition determines E
|-
|EmitterPosition:Type||<nowiki>cartesian</nowiki>||m||||attribute||
|-
|EmitterPosition:Units||<nowiki>meter</nowiki>||m||||attribute||
|-
|Data.IR||<nowiki>[1 1]</nowiki>||m||mREn||double||Impulse responses
|-
|Data.SamplingRate||<nowiki>48000</nowiki>||m||I||double||Sampling rate of the samples in Data.IR and Data.Delay
|-
|Data.SamplingRate:Units||<nowiki>hertz</nowiki>||m||||attribute||Unit of the sampling rate
|-
|Data.Delay||<nowiki>[0 0]</nowiki>||m||IRE, MRE||double||Additional delay of each IR (in samples)
|}

SOFA conventions

2014-11-14T10:39:52Z

Verade:

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)
* [[GeneralFIRE]]: General convention with FIRE 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!