impz

Head-related impulse response

Since R2024a

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.

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

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

Examples

Compute Impulse Response of HRTF Data

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)

Compute Impulse Responses in Specified Plane

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)

Input Arguments

s — SOFA object

SimpleFreeFieldHRIR object | SimpleFreeFieldHRSOS object

SOFA object, specified as one of the following objects.

• SimpleFreeFieldHRIR

• SimpleFreeFieldHRSOS

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])

MeasurementIndex — Indices of measurements

1 (default) | vector of positive integers

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

Receiver — Indices of receivers

1 (default) | vector of positive integers

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 — Length of impulse response

positive integer

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

h — Impulse response

N-by-M-by-R array

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.

t — Time vector

vector of length N

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