Main Content

impz

Head-related impulse response

Since R2024a

collapse all in page

    Syntax

    [h,t] = impz(s)
    [h,t] = impz(s,Name=Value)
    impz(___)

    Description

    [h,t] = impz(s) returns the head-related impulse response of the first measurement and the corresponding time vector.

    example

    [h,t] = impz(s,Name=Value) specifies options using one or more name-value arguments.

    example

    impz(___) with no output arguments plots the impulse response.

    example

    Examples

    collapse all

    Open Live Script

    Read in a SOFA file containing HRTF measurements.

    s = sofaread("ReferenceHRTF.sofa");

    Use impz to compute the impulse response of the first measurement for the first receiver.

    [h,t] = impz(s);

    Call impz with no output arguments to plot the impulse response of the first measurement for the first receiver.

    impz(s)

    Figure contains an axes object. The axes object with xlabel Time (s) contains an object of type line. This object represents Measurement 1. Receiver 1.

    Open Live Script

    Read in a SOFA file containing HRTF measurements.

    s = sofaread("ReferenceHRTF.sofa");

    Select the HRTF measurements in the sagittal plane at a lateral angle of 45 degrees. Plot the impulse responses of the second receiver for these measurements.

    idx = findMeasurements(s,Plane="sagittal",PlaneOffsetAngle=45);
impz(s,MeasurementIndex=idx,Receiver=2)

    Figure contains an axes object. The axes object with xlabel Time (s) contains 12 objects of type line. These objects represent Measurement 238. Receiver 2, Measurement 1008. Receiver 2, Measurement 239. Receiver 2, Measurement 1010. Receiver 2, Measurement 240. Receiver 2, Measurement 1134. Receiver 2, Measurement 1159. Receiver 2, Measurement 1176. Receiver 2, Measurement 1198. Receiver 2, Measurement 1323. Receiver 2, Measurement 557. Receiver 2, Measurement 1320. Receiver 2.

    Input Arguments

    collapse all

    SOFA object, specified as one of the following objects.

    Name-Value Arguments

    Specify optional pairs of arguments as Name1=Value1,...,NameN=ValueN, where Name is the argument name and Value is the corresponding value. Name-value arguments must appear after other arguments, but the order of the pairs does not matter.

    Example: impz(s, MeasurementIndex=1, Receiver=[1 2])

    Indices of measurements to use for the impulse response, specified as a vector of positive integers. The indices must correspond to measurements in the data of the SOFA object s.

    Data Types: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64

    Indices of the receivers to use for the impulse response, specified as a vector of positive integers.

    Data Types: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64

    Length of the impulse response, specified as a positive integer.

    For SimpleFreeFieldHRIR objects, the default value is the length of the impulse response measurements in the HRTF data. For SimpleFreeFieldHRSOS objects, the default value is the maximum length returned by impzlength over all of the SOS filters in the HRTF data.

    Data Types: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64

    Output Arguments

    collapse all

    Impulse response, returned as an N-by-M-by-R array, where:

    • N is the length of the impulse response.

    • M is the number of selected measurements defined by MeasurementIndex.

    • R is the number of selected receivers defined by Receiver.

    Time vector in seconds corresponding to the impulse response, returned as a vector of length N, where N is the length of the impulse response.

    Version History

    Introduced in R2024a

    See Also

    | | | | | | | |

    Topics