pandas.testing.assert_series_equal

pandas.testing.assert_series_equal(left, right, check_dtype=True, check_index_type='equiv', check_series_type=True, check_less_precise=_NoDefault.no_default, check_names=True, check_exact=False, check_datetimelike_compat=False, check_categorical=True, check_category_order=True, check_freq=True, check_flags=True, rtol=1e-05, atol=1e-08, obj='Series', *, check_index=True, check_like=False)[source]

Check that left and right Series are equal.

Parameters
leftSeries
rightSeries
check_dtypebool, default True

Whether to check the Series dtype is identical.

check_index_typebool or {‘equiv’}, default ‘equiv’

Whether to check the Index class, dtype and inferred_type are identical.

check_series_typebool, default True

Whether to check the Series class is identical.

check_less_precisebool or int, default False

Specify comparison precision. Only used when check_exact is False. 5 digits (False) or 3 digits (True) after decimal points are compared. If int, then specify the digits to compare.

When comparing two numbers, if the first number has magnitude less than 1e-5, we compare the two numbers directly and check whether they are equivalent within the specified precision. Otherwise, we compare the ratio of the second number to the first number and check whether it is equivalent to 1 within the specified precision.

Deprecated since version 1.1.0: Use rtol and atol instead to define relative/absolute tolerance, respectively. Similar to math.isclose().

check_namesbool, default True

Whether to check the Series and Index names attribute.

check_exactbool, default False

Whether to compare number exactly.

check_datetimelike_compatbool, default False

Compare datetime-like which is comparable ignoring dtype.

check_categoricalbool, default True

Whether to compare internal Categorical exactly.

check_category_orderbool, default True

Whether to compare category order of internal Categoricals.

New in version 1.0.2.

check_freqbool, default True

Whether to check the freq attribute on a DatetimeIndex or TimedeltaIndex.

New in version 1.1.0.

check_flagsbool, default True

Whether to check the flags attribute.

New in version 1.2.0.

rtolfloat, default 1e-5

Relative tolerance. Only used when check_exact is False.

New in version 1.1.0.

atolfloat, default 1e-8

Absolute tolerance. Only used when check_exact is False.

New in version 1.1.0.

objstr, default ‘Series’

Specify object name being compared, internally used to show appropriate assertion message.

check_indexbool, default True

Whether to check index equivalence. If False, then compare only values.

New in version 1.3.0.

check_likebool, default False

If True, ignore the order of the index. Must be False if check_index is False. Note: same labels must be with the same data.

New in version 1.5.0.

Examples

>>> from pandas import testing as tm
>>> a = pd.Series([1, 2, 3, 4])
>>> b = pd.Series([1, 2, 3, 4])
>>> tm.assert_series_equal(a, b)