improver.utilities.load module

Module for loading cubes.

load_cube(filepath, constraints=None, no_lazy_load=False)[source]

Load the filepath provided using Iris into a cube. Strips off all var names except for “threshold”-type coordinates, where this is different from the standard or long name.

Parameters:
  • filepath (Union[str, List[str]]) – Filepath that will be loaded or list of filepaths that can be merged into a single cube.

  • constraints (Union[Constraint, str, None]) – Constraint to be applied when loading from the input filepath. This can be in the form of an iris.Constraint or could be a string that is intended to match the name of the cube. The default is None.

  • no_lazy_load (bool) – If True, bypass cube deferred (lazy) loading and load the whole cube into memory. This can increase performance at the cost of memory. If False (default) then lazy load.

Return type:

Cube

Returns:

Cube that has been loaded from the input filepath given the constraints provided.

load_cubelist(filepath, constraints=None, no_lazy_load=False)[source]

Load cubes from filepath(s) into a cubelist. Strips off all var names except for “threshold”-type coordinates, where this is different from the standard or long name.

Parameters:
  • filepath (Union[str, List[str]]) – Filepath(s) that will be loaded.

  • constraints (Union[Constraint, str, None]) – Constraint to be applied when loading from the input filepath. This can be in the form of an iris.Constraint or could be a string that is intended to match the name of the cube. The default is None.

  • no_lazy_load (bool) – If True, bypass cube deferred (lazy) loading and load the whole cube into memory. This can increase performance at the cost of memory. If False (default) then lazy load.

Return type:

CubeList

Returns:

CubeList that has been created from the input filepath given the constraints provided.