Utility operations specific to unstructured data.
In this module:
- iris.experimental.ugrid.utils.recombine_submeshes(mesh_cube: iris.cube.Cube, submesh_cubes: Union[Iterable[iris.cube.Cube], iris.cube.Cube], index_coord_name: AnyStr = 'i_mesh_index') iris.cube.Cube
Put data from sub-meshes back onto the original full mesh.
The result is a cube like
mesh_cube, but with its data replaced by a combination of the data in the
submesh_cubes (iterable of Cube, or Cube) – Cubes, each with data on a _subset_ of the
mesh_cubedatapoints (within the mesh dimension). The submesh cubes do not need to have a mesh. There must be at least 1 of them, to determine the result phenomenon. Their metadata (names, units and attributes) must all be the same, _except_ that ‘var_name’ is ignored. Their dtypes must all be the same. Their shapes and dimension-coords must all match those of
mesh_cube, except in the mesh dimension, which can have different sizes between the submeshes, and from the
mesh_cube. The mesh dimension of each must have a 1-D coord named by
index_coord_name. These “index coords” can vary in length, but they must all have matching metadata (units, attributes and names except ‘var_name’), and must also match the coord of that name in
mesh_cube, if there is one. The “.points” values of the index coords specify, for each datapoint, its location in the original mesh – i.e. they are indices into the relevant mesh-location dimension.
index_coord_name (Cube) – Coord name of an index coord containing the mesh location indices, in every submesh cube.
A cube with the same mesh, location, and shape as
mesh_cube, but with its data replaced by that from the``submesh_cubes``. The result phenomeon identity is also that of the``submesh_cubes``, i.e. units, attributes and names (except ‘var_name’, which is None).
- Return type
Where regions overlap, the result data comes from the submesh cube containing that location which appears _last_ in
Where no region contains a datapoint, it will be masked in the result. HINT: alternatively, values covered by no region can be set to the original ‘full_mesh_cube’ data value, if ‘full_mesh_cube’ is also passed as the first of the ‘region_cubes’.
result_cubedtype is that of the