GeneralFIR

This conventions defines only that FIR is the DataType. All other metadata follow the general SOFA specifications.

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

• the exact measurement setup of an HRTF set,
• raw data of headphone measurements

Name	Default	Flags	Dimensions	Type	Comment
GLOBAL:Conventions	SOFA	rm		attribute
GLOBAL:Version	1.0	rm		attribute
GLOBAL:SOFAConventions	GeneralFIR	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	FIR	rm		attribute	We store IRs here
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.09 0; 0 -0.09 0]	m	rCI, rCM	double
ReceiverPosition:Type	cartesian	m		attribute
ReceiverPosition:Units	metre	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, metre	m		attribute
EmitterPosition	[0 0 0]	m	eCI, eCM	double
EmitterPosition:Type	cartesian	m		attribute
EmitterPosition:Units	metre	m		attribute
Data.IR	[1 1]	m	mRn	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	IR, MR	double	Additional delay of each IR (in samples)

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)