interp2 — Interpolate values over a two-dimensional gridded surface.
interp2(X, Y, Z, Xq, Yq) estimates surface values at query points from gridded data. Vector axes and meshgrid-style coordinate matrices are accepted. interp2(Z, Xq, Yq) uses implicit axes based on the rows and columns of Z.
Syntax
Zq = interp2(Z, Xq, Yq)
Zq = interp2(X, Y, Z, Xq, Yq)
Zq = interp2(X, Y, Z, Xq, Yq, method)Zis a dense 2-D matrix of sampled surface values.XandYmay be vector axes or meshgrid-style coordinate matrices matchingZ. When omitted, implicit column and row axes are used.XqandYqare scalar or same-size query arrays. Scalar queries broadcast against array queries.methodmay belinearornearestin the initial implementation. The default islinear.- Out-of-range queries return
NaNby default. Pass'extrap'to extrapolate or pass a scalar fill value.
How interp2 works
- Supports
linearandnearestmethods in the initial implementation. - Out-of-range query points return
NaNunless an extrapolation value or'extrap'is supplied. - Dense real numeric inputs are supported. GPU inputs gather to the host reference path.
Examples
Bilinear interpolation with implicit axes
Z = [1 2; 3 4];
zq = interp2(Z, 1.5, 1.5)Expected output:
zq = 2.5Interpolation with meshgrid axes
[X, Y] = meshgrid([10 20], [100 200]);
Z = [1 2; 3 4];
zq = interp2(X, Y, Z, 15, 150)Expected output:
zq = 2.5Related Math functions
Elementwise
abs · angle · conj · double · exp · expm1 · factorial · gamma · hypot · imag · ldivide · log · log10 · log1p · log2 · minus · nextpow2 · plus · pow2 · power · rdivide · real · sign · single · sqrt · times
Trigonometry
acos · acosh · asin · asinh · atan · atan2 · atanh · cos · cosh · sin · sinh · tan · tanh
Reduction
all · any · cummax · cummin · cumprod · cumsum · cumtrapz · diff · gradient · max · mean · median · min · nnz · prod · std · sum · trapz · var
Structure
Open-source implementation
Unlike proprietary runtimes, every RunMat function is open-source. Read exactly how interp2 works, line by line, in Rust.
- View interp2.rs on GitHub
- Learn how the runtime works
- Found a bug? Open an issue with a minimal reproduction.
About RunMat
RunMat is an open-source runtime that executes MATLAB-syntax code — faster, on any GPU, with no license required.
- Simulations that took hours now take minutes. RunMat automatically optimizes your math for GPU execution on Apple, Nvidia, and AMD hardware. No code changes needed.
- Start running code in seconds. Open the browser sandbox or download a single binary. No license server, no IT ticket, no setup.
- A full development environment. GPU-accelerated 2D and 3D plotting, automatic versioning on every save, and a browser IDE you can share with a link.