pandas.DataFrame.join

DataFrame.join(other, on=None, how='left', lsuffix='', rsuffix='', sort=False) [source]

Объединение столбцов с другим DataFrame по индексу или по столбцу ключа. Эффективное объединение нескольких объектов DataFrame по индексу одновременно, передавая список.

Параметры:

other : DataFrame, Series с установленным именем поля или список DataFrame Индекс должен быть похожим на один из столбцов в этом. Если передаётся Series, его атрибут name должен быть установлен, и он будет использоваться в качестве имени столбца в результирующем объединённом DataFrame on : имя столбца, кортеж/список имён столбцов или массив-подобный объект Столбец(ы) в вызываемом объекте для объединения с индексом в other, иначе объединяет индекс с индексом. Если передаётся несколько столбцов, переданный DataFrame должен иметь MultiIndex. Можно передать массив в качестве ключа объединения, если он ещё не содержится в вызываемом DataFrame. Похоже на операцию Excel VLOOKUP how : {‘left’, ‘right’, ‘outer’, ‘inner’}, по умолчанию: ‘left’ Как обрабатывать операцию с двумя объектами. left: использовать индекс вызываемого DataFrame (или столбец, если указан on) right: использовать индекс другого DataFrame outer: сформировать объединение индекса вызываемого DataFrame (или столбца, если указан on) с индексом другого DataFrame и отсортировать его лексикографически inner: сформировать пересечение индекса вызываемого DataFrame (или столбца, если указан on) с индексом другого DataFrame, сохраняя порядок вызываемого DataFrame lsuffix : строка Суффикс для использования из перекрывающихся столбцов левого DataFrame rsuffix : строка Суффикс для использования из перекрывающихся столбцов правого DataFrame sort : булево значение, по умолчанию False Отсортировать результирующий DataFrame лексикографически по ключу объединения. Если False, порядок ключа объединения зависит от типа объединения (ключевое слово how)

Возвращает:

joined : DataFrame

См. также

DataFrame.merge

Для операций со столбцом(ами)-на-столбцом(ами)

Примечания

Параметры on, lsuffix и rsuffix не поддерживаются при передаче списка объектов DataFrame

Примеры

>>> caller = pd.DataFrame({'key': ['K0', 'K1', 'K2', 'K3', 'K4', 'K5'],
...                        'A': ['A0', 'A1', 'A2', 'A3', 'A4', 'A5']})

>>> caller
    A key
0  A0  K0
1  A1  K1
2  A2  K2
3  A3  K3
4  A4  K4
5  A5  K5

>>> other = pd.DataFrame({'key': ['K0', 'K1', 'K2'],
...                       'B': ['B0', 'B1', 'B2']})

>>> other
    B key
0  B0  K0
1  B1  K1
2  B2  K2

Объединение DataFrames по их индексам.

>>> caller.join(other, lsuffix='_caller', rsuffix='_other')

>>>     A key_caller    B key_other
    0  A0         K0   B0        K0
    1  A1         K1   B1        K1
    2  A2         K2   B2        K2
    3  A3         K3  NaN       NaN
    4  A4         K4  NaN       NaN
    5  A5         K5  NaN       NaN

Если мы хотим объединить по столбцам ключей, нам нужно установить key в качестве индекса как в вызываемом, так и в другом DataFrame. Объединённый DataFrame будет иметь key в качестве своего индекса.

>>> caller.set_index('key').join(other.set_index('key'))

>>>      A    B
    key
    K0   A0   B0
    K1   A1   B1
    K2   A2   B2
    K3   A3  NaN
    K4   A4  NaN
    K5   A5  NaN

Другой вариант объединения по столбцам ключей – использование параметра on. DataFrame.join всегда использует индекс другого DataFrame, но мы можем использовать любой столбец в вызываемом DataFrame. Этот метод сохраняет исходный индекс вызываемого DataFrame в результате.

>>> caller.join(other.set_index('key'), on='key')

>>>     A key    B
    0  A0  K0   B0
    1  A1  K1   B1
    2  A2  K2   B2
    3  A3  K3  NaN
    4  A4  K4  NaN
    5  A5  K5  NaN