Documentation |
Interpolation for 3-D gridded data in meshgrid format
In a future release, interp3 will not accept mixed combinations of row and column vectors for the sample and query grids. For more information, and recommendations for updating your code, see Functionality being removed or changed.
Vq = interp3(X,Y,Z,V,Xq,Yq,Zq) returns interpolated values of a function of three variables at specific query points using linear interpolation. The results always pass through the original sampling of the function. X, Y, and Z contain the coordinates of the sample points. V contains the corresponding function values at each sample point. Xq, Yq, and Zq contain the coordinates of the query points.
Vq = interp3(V,Xq,Yq,Zq) assumes a default grid of sample points. The default grid points cover the region, X=1:n, Y=1:m, Z=1:p, where [m,n,p] = size(V). Use this syntax when you want to conserve memory and are not concerned about the absolute distances between points.
Vq = interp3(___,method) specifies an optional, trailing input argument that you can pass with any of the previous syntaxes. The method argument can be any of the following strings that specify alternative interpolation methods: 'linear', 'nearest', 'cubic', or 'spline'. The default method is 'linear'.
Vq = interp3(___,method,extrapval) also specifies extrapval, a scalar value that is assigned to all queries that lie outside the domain of the sample points.
If you omit the extrapval argument for queries outside the domain of the sample points, then based on the method argument interp3 returns one of the following:
The extrapolated values for the 'spline' method
NaN values for interpolation methods other than 'spline'