FreeFieldDirectivityFIR

Conventions to store directivities of acoustic sources (instruments, loudspeakers, singers, talkers, etc) as FIR datatype.

Name	Default	Flags	Dimensions	Type	Comment
GLOBAL:Conventions	SOFA	rm		attribute
GLOBAL:Version	2.1	rm		attribute
GLOBAL:SOFAConventions	FreeFieldDirectivityFIR	rm		attribute	This conventions stores directivities of acoustic sources (instruments, loudspeakers, singers, talkers, etc) as FIR datatype.
GLOBAL:SOFAConventionsVersion	0.1	rm		attribute
GLOBAL:DataType	FIR	rm		attribute	We use FIR datatype
GLOBAL:RoomType	free field	m		attribute	The room information can be arbitrary, but the spatial setup assumes free field.
GLOBAL:Title		m		attribute
GLOBAL:DateCreated		m		attribute
GLOBAL:DateModified		m		attribute
GLOBAL:APIName		rm		attribute
GLOBAL:APIVersion		rm		attribute
GLOBAL:AuthorContact		m		attribute
GLOBAL:Organization		m		attribute
GLOBAL:License	No license provided, ask the author for permission	m		attribute
GLOBAL:ApplicationName				attribute
GLOBAL:ApplicationVersion				attribute
GLOBAL:Comment				attribute
GLOBAL:History				attribute
GLOBAL:References				attribute
GLOBAL:Origin				attribute
GLOBAL:DatabaseName		m		attribute	Name of the database. Used for classification of the data
GLOBAL:Musician				attribute	Narrative description of the musician such as position, behavior, or personal data if not data-protected, e.g., 'Christiane Schmidt sitting on the chair', or 'artificial excitation by R2D2'.
GLOBAL:Description				attribute	Narrative description of a measurement. For musical instruments/singers, the note (C1, D1, etc) or the dynamic (pp., ff., etc), or the string played, the playing style (pizzicato, legato, etc.), or the type of excitation (e.g., hit location of a cymbal). For loudspeakers, the system and driver units.
GLOBAL:SourceType		m		attribute	Narrative description of the acoustic source, e.g., 'Violin', 'Female singer', or '2-way loudspeaker'
GLOBAL:SourceManufacturer		m		attribute	Narrative description of the manufacturer of the source, e.g., 'Stradivari, Lady Blunt, 1721' or 'LoudspeakerCompany'
GLOBAL:EmitterDescription				attribute	A more detailed structure of the source. In a simple setting, a single Emitter is considered that is collocated with the source. In a more complicated setting, this may be the strings of a violin or the units of a loudspeaker.
ListenerPosition	[0 0 0]	m	IC, MC	double	Position of the microphone array during the measurements.
ListenerPosition:Type	cartesian	m		attribute
ListenerPosition:Units	metre	m		attribute
ListenerView	[1 0 0]	m	IC, MC	double	Orientation of the microphone array
ListenerView:Type	cartesian	m		attribute
ListenerView:Units	metre	m		attribute
ListenerUp	[0 0 1]	m	IC, MC	double	Up vector of the microphone array
ReceiverPosition	[0 0 0]	m	ICI, RCI, RCM	double	Positions of the microphones during the measurements (relative to the Listener)
ReceiverPosition:Type	spherical	m		attribute	Type of the coordinate system used.
ReceiverPosition:Units	degree, degree, metre	m		attribute	Units of the coordinates.
SourcePosition	[0 0 0]	m	IC, MC	double	Position of the acoustic source (instrument)
SourcePosition:Type	cartesian	m		attribute
SourcePosition:Units	metre	m		attribute
SourcePosition:Reference		m		attribute	Narrative description of the spatial reference of the source position, e.g., 'The bell' for a trumpet or 'On the front plate between the low- and mid/high-frequency unit' for a loudspeaker. Mandatory in order to provide a reference across different sources.
SourceView	[1 0 0]	m	IC, MC	double	View vector for the orientation.
SourceView:Type	cartesian	m		attribute
SourceView:Units	metre	m		attribute
SourceView:Reference		m		attribute	Narrative description of the spatial reference of the source view, e.g., 'Viewing direction of the bell' for a trumpet or 'Perpendicular to the front plate' for a loudspeaker. Mandatory in order to provide a reference across different sources.
SourceUp	[0 0 1]	m	IC, MC	double	Up vector of the acoustic source (instrument)
SourceUp:Reference		m		attribute	Narrative description of the spatial reference of the source up, e.g., 'Along the keys, keys up' for a trumpet or 'Perpendicular to the top plate' for a loudspeaker. Mandatory in order to provide a reference across different sources.
EmitterPosition	[0 0 0]	m	eCI, eCM	double	Position. In a simple settings, a single emitter is considered that is collocated with the source.
EmitterPosition:Type	cartesian	m		attribute
EmitterPosition:Units	metre	m		attribute
EmitterDescriptions	{''}		MSI, ESI, MES	string	A more detailed description of the Emitters. For example, this may be the strings of a violin or the units of a loudspeaker.
MIDINote	0		I, M	double	Defines the note played by the source during the measurement. The note is specified a MIDI note by the MIDI specifications, version 1.0. Not mandatory, but recommended for tonal instruments.
Descriptions	{''}		MS	string	This variable is used when the description varies with M.
SourceTuningFrequency	440		I, M	double	Frequency (in hertz) to which a musical instrument is tuned to corresponding to the note A4 (MIDINote=69). Recommended for tonal instruments.
Data.IR	[0 0]	m	mRn	double
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, with the time interval as described by SamplingRate).