Update comments of sofa related functions

Author: hagenw

SFS_ir/sofa_get_data_fir.m

@@ -5,12 +5,11 @@
 %
 %   Input parameters:
 %       sofa    - impulse response data set (SOFA struct/file)
-%       idx     - index of the single impulse responses that should be returned
+%       idx     - index of the single impulse responses that should be returned.
 %                 idx could be a single value, then only one impulse response
 %                 will be returned, or it can be a vector then all impulse
 %                 responses for the corresponding index positions will be
-%                 returned.
-%                 If no index is specified all data will be returned.
+%                 returned (default: return all impulse responses)
 %
 %   Output parameters:
 %       ir      - impulse response (M,2,N), where

SFS_ir/sofa_get_data_fire.m

@@ -10,10 +10,9 @@
 %                 idxM could be a single value, then only one impulse response
 %                 will be returned, or it can be a vector then all impulse
 %                 responses for the corresponding index positions will be
-%                 returned.
-%                 If no index is specified all measurements will be returned.
+%                 returned (default: all measurements).
 %       idxE    - index of the emitter for which the single impulse
-%                 responses should be returned. The rest is identical to idxM.
+%                 responses should be returned (default: all measurements).
 %
 %   Output parameters:
 %       ir      - impulse response (M,2,E,N), where

SFS_ir/sofa_get_head_orientations.m

@@ -5,12 +5,12 @@
 %
 %   Input parameters:
 %       sofa    - impulse response data set (SOFA struct/file)
-%       idx     - index of secondary sources that should be returned.
-%                 If no index is specified all sources will be returned.
+%       idx     - index of measurement for which head orientation should be
+%                 returned (default: return all head orientations)
 %
 %   Output parameters:
-%       phi     - head orientations in the horizontal plane
-%       theta   - head orientations in the median plane
+%       phi     - head orientations in the horizontal plane / rad
+%       theta   - head orientations in the median plane / rad
 %
 %   SOFA_GET_HEAD_ORIENTATIONS(sofa,idx) returns head orientation [phi,theta] as
 %   defined in the given SOFA file or struct, specified by idx. If no idx is

SFS_ir/sofa_get_listener_position.m

@@ -2,7 +2,7 @@
 %SOFA_GET_LISTENER_POSITION returns the listener position from the given SOFA
 %data set
 %
-%   Usage: X = sofa_get_listener_position(sofa,[idx])
+%   Usage: X = sofa_get_listener_position(sofa,[coordinate_system])
 %
 %   Input parameters:
 %       sofa              - impulse response data set (SOFA struct/file)

SFS_ir/sofa_get_secondary_sources.m

@@ -5,9 +5,8 @@
 %
 %   Input parameters:
 %       sofa              - impulse response data set (SOFA struct/file)
-%       idx               - index of secondary sources that should be returned.
-%                           If no index is specified all sources will be
-%                           returned.
+%       idx               - index of secondary sources that should be returned
+%                           (default: return all secondary sources).
 %       coordinate_system - coordinate system the position and direction of the
 %                           secondary sources should be specified in:
 %                             'cartesian' (default)