GeneralFIRE: Difference between revisions
Jump to navigation
Jump to search
Content deleted Content added
No edit summary |
|||
| (3 intermediate revisions by 2 users not shown) | |||
| Line 1: | Line 1: | ||
==Description== |
==Description== |
||
This convention |
This SOFA convention set is similar to [[GeneralFIR]]. The only difference is the DataType, which is FIR'''E''', not FIR. All other attributes and variables follow the general SOFA specifications. |
||
As GeneralFIR, this convention set can be used to save data which are too general to store in more specific conventions. |
|||
GeneralFIRE is deprecated; [[GeneralFIR-E]] is recommended instead. |
|||
== Version |
== Version 1.0 == |
||
This version follows the conventions [[GeneralFIR]] (version 1.0) standardized in AES69-2015. Note that GeneralFIRE 1.0, in contrast to GeneralFIR 1.0, has not been included in the standard, thus, here, we declare it as stable. |
|||
This version uses SOFA 1.0. |
|||
{| border="1" |
{| border="1" |
||
!Name |
!Name |
||
!Default |
!Default |
||
![[SOFA_conventions#AnchorFlags|Flags]] |
|||
!Flags |
|||
!Dimensions |
![[SOFA_conventions#AnchorDimensions|Dimensions]] |
||
!Type |
!Type |
||
!Comment |
!Comment |
||
| Line 64: | Line 65: | ||
|ListenerPosition:Units||<nowiki>metre</nowiki>||m||||attribute|| |
|ListenerPosition:Units||<nowiki>metre</nowiki>||m||||attribute|| |
||
|- |
|- |
||
|ReceiverPosition||<nowiki>[0 0 |
|ReceiverPosition||<nowiki>[0 0 0]</nowiki>||m||rCI, rCM||double|| |
||
|- |
|- |
||
|ReceiverPosition:Type||<nowiki>cartesian</nowiki>||m||||attribute|| |
|ReceiverPosition:Type||<nowiki>cartesian</nowiki>||m||||attribute|| |
||
| Line 82: | Line 83: | ||
|EmitterPosition:Units||<nowiki>metre</nowiki>||m||||attribute|| |
|EmitterPosition:Units||<nowiki>metre</nowiki>||m||||attribute|| |
||
|- |
|- |
||
|Data.IR||<nowiki> |
|Data.IR||<nowiki>0</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||<nowiki>48000</nowiki>||m||I||double||Sampling rate of the samples in Data.IR and Data.Delay |
||
| Line 88: | Line 89: | ||
|Data.SamplingRate:Units||<nowiki>hertz</nowiki>||m||||attribute||Unit of the sampling rate |
|Data.SamplingRate:Units||<nowiki>hertz</nowiki>||m||||attribute||Unit of the sampling rate |
||
|- |
|- |
||
|Data.Delay||<nowiki> |
|Data.Delay||<nowiki>0</nowiki>||m||IRE, MRE||double||Additional delay of each IR (in samples) |
||
|} |
|} |
||
== Old deprecated versions == |
== Old deprecated versions == |
||
Latest revision as of 09:38, 21 November 2022
Description
This SOFA convention set is similar to GeneralFIR. The only difference is the DataType, which is FIRE, not FIR. All other attributes and variables follow the general SOFA specifications.
As GeneralFIR, this convention set can be used to save data which are too general to store in more specific conventions.
GeneralFIRE is deprecated; GeneralFIR-E is recommended instead.
Version 1.0
This version follows the conventions GeneralFIR (version 1.0) standardized in AES69-2015. Note that GeneralFIRE 1.0, in contrast to GeneralFIR 1.0, has not been included in the standard, thus, here, we declare it as stable.
| Name | Default | Flags | Dimensions | Type | Comment |
|---|---|---|---|---|---|
| GLOBAL:Conventions | SOFA | rm | attribute | ||
| GLOBAL:Version | 1.0 | rm | attribute | ||
| GLOBAL:SOFAConventions | GeneralFIRE | rm | attribute | This conventions stores IRs for general purposes, i.e., only the mandatory, SOFA general metadata are pre-defined | |
| GLOBAL:SOFAConventionsVersion | 1.0 | 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 | FIRE | rm | attribute | We use FIR datatype which in addition depends on Emitters (E) | |
| 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 | The room information can be arbitrary | |
| 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 | metre | m | attribute | ||
| ReceiverPosition | [0 0 0] | m | rCI, rCM | double | |
| ReceiverPosition:Type | cartesian | m | attribute | ||
| ReceiverPosition:Units | metre | m | attribute | ||
| SourcePosition | [0 0 1] | m | IC, MC | double | |
| SourcePosition:Type | spherical | m | attribute | ||
| SourcePosition:Units | degree, degree, metre | m | attribute | ||
| EmitterPosition | [0 0 0] | 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 | cartesian | m | attribute | ||
| EmitterPosition:Units | metre | m | attribute | ||
| Data.IR | 0 | m | mREn | double | Impulse responses |
| Data.SamplingRate | 48000 | m | I | double | Sampling rate of the samples in Data.IR and Data.Delay |
| Data.SamplingRate:Units | hertz | m | attribute | Unit of the sampling rate | |
| Data.Delay | 0 | m | IRE, MRE | double | Additional delay of each IR (in samples) |
Old deprecated versions
Version 0.1
| Name | Default | Flags | Dimensions | Type | Comment |
|---|---|---|---|---|---|
| GLOBAL:Conventions | SOFA | rm | attribute | ||
| GLOBAL:Version | 0.6 | rm | attribute | ||
| GLOBAL:SOFAConventions | GeneralFIRE | rm | attribute | This conventions stores IRs for general purposes, i.e., only the mandatory, SOFA general metadata are pre-defined | |
| GLOBAL:SOFAConventionsVersion | 0.1 | 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 | FIRE | rm | attribute | We use FIR datatype which in addition depends on Emitters (E) | |
| 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 | The room information can be arbitrary | |
| 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 | |
| SourcePosition:Type | spherical | m | attribute | ||
| SourcePosition:Units | degree, degree, meter | m | attribute | ||
| EmitterPosition | [0 0 0] | 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 | cartesian | m | attribute | ||
| EmitterPosition:Units | meter | m | attribute | ||
| Data.IR | [1 1] | m | mREn | double | Impulse responses |
| Data.SamplingRate | 48000 | m | I | double | Sampling rate of the samples in Data.IR and Data.Delay |
| Data.SamplingRate:Units | hertz | m | attribute | Unit of the sampling rate | |
| Data.Delay | [0 0] | m | IRE, MRE | double | Additional delay of each IR (in samples) |