SingleRoomSRIR
Jump to navigation
Jump to search
This convention set defines a setup used for measuring Spatial room impulse responses (SRIRs) in a single room with a single excitation source (e.g., a loudspeaker) and a listener containing an arbitrary number of receivers (e.g., a microphone array). The data is represented as FIR filters and the positions of both the source and the listener may vary.
SingleRoomSRIR is the standardized version of the previously proposed SingleRoomDRIR.
Version 1.1
The conventions' version 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 | SingleRoomSRIR | rm | attribute | For measuring SRIRs in a single room with a single excitation source (e.g., a loudspeaker) and a listener containing an arbitrary number of omnidirectional receivers (e.g., a microphone array). | |
GLOBAL:SOFAConventionsVersion | 1.1 | rm | attribute | ||
GLOBAL:DataType | FIR | rm | attribute | Shall be FIR | |
GLOBAL:RoomType | shoebox | m | attribute | Shall be 'shoebox' or 'dae' | |
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:RoomShortName | attribute | Short name of the Room | |||
GLOBAL:RoomDescription | attribute | Informal verbal description of the room | |||
GLOBAL:RoomLocation | attribute | Location of the room | |||
GLOBAL:RoomGeometry | attribute | URI to a file describing the room geometry. | |||
RoomTemperature | 0 | I, M | double | Temperature during measurements, given in Kelvin. | |
RoomTemperature:Units | kelvin | attribute | Units of the room temperature. | ||
RoomVolume | 0 | I, M | double | Volume of the room. | |
RoomVolume:Units | cubic metre | attribute | Units of the room volume. | ||
RoomCornerA | [0 0 0] | IC, MC | double | ||
RoomCornerB | [1 2 3] | IC, MC | double | ||
RoomCorners | 0 | II | double | The value of this attribute is to be ignored. It only exist to for RoomCorners:Type and RoomCorners:Units | |
RoomCorners:Type | cartesian | attribute | |||
RoomCorners:Units | metre | attribute | |||
GLOBAL:ListenerShortName | attribute | ||||
GLOBAL:ListenerDescription | attribute | ||||
ListenerPosition | [0 0 0] | m | MC | double | |
ListenerPosition:Type | cartesian | m | attribute | ||
ListenerPosition:Units | metre | m | attribute | ||
ListenerView | [1 0 0] | m | IC, MC | double | |
ListenerUp | [0 0 1] | m | IC, MC | double | |
ListenerView:Type | cartesian | m | attribute | ||
ListenerView:Units | metre | m | attribute | ||
GLOBAL:ReceiverShortName | attribute | ||||
GLOBAL:ReceiverDescription | attribute | ||||
ReceiverDescriptions | {''} | MS, RS, MRS | string | M- and/or R-dependent version of the attribute ReceiverDescription with specific descriptions of the receivers. | |
ReceiverPosition | [0 0 0] | m | IC, RC, RCM | double | |
ReceiverPosition:Type | spherical | m | attribute | Can be of any type enabling both spatially discrete and spatially continuous representations. | |
ReceiverPosition:Units | degree, degree, metre | m | attribute | ||
ReceiverView | [1 0 0] | RCI, RCM | double | ||
ReceiverUp | [0 0 1] | RCI, RCM | double | ||
ReceiverView:Type | cartesian | attribute | |||
ReceiverView:Units | metre | attribute | |||
GLOBAL:SourceShortName | attribute | ||||
GLOBAL:SourceDescription | attribute | ||||
SourcePosition | [0 0 1] | m | MC | double | |
SourcePosition:Type | cartesian | m | attribute | ||
SourcePosition:Units | metre | m | attribute | ||
SourceView | [1 0 0] | m | IC, MC | double | |
SourceUp | [0 0 1] | m | IC, MC | double | |
SourceView:Type | cartesian | m | attribute | ||
SourceView:Units | metre | m | attribute | ||
GLOBAL:EmitterShortName | attribute | ||||
GLOBAL:EmitterDescription | attribute | ||||
EmitterDescriptions | {''} | MS, ES, MES | string | M- and/or E-dependent version of the attribute EmitterDescription with | |
specific descriptions of the emitters | |||||
EmitterPosition | [0 0 0] | m | eCI, eCM | double | |
EmitterPosition:Type | spherical | m | attribute | Shall be 'cartesian' or 'spherical', restricting to spatially discrete emitters. | |
EmitterPosition:Units | degree, degree, metre | m | attribute | ||
EmitterView | [1 0 0] | ECI, ECM | double | ||
EmitterUp | [0 0 1] | ECI, ECM | double | ||
EmitterView:Type | cartesian | attribute | Shall be 'cartesian' or 'spherical', restricting to spatially discrete emitters. | ||
EmitterView:Units | metre | attribute | |||
Data.IR | 0 | m | mrn | double | Impulse responses |
Data.SamplingRate | 48000 | m | I, M | 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 | IR, MR | double | Additional delay of each IR (in samples) |
MeasurementDate | 0 | M | double | Optional M-dependent date and time of the measurement |
Version 1.0
Version 1.0 is deprecated. Please use the updated version instead.
Name | Default | Flags | Dimensions | Type | Comment |
---|---|---|---|---|---|
GLOBAL:Conventions | SOFA | rm | attribute | ||
GLOBAL:Version | 2.1 | rm | attribute | ||
GLOBAL:SOFAConventions | SingleRoomSRIR | rm | attribute | For measuring SRIRs in a single room with a single excitation source (e.g., a loudspeaker) and a listener containing an arbitrary number of omnidirectional receivers (e.g., a microphone array). | |
GLOBAL:SOFAConventionsVersion | 1.0 | rm | attribute | ||
GLOBAL:DataType | FIR | rm | attribute | Shall be FIR | |
GLOBAL:RoomType | shoebox | m | attribute | Shall be 'shoebox' or 'dae' | |
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:RoomShortName | attribute | Short name of the Room | |||
GLOBAL:RoomDescription | attribute | Informal verbal description of the room | |||
GLOBAL:RoomLocation | attribute | Location of the room | |||
GLOBAL:RoomGeometry | attribute | URI to a file describing the room geometry. | |||
RoomTemperature | 0 | I, M | double | Temperature during measurements, given in Kelvin. | |
RoomTemperature:Units | kelvin | attribute | Units of the room temperature. | ||
RoomVolume | 0 | I, M | double | Volume of the room. | |
RoomVolume:Units | cubic metre | attribute | Units of the room volume. | ||
RoomCornerA | [0 0 0] | IC, MC | double | ||
RoomCornerB | [1 2 3] | IC, MC | double | ||
RoomCorners | 0 | II | double | The value of this attribute is to be ignored. It only exist to for RoomCorners:Type and RoomCorners:Units | |
RoomCorners:Type | cartesian | attribute | |||
RoomCorners:Units | metre | attribute | |||
GLOBAL:ListenerShortName | attribute | ||||
GLOBAL:ListenerDescription | attribute | ||||
ListenerPosition | [0 0 0] | m | MC | double | |
ListenerPosition:Type | cartesian | m | attribute | ||
ListenerPosition:Units | metre | m | attribute | ||
ListenerView | [1 0 0] | m | IC, MC | double | |
ListenerUp | [0 0 1] | m | IC, MC | double | |
ListenerView:Type | cartesian | m | attribute | ||
ListenerView:Units | metre | m | attribute | ||
GLOBAL:ReceiverShortName | attribute | ||||
GLOBAL:ReceiverDescription | attribute | ||||
ReceiverDescriptions | {''} | RS, RSM | string | R-dependent version of the attribute ReceiverDescription | |
ReceiverPosition | [0 0 0] | m | IC, RCI, RCM | double | |
ReceiverPosition:Type | spherical | m | attribute | Can be of any type enabling both spatially discrete and spatially continuous representations. | |
ReceiverPosition:Units | degree, degree, metre | m | attribute | ||
ReceiverView | [1 0 0] | RCI, RCM | double | ||
ReceiverUp | [0 0 1] | RCI, RCM | double | ||
ReceiverView:Type | cartesian | attribute | |||
ReceiverView:Units | metre | attribute | |||
GLOBAL:SourceShortName | attribute | ||||
GLOBAL:SourceDescription | attribute | ||||
SourcePosition | [0 0 1] | m | MC | double | |
SourcePosition:Type | cartesian | m | attribute | ||
SourcePosition:Units | metre | m | attribute | ||
SourceView | [1 0 0] | m | IC, MC | double | |
SourceUp | [0 0 1] | m | IC, MC | double | |
SourceView:Type | cartesian | m | attribute | ||
SourceView:Units | metre | m | attribute | ||
GLOBAL:EmitterShortName | attribute | ||||
GLOBAL:EmitterDescription | attribute | ||||
EmitterDescriptions | {''} | ES, ESM | string | E-dependent version of the attribute EmitterDescription | |
EmitterPosition | [0 0 0] | m | eCI, eCM | double | |
EmitterPosition:Type | spherical | m | attribute | Shall be 'cartesian' or 'spherical', restricting to spatially discrete emitters. | |
EmitterPosition:Units | degree, degree, metre | m | attribute | ||
EmitterView | [1 0 0] | ECI, ECM | double | ||
EmitterUp | [0 0 1] | ECI, ECM | double | ||
EmitterView:Type | cartesian | attribute | Shall be 'cartesian' or 'spherical', restricting to spatially discrete emitters. | ||
EmitterView:Units | metre | attribute | |||
Data.IR | 0 | m | mrn | double | Impulse responses |
Data.SamplingRate | 48000 | m | I, M | 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 | IR, MR | double | Additional delay of each IR (in samples) |
MeasurementDate | 0 | M | double | Optional M-dependent date and time of the measurement |