GeneralFIR - Revision history

Isfmiho: /* Description */

2022-10-21T10:13:51Z

Description

← Older revision		Revision as of 12:13, 21 October 2022
Line 5:		Line 5:
	This conventions can be used to save data which are too general to store in more specific conventions. Examples:		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,		* the exact measurement setup of an HRTF set,
	* raw data of headphone measurements		* raw data of headphone measurements.

	== Version 1.0 ==		== Version 1.0 ==

Isfmiho: /* Version 1.0 */

2022-10-21T10:13:40Z

Version 1.0

← Older revision		Revision as of 12:13, 21 October 2022
Line 7:		Line 7:
	* raw data of headphone measurements		* raw data of headphone measurements

	== Version 2.0 ==		== Version 1.0 ==
	{\| border="1"		{\| border="1"
	!Name		!Name
Line 18:		Line 18:
	\|GLOBAL:Conventions\|\|<nowiki>SOFA</nowiki>\|\|rm\|\|\|\|attribute\|\|		\|GLOBAL:Conventions\|\|<nowiki>SOFA</nowiki>\|\|rm\|\|\|\|attribute\|\|
	\|-		\|-
	\|GLOBAL:Version\|\|<nowiki>2.0</nowiki>\|\|rm\|\|\|\|attribute\|\|		\|GLOBAL:Version\|\|<nowiki>2.1</nowiki>\|\|rm\|\|\|\|attribute\|\|
	\|-		\|-
	\|GLOBAL:SOFAConventions\|\|<nowiki>GeneralFIR</nowiki>\|\|rm\|\|\|\|attribute\|\|This conventions stores IRs for general purposes, i.e., only the mandatory, SOFA general metadata are pre-defined		\|GLOBAL:SOFAConventions\|\|<nowiki>GeneralFIR</nowiki>\|\|rm\|\|\|\|attribute\|\|This conventions stores IRs for general purposes, i.e., only the mandatory, SOFA general metadata are pre-defined
	\|-		\|-
	\|GLOBAL:SOFAConventionsVersion\|\|<nowiki>2.0</nowiki>\|\|rm\|\|\|\|attribute\|\|		\|GLOBAL:SOFAConventionsVersion\|\|<nowiki>1.0</nowiki>\|\|rm\|\|\|\|attribute\|\|
	\|-		\|-
	\|GLOBAL:APIName\|\|<nowiki></nowiki>\|\|rm\|\|\|\|attribute\|\|		\|GLOBAL:APIName\|\|<nowiki></nowiki>\|\|rm\|\|\|\|attribute\|\|
Line 94:		Line 94:
	\|ListenerView:Units\|\|<nowiki>metre</nowiki>\|\|\|\|\|\|attribute\|\|		\|ListenerView:Units\|\|<nowiki>metre</nowiki>\|\|\|\|\|\|attribute\|\|
	\|}		\|}

	== Version 0.9 ==		== Version 0.9 ==
	Version 0.9 is deprecated. Please use Conventions version 1.0 instead.		Version 0.9 is deprecated. Please use Conventions version 1.0 instead.

Isfmiho: /* Version 1.0 */

2022-10-21T10:13:02Z

Version 1.0

← Older revision		Revision as of 12:13, 21 October 2022
Line 94:		Line 94:
	\|ListenerView:Units\|\|<nowiki>metre</nowiki>\|\|\|\|\|\|attribute\|\|		\|ListenerView:Units\|\|<nowiki>metre</nowiki>\|\|\|\|\|\|attribute\|\|
	\|}		\|}
	== Version 1.0 ==		== Version 0.9 ==
	Version 1.0 is deprecated. Please use Conventions version 2.0 instead.		Version 0.9 is deprecated. Please use Conventions version 1.0 instead.


Line 112:		Line 112:
	\|GLOBAL:SOFAConventions\|\|<nowiki>GeneralFIR</nowiki>\|\|rm\|\|\|\|attribute\|\|This conventions stores IRs for general purposes, i.e., only the mandatory, SOFA general metadata are pre-defined		\|GLOBAL:SOFAConventions\|\|<nowiki>GeneralFIR</nowiki>\|\|rm\|\|\|\|attribute\|\|This conventions stores IRs for general purposes, i.e., only the mandatory, SOFA general metadata are pre-defined
	\|-		\|-
	\|GLOBAL:SOFAConventionsVersion\|\|<nowiki>1.0</nowiki>\|\|rm\|\|\|\|attribute\|\|		\|GLOBAL:SOFAConventionsVersion\|\|<nowiki>0.9</nowiki>\|\|rm\|\|\|\|attribute\|\|
	\|-		\|-
	\|GLOBAL:APIName\|\|<nowiki></nowiki>\|\|rm\|\|\|\|attribute\|\|		\|GLOBAL:APIName\|\|<nowiki></nowiki>\|\|rm\|\|\|\|attribute\|\|

