interpolate_to_points

metpy.interpolate.interpolate_to_points(points, values, xi, interp_type='linear', minimum_neighbors=3, gamma=0.25, kappa_star=5.052, search_radius=None, rbf_func='linear', rbf_smooth=0)[source]

Interpolate unstructured point data to the given points.

This function interpolates the given values valid at points to the points xi. This is modeled after scipy.interpolate.griddata, but acts as a generalization of it by including the following types of interpolation:

  • Linear
  • Nearest Neighbor
  • Cubic
  • Radial Basis Function
  • Natural Neighbor (2D Only)
  • Barnes (2D Only)
  • Cressman (2D Only)
Parameters:
  • points (array_like, shape (n, D)) – Coordinates of the data points.
  • values (array_like, shape (n,)) – Values of the data points.
  • xi (array_like, shape (M, D)) – Points to interpolate the data onto.
  • interp_type (str) – What type of interpolation to use. Available options include: 1) “linear”, “nearest”, “cubic”, or “rbf” from scipy.interpolate. 2) “natural_neighbor”, “barnes”, or “cressman” from metpy.interpolate. Default “linear”.
  • minimum_neighbors (int) – Minimum number of neighbors needed to perform barnes or cressman interpolation for a point. Default is 3.
  • gamma (float) – Adjustable smoothing parameter for the barnes interpolation. Default 0.25.
  • kappa_star (float) – Response parameter for barnes interpolation, specified nondimensionally in terms of the Nyquist. Default 5.052
  • search_radius (float) – A search radius to use for the barnes and cressman interpolation schemes. If search_radius is not specified, it will default to the average spacing of observations.
  • rbf_func (str) – Specifies which function to use for Rbf interpolation. Options include: ‘multiquadric’, ‘inverse’, ‘gaussian’, ‘linear’, ‘cubic’, ‘quintic’, and ‘thin_plate’. Defualt ‘linear’. See scipy.interpolate.Rbf for more information.
  • rbf_smooth (float) – Smoothing value applied to rbf interpolation. Higher values result in more smoothing.
Returns:

values_interpolated ((M,) ndarray) – Array representing the interpolated values for each input point in xi.

Notes

This function primarily acts as a wrapper for the individual interpolation routines. The individual functions are also available for direct use.