Home > slabtools > hcom.m

hcom

PURPOSE ^

hcom - HRTF database comparison utility.

SYNOPSIS ^

function hcom( h1, h2, ear, azp, elp, magplot, table, energy, itd, bcbe )

DESCRIPTION ^

 hcom - HRTF database comparison utility.

 hcom( h1, h2, ear, az, el, magplot, table, energy, itd, bcbe );

 h1:       slab3d archive struct

 h2:       slab3d archive struct for comparison.  If not specified, hcom()
           performs a symmetric head test (default = []).

 ear:      Ear to compare, 'l' or 'r' (default = 'l').

 az:       Azimuth to view (see h1.dgrid(2,:) for acceptable values).
           If az = -1 and el ~= -1, plot freq vs az vs difference for el
           (default = -1).

 el:       Elevation to view (see h1.dgrid(1,:) for acceptable values).
           If el = -1 and az ~= -1, plot freq vs el vs difference for az
           (default = -1).

 magplot:  Flag, display HRIR magnitude response plot (default = 0).

 table:    Flag, display metrics for each grid location (default = 0).

 energy:   Flag, display frequency-computed energy plots for each HRTF
           database (default = 0).

 itd:      Flag, display ITDs for each HRTF database (default = 0).

 bcbe:     Flag, use critical band energy when calculating spectral difference
           (default = 1).

 hcom() provides a variety of displays for HRTF comparison.  hcom also
 calculates the following difference metrics:
     SED(w), SED RMS, CBED(w), CBED RMS
 SED(w) is the spectral energy ratio difference (i.e., the difference
 between two log-scale magnitude responses).  SED RMS, the RMS of the SED(w)
 difference sequence, captures the difference across all frequency bands.
 Critical-Band (CB) filtering (20 bands between 20Hz and 20kHz) can be
 performed to improve the perceptual significance of the difference.
 In this case, CBED(w) and CBED RMS are calculated in place of SED(w) and
 SED RMS.

 hcom() can display a difference table and the following figures:
    1) az vs el vs RMS difference
    2) for a single az, freq vs el vs difference
    3) for a single el, freq vs az vs difference
    4) for an (az,el) pair, freq vs mag and freq vs difference
    5) h1 ITD
    6) h2 ITD
    7) h1/h2 ITD differences
    8) left ear energy
    9) right ear energy
   10) h1/h2 energy differences

 Note: All gray colormaps are inverted, i.e., large values dark.

 See Also: hlab.m, hen.m, vir.m, vitd.m

CROSS-REFERENCE INFORMATION ^

This function calls: This function is called by:
Generated on Fri 20-Nov-2009 18:52:57 by m2html © 2003