% nearestFace - Find faces nearest to specified point
% 
% nearestFace(GEOM,COORDS) finds faces of the geometry GEOM nearest to 
% the point with the coordinates COORDS. A coordinate vector COORDS has 
% 2 or 3 elements for a 2-D or 3-D geometry, respectively.
% 
% Example 1: Find faces nearest to the origin and the point with the 
% coordinates [1,1,1].
% 
% geom=multicuboid(1,1,1);
% nearestFace(geom,[0 0 0 ;1 1 1])
% pdegplot(geom,'CellLabels','on','FaceLabels','on','FaceAlpha',0.2)
% 
% 
% Example 2: Find faces nearest to two query points on a pair of 
% nested cubes.
% 
% geom = multicuboid([2 3 5],[4 6 10],3);
% nearestFace(geom,[0 0 0; 1 1 1])
% pdegplot(geom,'CellLabels','on','FaceLabels','on','FaceAlpha',0.2)
% 
% 
% See also cellFaces, facesAttachedToEdges, nearestEdge

%  Copyright 2020 The MathWorks, Inc.
%  Built-in function.
