iris.exceptions#

Exceptions specific to the Iris package.

API reference

Tags: topic_troubleshooting

exception iris.exceptions.AncillaryVariableNotFoundError[source]#

Bases: CubeComponentNotFoundError

Raised when a search yields no ancillary variables.

add_note(note, /)[source]#: Add a note to the exception

args[source]#

with_traceback(tb, /)[source]#: Set self.__traceback__ to tb and return self.

exception iris.exceptions.CFParseError[source]#

Bases: IrisError

Raised when a string associated with a CF defined syntax could not be parsed.

add_note(note, /)[source]#: Add a note to the exception

args[source]#

with_traceback(tb, /)[source]#: Set self.__traceback__ to tb and return self.

exception iris.exceptions.CannotAddError[source]#

Bases: ValueError

Raised when an object (e.g. coord) cannot be added to a Cube.

add_note(note, /)[source]#: Add a note to the exception

args[source]#

with_traceback(tb, /)[source]#: Set self.__traceback__ to tb and return self.

exception iris.exceptions.CellMeasureNotFoundError[source]#

Bases: CubeComponentNotFoundError

Raised when a search yields no cell measures.

add_note(note, /)[source]#: Add a note to the exception

args[source]#

with_traceback(tb, /)[source]#: Set self.__traceback__ to tb and return self.

exception iris.exceptions.ConcatenateError(differences)[source]#

Bases: IrisError

Raised when concatenate is expected to produce a single cube, but fails to do so.

Create a ConcatenateError with a list of textual descriptions of differences.

Create a ConcatenateError with a list of textual descriptions of the differences which prevented a concatenate.

Parameters:: differences (list of str) – The list of strings which describe the differences.

add_note(note, /)[source]#: Add a note to the exception

args[source]#

with_traceback(tb, /)[source]#: Set self.__traceback__ to tb and return self.

exception iris.exceptions.ConnectivityNotFoundError[source]#

Bases: KeyError

Raised when a search yields no connectivities.

add_note(note, /)[source]#: Add a note to the exception

args[source]#

with_traceback(tb, /)[source]#: Set self.__traceback__ to tb and return self.

exception iris.exceptions.ConstraintMismatchError[source]#

Bases: IrisError

Raised when a constraint operation has failed to find the correct number of results.

add_note(note, /)[source]#: Add a note to the exception

args[source]#

with_traceback(tb, /)[source]#: Set self.__traceback__ to tb and return self.

exception iris.exceptions.CoordinateCollapseError[source]#

Bases: IrisError

Raised when a requested coordinate cannot be collapsed.

add_note(note, /)[source]#: Add a note to the exception

args[source]#

with_traceback(tb, /)[source]#: Set self.__traceback__ to tb and return self.

exception iris.exceptions.CoordinateMultiDimError(msg)[source]#

Bases: ValueError

Raised when a routine doesn’t support multi-dimensional coordinates.

add_note(note, /)[source]#: Add a note to the exception

args[source]#

with_traceback(tb, /)[source]#: Set self.__traceback__ to tb and return self.

exception iris.exceptions.CoordinateNotFoundError[source]#

Bases: CubeComponentNotFoundError

Raised when a search yields no coordinates.

add_note(note, /)[source]#: Add a note to the exception

args[source]#

with_traceback(tb, /)[source]#: Set self.__traceback__ to tb and return self.

exception iris.exceptions.CoordinateNotRegularError[source]#

Bases: ValueError

Raised when a coordinate is unexpectedly irregular.

add_note(note, /)[source]#: Add a note to the exception

args[source]#

with_traceback(tb, /)[source]#: Set self.__traceback__ to tb and return self.

exception iris.exceptions.CubeComponentNotFoundError[source]#

Bases: KeyError

Raised when a search yields no cube components.

add_note(note, /)[source]#: Add a note to the exception

args[source]#

with_traceback(tb, /)[source]#: Set self.__traceback__ to tb and return self.

exception iris.exceptions.DatalessError[source]#

Bases: ValueError

Raised when a method cannot be performed on a dataless Cube.

add_note(note, /)[source]#: Add a note to the exception

args[source]#

with_traceback(tb, /)[source]#: Set self.__traceback__ to tb and return self.

exception iris.exceptions.DuplicateDataError(msg)[source]#

Bases: MergeError

Raised when merging two or more cubes that have identical metadata.

Create a MergeError with a list of textual descriptions of the differences.

Creates a MergeError with a list of textual descriptions of the differences which prevented a merge.

Parameters:: differences (list of str) – The list of strings which describe the differences.

add_note(note, /)[source]#: Add a note to the exception

args[source]#

with_traceback(tb, /)[source]#: Set self.__traceback__ to tb and return self.

exception iris.exceptions.IgnoreCubeException[source]#

Bases: IrisError

Raised from a callback function when a cube should be ignored on load.

add_note(note, /)[source]#: Add a note to the exception

args[source]#

with_traceback(tb, /)[source]#: Set self.__traceback__ to tb and return self.

exception iris.exceptions.InvalidCubeError[source]#

Bases: IrisError

Raised when a Cube validation check fails.

add_note(note, /)[source]#: Add a note to the exception

args[source]#

with_traceback(tb, /)[source]#: Set self.__traceback__ to tb and return self.

exception iris.exceptions.IrisError[source]#

Bases: Exception

Base class for errors in the Iris package.

add_note(note, /)[source]#: Add a note to the exception

args[source]#

with_traceback(tb, /)[source]#: Set self.__traceback__ to tb and return self.

exception iris.exceptions.LazyAggregatorError[source]#

Bases: Exception

add_note(note, /)[source]#: Add a note to the exception

args[source]#

with_traceback(tb, /)[source]#: Set self.__traceback__ to tb and return self.

exception iris.exceptions.MergeError(differences)[source]#

Bases: IrisError

Raised when merge is expected to produce a single cube, but fails to do so.

Create a MergeError with a list of textual descriptions of the differences.

Creates a MergeError with a list of textual descriptions of the differences which prevented a merge.

Parameters:: differences (list of str) – The list of strings which describe the differences.

add_note(note, /)[source]#: Add a note to the exception

args[source]#

with_traceback(tb, /)[source]#: Set self.__traceback__ to tb and return self.

exception iris.exceptions.MonotonicityError[source]#

Bases: ValueError

Raised when a coordinate values are not monotonic.

add_note(note, /)[source]#: Add a note to the exception

args[source]#

with_traceback(tb, /)[source]#: Set self.__traceback__ to tb and return self.

exception iris.exceptions.NotYetImplementedError[source]#

Bases: IrisError

Raised by missing functionality.

Different meaning to NotImplementedError, which is for abstract methods.

add_note(note, /)[source]#: Add a note to the exception

args[source]#

with_traceback(tb, /)[source]#: Set self.__traceback__ to tb and return self.

exception iris.exceptions.TranslationError[source]#

Bases: IrisError

Raised when Iris is unable to translate format-specific codes.

add_note(note, /)[source]#: Add a note to the exception

args[source]#

with_traceback(tb, /)[source]#: Set self.__traceback__ to tb and return self.

exception iris.exceptions.UnitConversionError[source]#

Bases: IrisError

Raised when Iris is unable to convert a unit.

add_note(note, /)[source]#: Add a note to the exception

args[source]#

with_traceback(tb, /)[source]#: Set self.__traceback__ to tb and return self.