Home > slabtools > imodelui.m

imodelui

PURPOSE ^

imodelui - room image model visualization with user-interface.

SYNOPSIS ^

function imodelui

DESCRIPTION ^

 imodelui - room image model visualization with user-interface.

 imodelui provides a user interface for imodel.  The SX, SY, and SZ sliders
 control source location (note: the source can be placed outside of the room).
 The XP-ZN sliders control the location of the walls.  The first letter of the
 slider label indicates the axis; the second letter indicates the positive (P)
 or negative (N) side of the axis.  This convention is used for labeling the
 reflections as well.  The V, Z, and U (see below) check boxes enable and
 disable the display of mirror rooms ([1], Fig.1).

 In the 3D-plot, the sound source is denoted by an 'x'.  1st-order reflections
 are displayed using red lower-case letters, 2nd-order using blue.  Mirror
 rooms are dotted.  The command-line lists the image locations by reflection
 label (D = 'direct path', aa (1st-order) and aabb (2nd-order) = surface(s)
 reflected off of).

 The following terms are defined to aid in visualization (the first letter
 is chosen to roughly resemble the sound path):
   V-type = 1st-order reflection, labeled aa
   Z-type = 2nd-order reflection, parallel walls, labeled aPaN and aNaP
   U-type = 2nd-order reflection, orthogonal walls, labeled aabb (aabb is
            equivalent to bbaa, i.e., the algorithm doesn't know which wall
            was encountered first)

 To rotate axes and zoom, use the Figure Toolbar (see the Figure dialog View
 menu).

 Reference:
 [1] J. Allen and D. Berkley, "Image method for efficiently simulating
     small-room acoustics", JASA 65(4), 1979.

 See Also: imodel.m, imodelab.m, imodel_cb.m, imodel_h.m

CROSS-REFERENCE INFORMATION ^

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