Apply function to points within circular neighborhood

docs/api.rst

@@ -194,6 +194,7 @@ Methods
    Grid.compute_face_areas
    Grid.construct_face_centers
    Grid.get_ball_tree
+   Grid.neighborhoods
    Grid.get_kd_tree
    Grid.get_spatial_hash
    Grid.get_faces_containing_point
@@ -565,6 +566,30 @@ Azimuthal aggregations apply an aggregation (i.e. averaging) along circles of co
    UxDataArray.azimuthal_mean
 
 
+Neighborhood
+~~~~~~~~~~~~
+
+Neighborhood filters apply an aggregation (i.e. averaging) to all grid elements within a circular
+neighborhood of a specified radius around each grid element.
+
+.. autosummary::
+   :toctree: generated/
+
+   UxDataArray.neighborhood_filter
+   UxDataset.neighborhood_filter
+
+Finding the neighbors is usually more expensive than reducing over them. To apply several
+reductions at one radius, build the neighborhoods once and reduce over them repeatedly.
+
+.. autosummary::
+   :toctree: generated/
+
+   Grid.neighborhoods
+   uxarray.grid.neighbors.Neighborhoods
+   uxarray.grid.neighbors.Neighborhoods.reduce
+   uxarray.grid.neighbors.Neighborhoods.n_neighbors
+
+
 Zonal Average
 ~~~~~~~~~~~~~
 .. autosummary::