cf.FieldList.equals¶
-
FieldList.
equals
(other, rtol=None, atol=None, ignore_fill_value=False, traceback=False, ignore=('Conventions', ), _set=False)[source]¶ True if two field lists are equal, False otherwise.
Two field lists are equal if they have the same number of elements and the field elements are equal pairwise, i.e.
f.equals(g)
is equivalent toall(x.equals(y) for x, y in map(None, f, g))
.Two fields are equal if ...
Note that a single element field list may be equal to field, for example
f[0:1].equals(f[0])
andf[0].equals(f[0:1])
are always True.See also
Examples 1: >>> b = f.equals(g)
Parameters: - other : object
The object to compare for equality.
- atol : float, optional
The absolute tolerance for all numerical comparisons, By default the value returned by the
cf.ATOL
function is used.- rtol : float, optional
The relative tolerance for all numerical comparisons, By default the value returned by the
cf.RTOL
function is used.- ignore_fill_value : bool, optional
If True then data arrays with different fill values are considered equal. By default they are considered unequal.
- traceback : bool, optional
If True then print a traceback highlighting where the two field lists differ.
- ignore : tuple, optional
The names of CF properties to omit from the comparison. By default, the CF Conventions property is omitted.
Returns: - out : bool
Whether or not the two field lists are equal.
Examples 2: >>> f.Conventions 'CF-1.0' >>> g = f.copy() >>> g.Conventions = 'CF-1.5' >>> f.equals(g) True
In the following example, two fields differ only by the long name of their time coordinates. The traceback shows that they differ in their domains, that they differ in their time coordinates and that the long name could not be matched.
>>> g = f.copy() >>> g.coord('time').long_name += ' different' >>> f.equals(g, traceback=True) Domain: Different coordinate: <CF Coordinate: time(12)> Field: Different domain properties: <CF Domain: (128, 1, 12, 64)>, <CF Domain: (128, 1, 12, 64)> False