Spec-Zone.ru › pandas 0.23

pandas.DataFrame.append

DataFrame.append(other, ignore_index=False, verify_integrity=False, sort=None) [source]

Присоединить строки other к концу этой таблицы, вернув новый объект. Столбцы, отсутствующие в этой таблице, добавляются как новые столбцы.

Параметры:

other : DataFrame или Series/dict-подобный объект, или список таких объектов

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

ignore_index : boolean, по умолчанию False

Если True, не использовать метки индекса.

verify_integrity : boolean, по умолчанию False

Если True, при создании индекса с дубликатами поднимется исключение ValueError.

sort : boolean, по умолчанию None

Сортировать столбцы, если столбцы self и other не выровнены. По умолчанию сортировка устарела и в будущей версии pandas будет изменена на отсутствие сортировки. Явно передайте sort=True чтобы заглушить предупреждение и выполнить сортировку. Явно передайте sort=False чтобы заглушить предупреждение и не сортировать.

Новое в версии 0.23.0.

Возвращает:
appended : DataFrame

См. также

pandas.concat
Общая функция для конкатенации объектов DataFrame, Series или Panel

Примечания

Если передается список словарей/series, и ключи содержатся в индексе DataFrame, порядок столбцов в результирующей таблице не изменится.

Итеративное присоединение строк к DataFrame может быть более вычислительно интенсивным, чем одиночная конкатенация. Лучшим решением является присоединение этих строк к списку, а затем конкатенация списка с исходным DataFrame сразу.

Примеры

>>> df = pd.DataFrame([[1, 2], [3, 4]], columns=list('AB'))
>>> df
   A  B
0  1  2
1  3  4
>>> df2 = pd.DataFrame([[5, 6], [7, 8]], columns=list('AB'))
>>> df.append(df2)
   A  B
0  1  2
1  3  4
0  5  6
1  7  8

С ignore_index установленным в True:

>>> df.append(df2, ignore_index=True)
   A  B
0  1  2
1  3  4
2  5  6
3  7  8

Следующие примеры, хотя и не рекомендуемые методы для создания DataFrame, показывают два способа создания DataFrame из нескольких источников данных.

Менее эффективный:

>>> df = pd.DataFrame(columns=['A'])
>>> for i in range(5):
...     df = df.append({'A': i}, ignore_index=True)
>>> df
   A
0  0
1  1
2  2
3  3
4  4

Более эффективный:

>>> pd.concat([pd.DataFrame([i], columns=['A']) for i in range(5)],
...           ignore_index=True)
   A
0  0
1  1
2  2
3  3
4  4

© 2008–2012, AQR Capital Management, LLC, Lambda Foundry, Inc. and PyData Development Team
Licensed under the 3-clause BSD License.
https://pandas.pydata.org/pandas-docs/version/0.23.4/generated/pandas.DataFrame.append.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API