FreeFieldHRTF: Difference between revisions

From Sofaconventions
Jump to navigation Jump to search
Content deleted Content added
Creating FreeFieldHRTF
 
No edit summary
 
(2 intermediate revisions by the same user not shown)
Line 3: Line 3:
Based on [[SimpleFreeFieldHRTF]], the only difference is that the HRTFs are in a spatially continuous representation.
Based on [[SimpleFreeFieldHRTF]], the only difference is that the HRTFs are in a spatially continuous representation.


The conventions is defined in AES69-2020 (SOFA 2.0).
The conventions is defined in AES69-2022 (SOFA 2.1).




Line 9: Line 9:
!Name
!Name
!Default
!Default
![[SOFA_conventions#AnchorFlags|Flags]]
!Flags
!Dimensions
![[SOFA_conventions#AnchorDimensions|Dimensions]]
!Type
!Type
!Comment
!Comment
|-
|-
|GLOBAL:Conventions||SOFA||rm|| ||attribute||
|GLOBAL:Conventions||<nowiki>SOFA</nowiki>||rm||||attribute||
|-
|-
|GLOBAL:Version||2.0||rm|| ||attribute||
|GLOBAL:Version||<nowiki>2.1</nowiki>||rm||||attribute||
|-
|-
|GLOBAL:SOFAConventions||FreeFieldHRTF||rm|| ||attribute||This conventions is for HRTFs created under conditions where room information is irrelevant and stored as SH coefficients
|GLOBAL:SOFAConventions||<nowiki>FreeFieldHRTF</nowiki>||rm||||attribute||This conventions is for HRTFs created under conditions where room information is irrelevant and stored as SH coefficients
|-
|-
|GLOBAL:SOFAConventionsVersion||1.0||rm|| ||attribute||
|GLOBAL:SOFAConventionsVersion||<nowiki>1.0</nowiki>||rm||||attribute||
|-
|-
|GLOBAL:APIName||||rm|| ||attribute||
|GLOBAL:APIName||<nowiki></nowiki>||rm||||attribute||
|-
|-
|GLOBAL:APIVersion||||rm|| ||attribute||
|GLOBAL:APIVersion||<nowiki></nowiki>||rm||||attribute||
|-
|-
|GLOBAL:ApplicationName|||||| ||attribute||
|GLOBAL:ApplicationName||<nowiki></nowiki>||||||attribute||
|-
|-
|GLOBAL:ApplicationVersion|||||| ||attribute||
|GLOBAL:ApplicationVersion||<nowiki></nowiki>||||||attribute||
|-
|-
|GLOBAL:AuthorContact||||m|| ||attribute||
|GLOBAL:AuthorContact||<nowiki></nowiki>||m||||attribute||
|-
|-
|GLOBAL:Comment|||||| ||attribute||
|GLOBAL:Comment||<nowiki></nowiki>||||||attribute||
|-
|-
|GLOBAL:DataType||TF-E||rm|| ||attribute||
|GLOBAL:DataType||<nowiki>TF-E</nowiki>||rm||||attribute||
|-
|-
|GLOBAL:History|||||| ||attribute||
|GLOBAL:History||<nowiki></nowiki>||||||attribute||
|-
|-
|GLOBAL:License||No license provided, ask the author for permission||m|| ||attribute||
|GLOBAL:License||<nowiki>No license provided, ask the author for permission</nowiki>||m||||attribute||
|-
|-
|GLOBAL:ListenerShortName||||m||||attribute||ID of the subject from the database
|GLOBAL:ListenerShortName||<nowiki></nowiki>||m||||attribute||ID of the subject from the database
|-
|-
|GLOBAL:Organization||||m|| ||attribute||
|GLOBAL:Organization||<nowiki></nowiki>||m||||attribute||
|-
|-
|GLOBAL:References||||||||attribute||
|GLOBAL:References||<nowiki></nowiki>||||||attribute||
|-
|-
|GLOBAL:RoomType||free field||m|| ||attribute||
|GLOBAL:RoomType||<nowiki>free field</nowiki>||m||||attribute||
|-
|-
|GLOBAL:Origin||||||||attribute||
|GLOBAL:Origin||<nowiki></nowiki>||||||attribute||
|-
|-
|GLOBAL:DateCreated||||m|| ||attribute||
|GLOBAL:DateCreated||<nowiki></nowiki>||m||||attribute||
|-
|-
|GLOBAL:DateModified||||m|| ||attribute||
|GLOBAL:DateModified||<nowiki></nowiki>||m||||attribute||
|-
|-
|GLOBAL:Title||||m||||attribute||
|GLOBAL:Title||<nowiki></nowiki>||m||||attribute||
|-
|-
|ListenerPosition||[0 0 0] ||m||IC, MC||double||
|ListenerPosition||<nowiki>[0 0 0] </nowiki>||m||IC, MC||double||
|-
|-
|ListenerPosition:Type||cartesian||m|| ||attribute||
|ListenerPosition:Type||<nowiki>cartesian</nowiki>||m||||attribute||
|-
|-
|ListenerPosition:Units||metre||m|| ||attribute||
|ListenerPosition:Units||<nowiki>metre</nowiki>||m||||attribute||
|-
|-
|ReceiverPosition||[0 0.09 0; 0 -0.09 0]||m||RCI, RCM||double||
|ReceiverPosition||<nowiki>[0 0.09 0; 0 -0.09 0]</nowiki>||m||RCI, RCM||double||
|-
|-
|ReceiverPosition:Type||cartesian||m|| ||attribute||
|ReceiverPosition:Type||<nowiki>cartesian</nowiki>||m||||attribute||
|-
|-
|ReceiverPosition:Units||metre||m|| ||attribute||
|ReceiverPosition:Units||<nowiki>metre</nowiki>||m||||attribute||
|-
|-
|SourcePosition||[0 0 0]||m||IC, MC||double||Source position is assumed to be the ListenerPosition in order to reflect Emitters surrounding the Listener
|SourcePosition||<nowiki>[0 0 0]</nowiki>||m||IC, MC||double||Source position is assumed to be the ListenerPosition in order to reflect Emitters surrounding the Listener
|-
|-
|SourcePosition:Type||spherical||m|| ||attribute||
|SourcePosition:Type||<nowiki>spherical</nowiki>||m||||attribute||
|-
|-
|SourcePosition:Units||degree, degree, metre||m|| ||attribute||
|SourcePosition:Units||<nowiki>degree, degree, metre</nowiki>||m||||attribute||
|-
|-
|EmitterPosition||[0 0 0]||m||IC, ECI, ECM||double||Emitter positions are irrelevant because they data is spatially continuous
|EmitterPosition||<nowiki>[0 0 0]</nowiki>||m||IC, ECI, ECM||double||Radius in 'spherical harmonics', Position in 'cartesian' and 'spherical'
|-
|-
|EmitterPosition:Type||harmonics||m|| ||attribute||Spatially continuous representation by means of harmonics
|EmitterPosition:Type||<nowiki>spherical harmonics</nowiki>||m||||attribute||Can be 'spherical harmonics', 'cartesian', or 'spherical'
|-
|-
|EmitterPosition:Units||spherical||m|| ||attribute||3D representation
|EmitterPosition:Units||<nowiki>degree, degree, metre</nowiki>||m||||attribute||
|-
|-
|GLOBAL:DatabaseName||||m|| ||attribute||Name of the database to which these data belong
|GLOBAL:DatabaseName||<nowiki></nowiki>||m||||attribute||Name of the database to which these data belong
|-
|-
|ListenerUp||[0 0 1]||m||IC, MC||double||
|ListenerUp||<nowiki>[0 0 1]</nowiki>||m||IC, MC||double||
|-
|-
|ListenerView||[1 0 0]||m||IC, MC||double||
|ListenerView||<nowiki>[1 0 0]</nowiki>||m||IC, MC||double||
|-
|-
|ListenerView:Type||cartesian||m||||attribute||
|ListenerView:Type||<nowiki>cartesian</nowiki>||m||||attribute||
|-
|-
|ListenerView:Units||metre||m||||attribute||
|ListenerView:Units||<nowiki>metre</nowiki>||m||||attribute||
|-
|-
|Data.Real||[0 0]||m||mrne||double||
|Data.Real||<nowiki>[0 0]</nowiki>||m||mrne||double||
|-
|-
|Data.Imag||[0 0]||m||MRNE||double||
|Data.Imag||<nowiki>[0 0]</nowiki>||m||MRNE||double||
|-
|-
|N||0||m||N||double||
|N||<nowiki>0</nowiki>||m||N||double||
|-
|-
|N_LongName||frequency||||||attribute||
|N:LongName||<nowiki>frequency</nowiki>||m||||attribute||narrative name of N
|-
|-
|N_Units||hertz||||||attribute||
|N:Units||<nowiki>hertz</nowiki>||m||||attribute||
|}
|}

Latest revision as of 11:10, 21 October 2022

This conventions defines free-field HRTFs stored as transfer functions in the spherical-harmonics domain, measured with an omnidirectional source for a single listener.

Based on SimpleFreeFieldHRTF, the only difference is that the HRTFs are in a spatially continuous representation.

The conventions is defined in AES69-2022 (SOFA 2.1).


Name Default Flags Dimensions Type Comment
GLOBAL:Conventions SOFA rm attribute
GLOBAL:Version 2.1 rm attribute
GLOBAL:SOFAConventions FreeFieldHRTF rm attribute This conventions is for HRTFs created under conditions where room information is irrelevant and stored as SH coefficients
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 attribute
GLOBAL:DataType TF-E rm attribute
GLOBAL:History attribute
GLOBAL:License No license provided, ask the author for permission m attribute
GLOBAL:ListenerShortName m attribute ID of the subject from the database
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 metre m attribute
ReceiverPosition [0 0.09 0; 0 -0.09 0] m RCI, RCM double
ReceiverPosition:Type cartesian m attribute
ReceiverPosition:Units metre m attribute
SourcePosition [0 0 0] m IC, MC double Source position is assumed to be the ListenerPosition in order to reflect Emitters surrounding the Listener
SourcePosition:Type spherical m attribute
SourcePosition:Units degree, degree, metre m attribute
EmitterPosition [0 0 0] m IC, ECI, ECM double Radius in 'spherical harmonics', Position in 'cartesian' and 'spherical'
EmitterPosition:Type spherical harmonics m attribute Can be 'spherical harmonics', 'cartesian', or 'spherical'
EmitterPosition:Units degree, degree, metre m attribute
GLOBAL:DatabaseName m attribute Name of the database to which these data belong
ListenerUp [0 0 1] m IC, MC double
ListenerView [1 0 0] m IC, MC double
ListenerView:Type cartesian m attribute
ListenerView:Units metre m attribute
Data.Real [0 0] m mrne double
Data.Imag [0 0] m MRNE double
N 0 m N double
N:LongName frequency m attribute narrative name of N
N:Units hertz m attribute