पांडा> = 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
ध्यान दें कि यह फ़ंक्शन डेटाफ्रेम (जबकि .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 सरणी द्वारा समर्थित es, Series.array
एक नया वापस आ जाएगी arrays.PandasArray, जो एक पतली (कोई-प्रतिलिपि) एक के आसपास आवरण है numpy.ndarray। arrays.PandasArrayविशेष रूप से अपने आप में उपयोगी नहीं है, लेकिन यह पंडों में या किसी तीसरे पक्ष के पुस्तकालय द्वारा परिभाषित किसी भी विस्तार सरणी के समान इंटरफ़ेस प्रदान करता है।
इसलिए, संक्षेप में, .arrayया तो वापस आ जाएगा
ExtensionArrayसूचकांक / श्रृंखला, या के मौजूदा समर्थन- यदि श्रृंखला में एक नुमाइशी सरणी होती है,
ExtensionArrayतो अंतर्निहित सरणी पर एक पतली आवरण के रूप में एक नई वस्तु बनाई जाती है।
दो नए तरीकों को जोड़ने के लिए तर्क
ये कार्य दो GitHub मुद्दों GH19954 और GH23623 के तहत चर्चा के परिणामस्वरूप जोड़े गए थे ।
विशेष रूप से, डॉक्स औचित्य का उल्लेख करते हैं:
[...] इसके साथ .valuesयह स्पष्ट नहीं था कि लौटाया गया मान वास्तविक सरणी होगा, इसका कोई परिवर्तन होगा, या पांडा कस्टम सरणियों (जैसे Categorical) में से एक होगा। उदाहरण के लिए, के साथ PeriodIndex, .values
एक नया उत्पन्न करता है ndarrayअवधि के लिए हर बार वस्तुओं। [...]
इन दोनों कार्यों का उद्देश्य एपीआई की स्थिरता में सुधार करना है, जो सही दिशा में एक बड़ा कदम है।
अंत में, .valuesवर्तमान संस्करण में पदावनत नहीं किया जाएगा, लेकिन मुझे उम्मीद है कि यह भविष्य में किसी बिंदु पर हो सकता है, इसलिए मैं उपयोगकर्ताओं से आग्रह करूंगा कि जैसे ही आप कर सकते हैं, नए एपीआई की ओर पलायन करें।