Spec-Zone.ru › pandas 0.24

pandas.DataFrame.append

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

Добавить строки other в конец вызываемого объекта, возвращая новый объект.

Столбцы в other , которые отсутствуют в вызываемом объекте, добавляются как новые столбцы.

Параметры:
other : DataFrame or Series/dict-like object, or list of these

Данные для добавления.

ignore_index : boolean, default False

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

verify_integrity : boolean, default False

Если True, при создании индекса с дубликатами генерировать ValueError.

sort : boolean, default None

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

Введено в версии 0.23.0.

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

См. также

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

Примечания

Если передается список словарей/series и ключи содержатся в индексе DataFrame, порядок столбцов в результирующем 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

Следующее, хотя и не рекомендуемые методы для генерации DataFrames, демонстрируют два способа создания 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.24.2/reference/api/pandas.DataFrame.append.html

Spec-Zone.ru

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