pandas.DataFrame.compare

DataFrame.compare(other, align_axis=1, keep_shape=False, keep_equal=False, result_names=('self', 'other'))[source]

Сравнение с другой DataFrame и отображение различий.

Новая в версии 1.1.0.

Параметры

other:DataFrame

Объект для сравнения.

align_axis:{0 или ‘индекс’, 1 или ‘колонки’}, по умолчанию 1

Определение оси для выравнивания сравнения.

• 0, или ‘индекс’:Полученные различия выстроены вертикально

  строки чередуются из self и other.

• 1, или ‘колонки’:Полученные различия выстроены горизонтально

  столбцы чередуются из self и other.

keep_shape:bool, по умолчанию False

Если True, сохраняются все строки и столбцы. В противном случае сохраняются только те, у которых значения отличаются.

keep_equal:bool, по умолчанию False

Если True, результат сохраняет значения, которые равны. В противном случае равные значения отображаются как NaNs.

result_names:кортеж, по умолчанию (‘self’, ‘other’)

Установите имена dataframes в сравнении.

Новая в версии 1.5.0.

Возвращает

DataFrame

DataFrame, показывающий различия, выстроены бок о бок.

Результирующий индекс будет MultiIndex с ‘self’ и ‘other’, чередующимися на внутреннем уровне.

Возбуждает

ValueError

Когда у двух DataFrame отсутствуют идентичные метки или форма.

См. также

Series.compare

Сравнение с другим Series и отображение различий.

DataFrame.equals

Проверка, содержат ли два объекта одинаковые элементы.

Примечания

Совпадающие NaNs не будут отображаться как различия.

Можно сравнить только DataFrame с одинаковыми метками (т.е. одинаковой формой, идентичными метками строк и столбцов).

Примеры

>>> df = pd.DataFrame(
...     {
...         "col1": ["a", "a", "b", "b", "a"],
...         "col2": [1.0, 2.0, 3.0, np.nan, 5.0],
...         "col3": [1.0, 2.0, 3.0, 4.0, 5.0]
...     },
...     columns=["col1", "col2", "col3"],
... )
>>> df
  col1  col2  col3
0    a   1.0   1.0
1    a   2.0   2.0
2    b   3.0   3.0
3    b   NaN   4.0
4    a   5.0   5.0

>>> df2 = df.copy()
>>> df2.loc[0, 'col1'] = 'c'
>>> df2.loc[2, 'col3'] = 4.0
>>> df2
  col1  col2  col3
0    c   1.0   1.0
1    a   2.0   2.0
2    b   3.0   4.0
3    b   NaN   4.0
4    a   5.0   5.0

Выравнивание различий по столбцам

>>> df.compare(df2)
  col1       col3
  self other self other
0    a     c  NaN   NaN
2  NaN   NaN  3.0   4.0

Назначение result_names

>>> df.compare(df2, result_names=("left", "right"))
  col1       col3
  left right left right
0    a     c  NaN   NaN
2  NaN   NaN  3.0   4.0

Выстраивание различий по строкам

>>> df.compare(df2, align_axis=0)
        col1  col3
0 self     a   NaN
  other    c   NaN
2 self   NaN   3.0
  other  NaN   4.0

Сохранение равных значений

>>> df.compare(df2, keep_equal=True)
  col1       col3
  self other self other
0    a     c  1.0   1.0
2    b     b  3.0   4.0

Сохранение всех исходных строк и столбцов

>>> df.compare(df2, keep_shape=True)
  col1       col2       col3
  self other self other self other
0    a     c  NaN   NaN  NaN   NaN
1  NaN   NaN  NaN   NaN  NaN   NaN
2  NaN   NaN  NaN   NaN  3.0   4.0
3  NaN   NaN  NaN   NaN  NaN   NaN
4  NaN   NaN  NaN   NaN  NaN   NaN

Сохранение всех исходных строк и столбцов, а также всех исходных значений

>>> df.compare(df2, keep_shape=True, keep_equal=True)
  col1       col2       col3
  self other self other self other
0    a     c  1.0   1.0  1.0   1.0
1    a     a  2.0   2.0  2.0   2.0
2    b     b  3.0   3.0  3.0   4.0
3    b     b  NaN   NaN  4.0   4.0
4    a     a  5.0   5.0  5.0   5.0