панди> = 0,24
Знищити своє використання .valuesна користь цих методів!
З v0.24.0 року, ми будемо мати два бренди Порка нові, кращі способи отримання Numpy масивів з Index, Seriesі DataFrameоб'єкти: вони to_numpy(), і .array. Щодо використання, документи згадують:
Ми не видалили або застарілі Series.valuesабо
DataFrame.values, але ми настійно рекомендуємо і використовувати .arrayабо
.to_numpy()замість цього.
Додаткову інформацію див. У цьому розділі приміток до випуску v0.24.0 .
to_numpy() Метод
df.index.to_numpy()
# array(['a', 'b'], dtype=object)
df['A'].to_numpy()
# array([1, 4])
За замовчуванням подання повертається. Будь-які внесені зміни вплинуть на оригінал.
v = df.index.to_numpy()
v[0] = -1
df
A B
-1 1 2
b 4 5
Якщо вам потрібна копія, використовуйте to_numpy(copy=True);
v = df.index.to_numpy(copy=True)
v[-1] = -123
df
A B
a 1 2
b 4 5
Зауважте, що ця функція також працює для DataFrames (поки її .arrayнемає).
arrayАтрибут
Цей атрибут повертаєExtensionArrayоб'єкт, який підтримує індекс / серію.
pd.__version__
# '0.24.0rc1'
# Setup.
df = pd.DataFrame([[1, 2], [4, 5]], columns=['A', 'B'], index=['a', 'b'])
df
A B
a 1 2
b 4 5
df.index.array
# <PandasArray>
# ['a', 'b']
# Length: 2, dtype: object
df['A'].array
# <PandasArray>
# [1, 4]
# Length: 2, dtype: int64
Звідси можна отримати список, використовуючи list:
list(df.index.array)
# ['a', 'b']
list(df['A'].array)
# [1, 4]
або просто безпосередньо зателефонуйте .tolist():
df.index.tolist()
# ['a', 'b']
df['A'].tolist()
# [1, 4]
Щодо повернутого документа, документи згадують,
Для Seriesі, Indexпідкріплені звичайними масивами NumPy, Series.array
повернеться новий arrays.PandasArray, який представляє собою тонку (без копії) обгортку навколо numpy.ndarray. arrays.PandasArrayне є особливо корисним самостійно, але він забезпечує той же інтерфейс, що і будь-який масив розширень, визначений в пандах або сторонніми бібліотеками.
Отже, підсумовуючи, .arrayповернемося будь-яке
- Існуюча
ExtensionArrayрезервна копія індексу / серії, або
- Якщо є масив NumPy, що підтримує серію, новий
ExtensionArrayоб’єкт створюється у вигляді тонкої обгортки над базовим масивом.
Обґрунтування додавання ДВА нових методів
Ці функції були додані в результаті обговорень під двома проблемами GitHub GH19954 та GH23623 .
Конкретно в документах згадується обгрунтування:
[...] з .valuesним було незрозуміло, чи буде повернене значення фактичним масивом, деяким перетворенням його чи одним із користувацьких масивів панди (як Categorical). Наприклад, з PeriodIndex, кожного разу .values
створює нові ndarrayоб'єкти періоду. [...]
Ці дві функції спрямовані на поліпшення узгодженості API, що є головним кроком у правильному напрямку.
Нарешті, .valuesне буде застарілим у поточній версії, але я думаю, що це може статися в якийсь момент у майбутньому, тому я б закликав користувачів перейти до новішого API, як тільки можна.