You are viewing the latest unreleased documentation v3.3.dev0. You may prefer a stable version.

iris.experimental.regrid_conservative#

Support for conservative regridding via ESMPy.

Note

Deprecated since version 3.2.0.

This package will be removed in a future release. Please use iris-esmf-regrid instead.

In this module:

iris.experimental.regrid_conservative.regrid_conservative_via_esmpy(source_cube, grid_cube)[source]#

Perform a conservative regridding with ESMPy.

Note

Deprecated since version 3.2.0.

This function is scheduled to be removed in a future release. Please use iris-esmf-regrid instead.

For example :

from emsf_regrid.schemes import ESMFAreaWeighted
result = src_cube.regrid(grid_cube, ESMFAreaWeighted())

Regrids the data of a source cube onto a new grid defined by a destination cube.

Args:

  • source_cube (iris.cube.Cube):

    Source data. Must have two identifiable horizontal dimension coordinates.

  • grid_cube (iris.cube.Cube):

    Define the target horizontal grid: Only the horizontal dimension coordinates are actually used.

Returns

A new cube derived from source_cube, regridded onto the specified horizontal grid.

Any additional coordinates which map onto the horizontal dimensions are removed, while all other metadata is retained. If there are coordinate factories with 2d horizontal reference surfaces, the reference surfaces are also regridded, using ordinary bilinear interpolation.

Note

Both source and destination cubes must have two dimension coordinates identified with axes ‘X’ and ‘Y’ which share a coord_system with a Cartopy CRS. The grids are defined by iris.coords.Coord.contiguous_bounds() of these.

Note

Initialises the ESMF Manager, if it was not already called. This implements default Manager operations (e.g. logging).

To alter this, make a prior call to ESMF.Manager().