pandy> = 0,24
Przestań używać swojego sposobu .valuesna rzecz tych metod!
Od v0.24.0 roku, będziemy mieli dwa zupełnie nowe, klapsy preferowane sposoby otrzymywania tablic numpy z Index, Seriesoraz DataFrameobiektów: są to_numpy()i .array. Jeśli chodzi o użycie, dokumenty wspominają:
Nie zostały usunięte lub przestarzałe Series.valueslub
DataFrame.values, ale zalecamy i za pomocą .arraylub
.to_numpy()zamiast.
Więcej informacji można znaleźć w tej sekcji informacji o wersji v0.24.0 .
to_numpy() metoda
df.index.to_numpy()
# array(['a', 'b'], dtype=object)
df['A'].to_numpy()
# array([1, 4])
Domyślnie widok jest zwracany. Wszelkie dokonane modyfikacje wpłyną na oryginał.
v = df.index.to_numpy()
v[0] = -1
df
A B
-1 1 2
b 4 5
Jeśli zamiast tego potrzebujesz kopii, użyj to_numpy(copy=True);
v = df.index.to_numpy(copy=True)
v[-1] = -123
df
A B
a 1 2
b 4 5
Pamiętaj, że ta funkcja działa również w przypadku DataFrames (chociaż .arraynie działa).
arrayAtrybut
Ten atrybut zwracaExtensionArrayobiekt, który wspiera indeks / serię.
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
Stąd można uzyskać listę za pomocą list:
list(df.index.array)
# ['a', 'b']
list(df['A'].array)
# [1, 4]
lub po prostu zadzwoń bezpośrednio .tolist():
df.index.tolist()
# ['a', 'b']
df['A'].tolist()
# [1, 4]
Dokumenty wspominają o tym, co jest zwracane,
Dla Seriesi Indexes wspierane przez normalne tablice NumPy, Series.array
zwróci nowe arrays.PandasArray, cienkie (bez kopii) opakowanie wokół numpy.ndarray. arrays.PandasArraysam w sobie nie jest szczególnie użyteczny, ale zapewnia taki sam interfejs, jak każda tablica rozszerzeń zdefiniowana w pandach lub przez bibliotekę innej firmy.
Podsumowując, .arraywróci albo
- Istniejący
ExtensionArraypodkład indeksu / serii, lub
- Jeśli istnieje szereg NumPy wspierający serię, nowy
ExtensionArrayobiekt jest tworzony jako cienkie opakowanie nad podstawową tablicą.
Uzasadnienie dodania DWÓCH nowych metod
Funkcje te zostały dodane w wyniku dyskusji w ramach dwóch zagadnień GitHub GH19954 i GH23623 .
W szczególności dokumenty wspominają o uzasadnieniu:
[...] .valuesnie było jasne, czy zwrócona wartość będzie rzeczywistą tablicą, jakąś jej transformacją, czy jedną z niestandardowych tablic pand (jak Categorical). Na przykład, z PeriodIndex, .values
generuje nowy ndarrayokresu obiektów za każdym razem. [...]
Te dwie funkcje mają na celu poprawę spójności interfejsu API, co jest ważnym krokiem we właściwym kierunku.
Wreszcie, .valuesnie będzie przestarzała w obecnej wersji, ale spodziewam się, że może się to zdarzyć w pewnym momencie w przyszłości, więc zachęcam użytkowników do migracji w kierunku nowszego interfejsu API, tak szybko, jak to możliwe.