SingleRoomSRIR

From Sofaconventions
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