cfdm.Datum.equals¶
-
Datum.
equals
(**kwargs)[source]¶ Whether two instances are the same.
Equality is strict by default. This means that:
the named parameters must be the same, with the same values and data types, and vector-valued parameters must also have same the size and be element-wise equal (see the ignore_data_type parameter).
Two real numbers
x
andy
are considered equal if|x-y|<=atol+rtol|y|
, whereatol
(the tolerance on absolute differences) andrtol
(the tolerance on relative differences) are positive, typically very small numbers. See the atol and rtol parameters.Any type of object may be tested but, in general, equality is only possible with another object of the same type, or a subclass of one. See the ignore_type parameter.
- Parameters
- other:
The object to compare for equality.
- atol: number, optional
The tolerance on absolute differences between real numbers. The default value is set by the
cfdm.atol
function.- rtol: number, optional
The tolerance on relative differences between real numbers. The default value is set by the
cfdm.rtol
function.- ignore_data_type:
bool
, optional If True then ignore the data types in all numerical comparisons. By default different numerical data types imply inequality, regardless of whether the elements are within the tolerance for equality.
- ignore_type:
bool
, optional Any type of object may be tested but, in general, equality is only possible with another
Datum
instance, or a subclass of one. If ignore_type is True thencfdm.Datum(source=other)
is tested, rather than theother
defined by the other parameter.- verbose:
int
orstr
orNone
, optional If an integer from
-1
to3
, or an equivalent string equal ignoring case to one of:'DISABLE'
(0
)'WARNING'
(1
)'INFO'
(2
)'DETAIL'
(3
)'DEBUG'
(-1
)
set for the duration of the method call only as the minimum cut-off for the verboseness level of displayed output (log) messages, regardless of the globally-configured
cfdm.log_level
. Note that increasing numerical value corresponds to increasing verbosity, with the exception of-1
as a special case of maximal and extreme verbosity.Otherwise, if
None
(the default value), output messages will be shown according to the value of thecfdm.log_level
setting.Overall, the higher a non-negative integer or equivalent string that is set (up to a maximum of
3
/'DETAIL'
) for increasing verbosity, the more description that is printed to convey information about the operation.
- Returns
bool
Whether the two instances are equal.
Examples
>>> d.equals(d) True >>> d.equals(d.copy()) True >>> d.equals(None) False