%INTERP3 3-D interpolation (table lookup) for gpuArray
%   Vq = interp3(V,Xq,Yq,Zq)
%   Vq = interp3(X,Y,Z,V,Xq,Yq,Zq)
%   Vq = interp3(V,Xq,Yq,Zq,METHOD)
%   Vq = interp3(X,Y,Z,V,Xq,Yq,Zq,METHOD)
%   Vq = interp3(V,Xq,Yq,Zq,METHOD,EXTRAPVAL)
%   Vq = interp3(X,Y,Z,V,Xq,Yq,Zq,METHOD,EXTRAPVAL)
%   Vq = interp3(V,NTIMES)
%   Vq = interp3(V) % same as interp3(V, 1)
%   
%   The value argument V must be a double or single 3-D array, real or complex. 
%   
%   The grid arguments X, Y and Z must have the following characteristics:
%     * Same type, double or single.
%     * Finite vectors or 3-D arrays with increasing and non-repeating elements in corresponding dimension. 
%     * When X, Y, and Z are 3-D arrays, they must align with cartesian axes, as if they were 
%       produced by meshgrid.
%     * Dimensions consistent with those of value V. 
%   
%   The query arguments Xq, Yq and Zq must be vectors or arrays of the same type (double or single). 
%   If Xq, Yq and Zq are arrays, they must be the same size. If they are vectors with different lengths, 
%   one of them must have different orientation.
%   
%   METHOD must be 'linear', 'nearest'.
%   
%   NTIMES currently only supports non-negative real scalars.
%   
%   The extrapolation for the out-of-boundary input is not supported.
%   
%   Example:
%    
%       [X,Y,Z,V] = flow(10);
%       xq = gpuArray.colon(0.1, 0.1, 10);
%       yq = gpuArray.colon(-3, 0.1, 3);
%       zq = gpuArray.colon(-3, 0.1, 3);
%       Vq = interp3(X, Y, Z, V, xq', yq, zq); % Vq is 61-by-100-by-61
%       [Xq,Yq,Zq] = meshgrid(xq, yq, zq);  
%       slice(Xq,Yq,Zq,Vq,[6 9.5],2,[-2 .2]); % shading flat
%   
%   creates an array Vq from linearly interpolating function values in V. 
%   The size of Vq equals that of Xq or Yq or Zq. The number of rows in Vq equals the length of yq. 
%   The number of columns in Vq equals the length of xq. The number of elements in the third dimension
%   equals the length of zq.  
%   
%   See also INTERP1, INTERP2, INTERPN, MESHGRID, SCATTEREDINTERPOLANT, GPUARRAY.
%   


%   Copyright 2013 The MathWorks, Inc.