Isfmiho: /* Version 1.0 */

2021-10-05T09:19:04Z

Version 1.0

← Older revision		Revision as of 11:19, 5 October 2021
Line 95:		Line 95:
	\|}		\|}
	== Version 1.0 ==		== Version 1.0 ==
			Version 1.0 is deprecated. Please use Conventions version 2.0 instead.


	{\| border="1"		{\| border="1"

Isfmiho at 09:18, 5 October 2021

2021-10-05T09:18:39Z

@@ Line 1: / Line 1: @@
 This conventions defines only that FIR is the DataType. All other metadata follow the general SOFA specifications.
@@ Line 5: / Line 7: @@
 * raw data of headphone measurements
 {| border="1"
 !Name
@@ Line 81: / Line 83: @@
 |-
 |Data.SamplingRate||<nowiki>48000</nowiki>||m||I, M||double||Sampling rate of the samples in Data.IR and Data.Delay
 |-
 |Data.SamplingRate:Units||<nowiki>hertz</nowiki>||m||||attribute||Unit of the sampling rate

Isfmiho at 08:43, 5 October 2021

2021-10-05T08:43:27Z

Show changes

Isfmiho at 10:46, 14 January 2021

2021-01-14T10:46:15Z

Show changes

Isfmiho at 10:45, 14 January 2021

2021-01-14T10:45:04Z

← Older revision		Revision as of 12:45, 14 January 2021
Line 9:		Line 9:
	!Name		!Name
	!Default		!Default
			![[SOFA_conventions#AnchorFlags\|Flags]]
	!Flags
	!Dimensions		![[SOFA_conventions#AnchorDimensions\|Dimensions]]
	!Type		!Type
	!Comment		!Comment

Petibub at 12:04, 13 May 2015

2015-05-13T12:04:53Z

← Older revision		Revision as of 14:04, 13 May 2015
Line 4:		Line 4:
	* the exact measurement setup of an HRTF set,		* the exact measurement setup of an HRTF set,
	* raw data of headphone measurements		* raw data of headphone measurements


	{\| border="1"		{\| border="1"
Line 59:		Line 60:
	\|ListenerPosition:Units\|\|<nowiki>metre</nowiki>\|\|m\|\|\|\|attribute\|\|		\|ListenerPosition:Units\|\|<nowiki>metre</nowiki>\|\|m\|\|\|\|attribute\|\|
	\|-		\|-
	\|ReceiverPosition\|\|<nowiki>[0 0~~.09 0; 0 -0.09~~ 0]</nowiki>\|\|m\|\|rCI, rCM\|\|double\|\|		\|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 77:		Line 78:
	\|EmitterPosition:Units\|\|<nowiki>metre</nowiki>\|\|m\|\|\|\|attribute\|\|		\|EmitterPosition:Units\|\|<nowiki>metre</nowiki>\|\|m\|\|\|\|attribute\|\|
	\|-		\|-
	\|Data.IR\|\|<nowiki>~~[1 1]~~</nowiki>\|\|m\|\|mRn\|\|double\|\|Impulse responses		\|Data.IR\|\|<nowiki>0</nowiki>\|\|m\|\|mRn\|\|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 83:		Line 84:
	\|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>[0 0]</nowiki>\|\|m\|\|IR, MR\|\|double\|\|Additional delay of each IR (in samples)		\|Data.Delay\|\|<nowiki>0</nowiki>\|\|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)

Petibub at 19:31, 11 May 2015

2015-05-11T19:31:01Z

← Older revision		Revision as of 21:31, 11 May 2015
Line 4:		Line 4:
	* the exact measurement setup of an HRTF set,		* the exact measurement setup of an HRTF set,
	* raw data of headphone measurements		* raw data of headphone measurements

			{\| border="1"
			!Name
			!Default
			!Flags
			!Dimensions
			!Type
			!Comment
			\|-
			\|GLOBAL:Conventions\|\|<nowiki>SOFA</nowiki>\|\|rm\|\|\|\|attribute\|\|
			\|-
			\|GLOBAL:Version\|\|<nowiki>1.0</nowiki>\|\|rm\|\|\|\|attribute\|\|
			\|-
			\|GLOBAL:SOFAConventions\|\|<nowiki>GeneralFIR</nowiki>\|\|rm\|\|\|\|attribute\|\|This conventions stores IRs for general purposes, i.e., only the mandatory, SOFA general metadata are pre-defined
			\|-
			\|GLOBAL:SOFAConventionsVersion\|\|<nowiki>1.0</nowiki>\|\|rm\|\|\|\|attribute\|\|
			\|-
			\|GLOBAL:APIName\|\|<nowiki></nowiki>\|\|rm\|\|\|\|attribute\|\|
			\|-
			\|GLOBAL:APIVersion\|\|<nowiki></nowiki>\|\|rm\|\|\|\|attribute\|\|
			\|-
			\|GLOBAL:ApplicationName\|\|<nowiki></nowiki>\|\|\|\|\|\|attribute\|\|
			\|-
			\|GLOBAL:ApplicationVersion\|\|<nowiki></nowiki>\|\|\|\|\|\|attribute\|\|
			\|-
			\|GLOBAL:AuthorContact\|\|<nowiki></nowiki>\|\|m\|\|\|\|attribute\|\|
			\|-
			\|GLOBAL:Comment\|\|<nowiki></nowiki>\|\|m\|\|\|\|attribute\|\|
			\|-
			\|GLOBAL:DataType\|\|<nowiki>FIR</nowiki>\|\|rm\|\|\|\|attribute\|\|We store IRs here
			\|-
			\|GLOBAL:History\|\|<nowiki></nowiki>\|\|\|\|\|\|attribute\|\|
			\|-
			\|GLOBAL:License\|\|<nowiki>No license provided, ask the author for permission</nowiki>\|\|m\|\|\|\|attribute\|\|
			\|-
			\|GLOBAL:Organization\|\|<nowiki></nowiki>\|\|m\|\|\|\|attribute\|\|
			\|-
			\|GLOBAL:References\|\|<nowiki></nowiki>\|\|\|\|\|\|attribute\|\|
			\|-
			\|GLOBAL:RoomType\|\|<nowiki>free field</nowiki>\|\|m\|\|\|\|attribute\|\|The room information can be arbitrary
			\|-
			\|GLOBAL:Origin\|\|<nowiki></nowiki>\|\|\|\|\|\|attribute\|\|
			\|-
			\|GLOBAL:DateCreated\|\|<nowiki></nowiki>\|\|m\|\|\|\|attribute\|\|
			\|-
			\|GLOBAL:DateModified\|\|<nowiki></nowiki>\|\|m\|\|\|\|attribute\|\|
			\|-
			\|GLOBAL:Title\|\|<nowiki></nowiki>\|\|m\|\|\|\|attribute\|\|
			\|-
			\|ListenerPosition\|\|<nowiki>[0 0 0] </nowiki>\|\|m\|\|IC, MC\|\|double\|\|
			\|-
			\|ListenerPosition:Type\|\|<nowiki>cartesian</nowiki>\|\|m\|\|\|\|attribute\|\|
			\|-
			\|ListenerPosition:Units\|\|<nowiki>metre</nowiki>\|\|m\|\|\|\|attribute\|\|
			\|-
			\|ReceiverPosition\|\|<nowiki>[0 0.09 0; 0 -0.09 0]</nowiki>\|\|m\|\|rCI, rCM\|\|double\|\|
			\|-
			\|ReceiverPosition:Type\|\|<nowiki>cartesian</nowiki>\|\|m\|\|\|\|attribute\|\|
			\|-
			\|ReceiverPosition:Units\|\|<nowiki>metre</nowiki>\|\|m\|\|\|\|attribute\|\|
			\|-
			\|SourcePosition\|\|<nowiki>[0 0 1]</nowiki>\|\|m\|\|IC, MC\|\|double\|\|In order to store different directions/positions around the listener, SourcePosition is assumed to vary
			\|-
			\|SourcePosition:Type\|\|<nowiki>spherical</nowiki>\|\|m\|\|\|\|attribute\|\|
			\|-
			\|SourcePosition:Units\|\|<nowiki>degree, degree, metre</nowiki>\|\|m\|\|\|\|attribute\|\|
			\|-
			\|EmitterPosition\|\|<nowiki>[0 0 0]</nowiki>\|\|m\|\|eCI, eCM\|\|double\|\|
			\|-
			\|EmitterPosition:Type\|\|<nowiki>cartesian</nowiki>\|\|m\|\|\|\|attribute\|\|
			\|-
			\|EmitterPosition:Units\|\|<nowiki>metre</nowiki>\|\|m\|\|\|\|attribute\|\|
			\|-
			\|Data.IR\|\|<nowiki>[1 1]</nowiki>\|\|m\|\|mRn\|\|double\|\|Impulse responses
			\|-
			\|Data.SamplingRate\|\|<nowiki>48000</nowiki>\|\|m\|\|I\|\|double\|\|Sampling rate of the samples in Data.IR and Data.Delay
			\|-
			\|Data.SamplingRate:Units\|\|<nowiki>hertz</nowiki>\|\|m\|\|\|\|attribute\|\|Unit of the sampling rate
			\|-
			\|Data.Delay\|\|<nowiki>[0 0]</nowiki>\|\|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)