pandalar> = 0.24
Kullanımınızı .valuesbu yöntemler lehine kaldırın !
İtibaren v0.24.0, biz iki markanın şaplak yeni, tercih dan NumPy diziler elde etme yöntemlerini olacak Index, Seriesve DataFramenesneleri: olduklarını to_numpy()ve .array. Kullanımla ilgili olarak dokümanlar şunları belirtiyor:
Biz kaldırılamaz veya kullanım dışı değil Series.valuesya
DataFrame.values, ama biz çok tavsiye ve kullanma .arrayya da
.to_numpy()onun yerine.
Daha fazla bilgi için v0.24.0 sürüm notlarının bu bölümüne bakın .
to_numpy() Yöntem
df.index.to_numpy()
# array(['a', 'b'], dtype=object)
df['A'].to_numpy()
# array([1, 4])
Varsayılan olarak bir görünüm döndürülür. Yapılan değişiklikler orijinal belgeyi etkiler.
v = df.index.to_numpy()
v[0] = -1
df
A B
-1 1 2
b 4 5
Bunun yerine bir kopyasına ihtiyacınız varsa to_numpy(copy=True) kullanın ;
v = df.index.to_numpy(copy=True)
v[-1] = -123
df
A B
a 1 2
b 4 5
Bu işlevin DataFrames için de çalıştığını unutmayın (ancak .arrayçalışmaz).
arrayÖznitelik
Bu öznitelikExtensionArray, Dizin / Serileri destekleyenbirnesnedöndürür.
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
Buradan aşağıdakileri kullanarak bir liste almak mümkündür list:
list(df.index.array)
# ['a', 'b']
list(df['A'].array)
# [1, 4]
veya doğrudan arayın .tolist():
df.index.tolist()
# ['a', 'b']
df['A'].tolist()
# [1, 4]
Neler iade edildiğine dair dokümanlar,
İçin Seriesve Indexnormal bir NumPy diziler tarafından desteklenen es, Series.array
yeni dönecektir arrays.PandasArraybir etrafında ince (no-kopya) sarıcı olan numpy.ndarray. arrays.PandasArrayözellikle kendi başına yararlı değildir, ancak pandalarda veya üçüncü taraf bir kütüphane tarafından tanımlanan herhangi bir uzantı dizisiyle aynı arabirimi sağlar.
Özetlemek gerekirse, .arrayya dönecektir
ExtensionArrayEndeksin / Dizinin mevcut desteğini veya- Diziyi destekleyen bir NumPy dizisi varsa
ExtensionArray, temel dizi üzerinde ince bir paket olarak yeni bir nesne oluşturulur.
İKİ yeni yöntem eklemek için gerekçe
Bu işlevler, iki GitHub sorunu GH19954 ve GH23623 altında yapılan tartışmalar sonucunda eklenmiştir .
Özellikle, dokümanlar gerekçeden bahseder:
[...] .valuesdöndürülen değerin gerçek dizi mi, bir miktar dönüşümü mü yoksa pandalar özel dizilerinden biri mi olacağı belli değildi Categorical. Örneğin, ile PeriodIndex, .values
yeni bir oluşturur ndarraysüresinin her zaman nesneleri. [...]
Bu iki işlev, doğru yönde atılmış önemli bir adım olan API'nın tutarlılığını artırmayı amaçlamaktadır.
Son olarak, .valuesmevcut sürümde kullanımdan kaldırılmayacak, ancak bunun gelecekte bir noktada gerçekleşmesini bekliyorum, bu yüzden kullanıcıları mümkün olan en kısa sürede yeni API'ya geçiş yapmaya teşvik ediyorum.