SingleRoomDRIR: Difference between revisions

From Sofaconventions
Jump to navigation Jump to search
← Older editNewer edit →
Content deleted Content added
updated to SOFA 0.4 draft version
Line 11: Line 11:




==Proposed (for SOFA 0.4)==
==Proposed (for SOFA 0.5)==
{| border="1"
{| border="1"
!Name
!Name
Line 20: Line 20:
!Comment
!Comment
|-
|-
|GLOBAL_Conventions||SOFA||rm||||||
|GLOBAL:Conventions||SOFA||rm||||attribute||
|-
|-
|GLOBAL_Version||0.4||rm||||||
|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_SOFAConventions||SingleRoomDRIR||rm||||||
|-
|-
|GLOBAL_SOFAConventionsVersion||0.0||rm||||||
|GLOBAL:SOFAConventionsVersion||0.1||rm||||attribute||
|-
|-
|GLOBAL_APIName||||rm||||||Insert the API Name here
|GLOBAL:APIName||||rm||||attribute||
|-
|-
|GLOBAL:APIVersion||||rm||||attribute||
|GLOBAL_APIVersion||||rm||||||Insert the API Version here
|-
|-
|GLOBAL_AuthorContact||||m||||||
|GLOBAL:ApplicationName||||m||||attribute||
|-
|-
|GLOBAL:ApplicationVersion||||m||||attribute||
⚫
|GLOBAL_License||No license provided, ask the author for permission||m||||||
|-
|-
|GLOBAL_Organization||||m||||||
|GLOBAL:AuthorContact||||m||||attribute||
|-
|-
|GLOBAL_RoomType||reverberant||m||||||
|GLOBAL:Comment||||m||||attribute||
|-
|-
|GLOBAL_DataType||FIR||rm||||||
|GLOBAL:DataType||FIR||rm||||attribute||
|-
|-
|GLOBAL_History||||m||||||
|GLOBAL:History||||m||||attribute||
|-
|-
⚫
|GLOBAL:License||No license provided, ask the author for permission||m||||attribute||
|GLOBAL_Source||||m||||||
|-
|-
|GLOBAL_Title||||m||||||
|GLOBAL:Organization||||m||||attribute||
|-
|-
|GLOBAL_References||||m||||||
|GLOBAL:References||||m||||attribute||
|-
|-
|GLOBAL_Comment||||m||||||
|GLOBAL:RoomType||reverberant||m||||attribute||
|-
|-
|GLOBAL:Source||||m||||attribute||
|GLOBAL_TimeCreated||||m||||||will be updated when saving and not existing or empty
|-
|-
|GLOBAL:TimeCreated||||m||||attribute||
|GLOBAL_TimeModified||||m||||||will be updated each time when saving
|-
|-
|GLOBAL_ApplicationName||||m||||||
|GLOBAL:TimeModified||||m||||attribute||
|-
|-
|GLOBAL_ApplicationVersion||||m||||||
|GLOBAL:Title||||m||||attribute||
|-
|-
|GLOBAL_DatabaseName||||m||||||
|ListenerPosition||[0 0 0] ||m||IC, MC||double||
|-
|-
|GLOBAL_RoomDescription||||m||||||
|ListenerPosition:Type||cartesian||m||||attribute||
|-
|-
|ListenerPosition||[1 0 0] ||m||IC, MC||double||
|ListenerPosition:Units||meter||m||||attribute||
|-
|-
|ListenerPosition_Type||cartesian||m||||||
|ReceiverPosition||[0 0 0]||m||rCI, rCM||double||
|-
|-
|ListenerPosition_Units||meter||m||||||
|ReceiverPosition:Type||cartesian||m||||attribute||
|-
|-
|ListenerUp||[0 0 1]||m||IC, MC||double||
|ReceiverPosition:Units||meter||m||||attribute||
|-
|-
|ListenerView||[-1 0 0]||m||IC, MC||double||
|SourcePosition||[0 0 0]||m||IC, MC||double||
|-
|-
⚫
|SourcePosition:Type||cartesian||m||||attribute||
⚫
|ListenerRotation||[0 0 0]||||IC, MC||double||
|-
|-
|ListenerRotation_Type||din9300||||||||
|SourcePosition:Units||meter||m||||attribute||
|-
|-
⚫
|EmitterPosition||[0 0 0]||m||eCI, eCM||double||
|ListenerRotation_Units||degrees||||||||
|-
|-
|ReceiverPosition||[0 0 0]||m||rCI, rCM||double||
|EmitterPosition:Type||cartesian||m||||attribute||
|-
|-
|ReceiverPosition_Type||cartesian||m||||||
|EmitterPosition:Units||meter||m||||attribute||
|-
|-
|ReceiverPosition_Units||meter||m||||||
|GLOBAL:DatabaseName||||m||||attribute||
|-
|-
|SourcePosition||[0 0 0]||m||IC, MC||double||
|GLOBAL:RoomDescription||||m||||attribute||
|-
|-
|SourcePosition_Type||cartesian||m||||||
|ListenerUp||[0 0 1]||m||IC, MC||double||
|-
|-
|SourcePosition_Units||meter||m||||||
|ListenerView||[1 0 0]||m||IC, MC||double||
|-
|-
|SourceUp||[0 0 1]||m||IC, MC||double||
|SourceUp||[0 0 1]||m||IC, MC||double||
|-
|-
|SourceView||[1 0 0]||m||IC, MC||double||
|SourceView||[-1 0 0]||m||IC, MC||double||
|-
|EmitterPosition||[0 0 0]||m||eCI, eCM||double||
|-
⚫
|EmitterPosition_Type||cartesian||m||||||
|-
|EmitterPosition_Units||meter||m||||||
|-
|-
|Data.IR||[1]||m||mRn||double||
|Data.IR||[1 1]||m||mRn||double||
|-
|-
|Data.SamplingRate||48000||m||I||double||
|Data.SamplingRate||48000||m||I||double||
|-
|-
|Data.SamplingRate_Units||hertz||m||||||
|Data.SamplingRate:Units||hertz||m||||attribute||
|-
|-
|Data.Delay||[0]||m||IR, MR||double||
|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)

Revision as of 14:52, 20 August 2013

Description

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.


Proposed (for SOFA 0.5)

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
Retrieved from "https://www.sofaconventions.org/mediawiki/index.php?title=SingleRoomDRIR&oldid=1692"