NumPy 1.14 - NPY_BOOL

डेटा प्रकार एपीआई




numpy

डेटा प्रकार एपीआई

मानक सरणी में 24 विभिन्न डेटा प्रकार हो सकते हैं (और अपने स्वयं के प्रकार जोड़ने के लिए कुछ समर्थन है)। इन डेटा प्रकारों में एक एन्यूमरेटेड टाइप, एक एन्यूमरेटेड टाइप-कैरेक्टर और एक संबंधित एरे स्केलर पायथन टाइप ऑब्जेक्ट (एक पदानुक्रम में रखा गया) होता है। दिए गए डेटा प्रकार के तत्वों में हेरफेर करना आसान बनाने के लिए मानक सी टाइपफ़ीड भी हैं। सांख्यिक प्रकारों के लिए, बिट-चौड़ाई समतुल्य C टाइप-सीड्स और नामित टाइपराइटर हैं जो वांछित वांछित का चयन करना आसान बनाते हैं।

चेतावनी

C कोड के प्रकारों के नाम c नामकरण सम्मेलनों का अधिक बारीकी से अनुसरण करते हैं। इन प्रकारों के लिए पायथन नाम पायथन सम्मेलनों का पालन करते हैं। इस प्रकार, NPY_FLOAT C में एक 32-बिट फ्लोट उठाता है, लेकिन पायथन में numpy.float_ 64-बिट डबल से मेल खाती है। बिट-चौड़ाई के नाम स्पष्टता के लिए पायथन और सी दोनों में उपयोग किए जा सकते हैं।

प्रगणित प्रकार

बुनियादी 24 डेटा प्रकारों और कुछ उपयोगी सामान्य नामों को प्रदान करने वाले परिभाषित प्रकारों की एक सूची है। जब भी कोड को एक प्रकार की संख्या की आवश्यकता होती है, तो इन प्रगणित प्रकारों में से एक का अनुरोध किया जाता है। सभी प्रकारों को NPY_{NAME} कहा जाता है:

NPY_BOOL

बूलियन प्रकार के लिए गणना मूल्य, एक बाइट के रूप में संग्रहीत। यह केवल 0 और 1 के मान पर सेट हो सकता है।

NPY_BYTE
NPY_INT8

8-बिट / 1-बाइट हस्ताक्षरित पूर्णांक के लिए गणना मूल्य।

NPY_SHORT
NPY_INT16

16-बिट / 2-बाइट हस्ताक्षरित पूर्णांक के लिए गणना मूल्य।

NPY_INT
NPY_INT32

32-बिट / 4-बाइट पर हस्ताक्षर किए पूर्णांक के लिए गणना मूल्य।

NPY_LONG

प्लेटफॉर्म के आधार पर या तो NPY_INT या NPY_LONGLONG के बराबर है।

NPY_LONGLONG
NPY_INT64

64-बिट / 8-बाइट पर हस्ताक्षर किए पूर्णांक के लिए गणना मूल्य।

NPY_UBYTE
NPY_UINT8

8-बिट / 1-बाइट अहस्ताक्षरित पूर्णांक के लिए गणना मूल्य।

NPY_USHORT
NPY_UINT16

16-बिट / 2-बाइट अहस्ताक्षरित पूर्णांक के लिए गणना मूल्य।

NPY_UINT
NPY_UINT32

32-बिट / 4-बाइट अहस्ताक्षरित पूर्णांक के लिए गणना मूल्य।

NPY_ULONG

प्लेटफॉर्म के आधार पर या तो NPY_UINT या NPY_ULONGLONG के बराबर है।

NPY_ULONGLONG
NPY_UINT64

64-बिट / 8-बाइट अहस्ताक्षरित पूर्णांक के लिए गणना मूल्य।

NPY_HALF
NPY_FLOAT16

16-बिट / 2-बाइट IEEE 754-2008 संगत फ्लोटिंग पॉइंट प्रकार के लिए गणना मूल्य।

NPY_FLOAT
NPY_FLOAT32

32-बिट / 4-बाइट IEEE 754 संगत फ़्लोटिंग पॉइंट प्रकार के लिए गणना मूल्य।

NPY_DOUBLE
NPY_FLOAT64

64-बिट / 8-बाइट IEEE 754 संगत फ़्लोटिंग पॉइंट प्रकार के लिए गणना मूल्य।

NPY_LONGDOUBLE

प्लेटफ़ॉर्म-विशिष्ट फ़्लोटिंग पॉइंट प्रकार के लिए गणना मूल्य जो कि कम से कम NPY_DOUBLE जितना बड़ा है, लेकिन कई प्लेटफार्मों पर बड़ा है।

NPY_CFLOAT
NPY_COMPLEX64

64-बिट / 8-बाइट जटिल प्रकार के एन्यूमरेशन मान दो NPY_FLOAT मान से बना है।

NPY_CDOUBLE
NPY_COMPLEX128

128-बिट / 16-बाइट जटिल प्रकार के लिए एन्यूमरेशन मान दो NPY_DOUBLE मूल्यों से बना है।

NPY_CLONGDOUBLE

प्लेटफ़ॉर्म-विशिष्ट जटिल फ़्लोटिंग पॉइंट प्रकार के लिए गणना मूल्य, जो दो NPY_LONGDOUBLE मानों से बना है।

NPY_DATETIME

डेटा प्रकार के लिए गणना मूल्य जो चयन तिथि या समय इकाइयों के आधार पर सटीक के साथ दिनांक या डेटासेट को रखता है।

NPY_TIMEDELTA

डेटा प्रकार के लिए गणना मूल्य जो चयन तिथि या समय इकाइयों के पूर्णांकों में कई बार होता है।

NPY_STRING

चयन योग्य आकार के ASCII तार के लिए गणना मूल्य। स्ट्रिंग्स में दिए गए एरे के भीतर एक निश्चित अधिकतम आकार होता है।

NPY_UNICODE

चयन योग्य आकार के UCS4 तार के लिए गणना मूल्य। स्ट्रिंग्स में दिए गए एरे के भीतर एक निश्चित अधिकतम आकार होता है।

NPY_OBJECT

पायथन वस्तुओं की मनमानी के संदर्भ में गणना मूल्य।

NPY_VOID

मुख्य रूप से संरचनात्मक dtypes को धारण करने के लिए उपयोग किया जाता है, लेकिन इसमें मनमाना बाइनरी डेटा हो सकता है।

उपरोक्त प्रकार के कुछ उपयोगी उपनाम हैं

NPY_INTP

एक हस्ताक्षरित पूर्णांक प्रकार के लिए गणना मूल्य जो एक (शून्य *) सूचक के समान आकार है। यह सभी प्रकार के सूचकांकों द्वारा उपयोग किया जाने वाला प्रकार है।

NPY_UINTP

एक अहस्ताक्षरित पूर्णांक प्रकार के लिए गणना मूल्य जो एक (शून्य *) सूचक के समान आकार है।

NPY_MASK

मास्क के लिए उपयोग किए जाने वाले प्रकार की गणना मूल्य, जैसे कि NPY_ITER_ARRAYMASK ध्वज। यह NPY_UINT8 बराबर है।

NPY_DEFAULT_TYPE

डिफ़ॉल्ट रूप से उपयोग करने के लिए जब कोई dtype स्पष्ट रूप से निर्दिष्ट नहीं है, उदाहरण के लिए जब np.zero (आकृति) को कॉल करना। यह NPY_DOUBLE बराबर है।

अन्य उपयोगी संबंधित स्थिरांक हैं

NPY_NTYPES

बिल्ट-इन NumPy प्रकारों की कुल संख्या। गणना में 0 से NPY_NTYPES-1 तक की सीमा शामिल है।

NPY_NOTYPE

एक संकेत मान एक मान्य प्रकार गणना संख्या नहीं होने की गारंटी देता है।

NPY_USERDEF

कस्टम डेटा प्रकारों के लिए उपयोग किए जाने वाले प्रकार संख्याओं की शुरुआत।

कुछ प्रकारों को इंगित करने वाले विभिन्न वर्ण कोड भी एन्यूमरेटेड सूची का हिस्सा हैं। अक्षर टाइप करने के लिए संदर्भ (क्या इनकी आवश्यकता होनी चाहिए) हमेशा इन गणनाओं का उपयोग करना चाहिए। इनका रूप NPY_{NAME}LTR जहाँ {NAME} हो सकता है

BOOL , BYTE , UBYTE , SHORT , USHORT , INT , UINT , LONG , ULONG , LONGLONG , ULONGLONG , HALF , FLOAT , DOUBLE , LONGDOUBLE , CFLOAT , CDOUBLE , CLONGDOUBLE , DATETIME , TIMEDELTA , OJECT , OJECT

INTP , UINTP

जेनबोल , डिज़ाइन , UNSIGNED , फ़्लोटिंग , कॉम्पलेक्स

{NAME}s का बाद वाला समूह सरणी इंटरफ़ेस टाइपस्ट्रिंग विनिर्देश में उपयोग किए गए अक्षरों से मेल खाता है।

परिभाषित करता है

पूर्णांकों के लिए अधिकतम और न्यूनतम मान

NPY_MAX_INT{bits}
NPY_MAX_UINT{bits}
NPY_MIN_INT{bits}

ये {bits} = 8, 16, 32, 64, 128 और 256 के लिए परिभाषित किए गए हैं और इसी (अहस्ताक्षरित) पूर्णांक प्रकार का अधिकतम (न्यूनतम) मान प्रदान करते हैं। नोट: वास्तविक पूर्णांक प्रकार सभी प्लेटफार्मों पर उपलब्ध नहीं हो सकता है (अर्थात 128-बिट और 256-बिट पूर्णांक दुर्लभ हैं)।

NPY_MIN_{type}

इसे {type} = BYTE , SHORT , INT , LONG , LONGLONG , INTP के लिए परिभाषित किया गया है

NPY_MAX_{type}

यह सभी {type} लिए परिभाषित है {type} = BYTE , UBYTE , SHORT , USHORT , INT , UINT , LONG , ULONG , LONGLONG , ULONGLONG , INTP , UINTP

डेटा प्रकारों में बिट्स की संख्या

सभी NPY_SIZEOF_{CTYPE} स्थिरांक में इसी NPY_BITSOF_{CTYPE} स्थिरांक को परिभाषित किया गया है। NPY_BITSOF_{CTYPE} स्थिरांक डेटा प्रकार में बिट्स की संख्या प्रदान करते हैं। विशेष रूप से, उपलब्ध {CTYPE}s हैं

BOOL , CHAR , SHORT , INT , LONG , LONGLONG , FLOAT , DOUBLE , LONGDOUBLE

बिट-चौड़ाई संदर्भों के लिए टाइप किए गए सारांश

सभी संख्यात्मक डेटा प्रकार (पूर्णांक, फ़्लोटिंग पॉइंट, और कॉम्प्लेक्स) में स्थिरांक होते हैं जिन्हें एक विशिष्ट गणना प्रकार के रूप में परिभाषित किया जाता है। वास्तव में, जो एक बिट-चौड़ाई प्रकार की गणना करता है, प्लेटफॉर्म पर निर्भर है। विशेष रूप से, उपलब्ध स्थिरांक PyArray_{NAME}{BITS} जहां {NAME} INT , UINT , FLOAT , COMPLEX और {BITS} 8, 16, 32, 64, 80, 96, 128, 160, 192, हो सकते हैं। 256, और 512. जाहिर तौर पर सभी प्रकार के संख्यात्मक प्रकारों के लिए सभी प्लेटफार्मों पर सभी बिट-चौड़ाई उपलब्ध नहीं हैं। आमतौर पर 8-, 16-, 32-, 64-बिट पूर्णांक; 32-, 64-बिट फ्लोट्स; और 64-, 128-बिट जटिल प्रकार उपलब्ध हैं।

पूर्णांक जो एक संकेतक पकड़ सकता है

कॉन्स्टेंट NPY_INTP और NPY_UINTP एक एन्यूमरेटेड पूर्णांक प्रकार को संदर्भित करते हैं जो प्लेटफ़ॉर्म पर एक पॉइंटर को पकड़ने के लिए काफी बड़ा है। सूचकांक सरणियों को हमेशा NPY_INTP में परिवर्तित किया जाना चाहिए, क्योंकि सरणी का आयाम npy_intp प्रकार का है।

सी-टाइप नाम

प्रत्येक संख्यात्मक डेटा प्रकार और बूल डेटा प्रकार के लिए मानक चर प्रकार हैं। इनमें से कुछ पहले से ही सी-स्पेसिफिकेशन में उपलब्ध हैं। आप इन प्रकारों के साथ विस्तार कोड में चर बना सकते हैं।

बूलियन

npy_bool

अचिन्हित वर्ण; स्थिरांक NPY_FALSE और NPY_TRUE भी परिभाषित किए गए हैं।

(अन) हस्ताक्षर किए गए पूर्णांक

पूर्णांकों के अनइंस्टॉल किए गए संस्करणों को पूर्णांक नाम के सामने पूर्व-लंबित 'यू' द्वारा परिभाषित किया जा सकता है।

npy_(u)byte

(अचिन्हित वर्ण

npy_(u)short

(अहस्ताक्षरित) छोटा है

npy_(u)int

(अहस्ताक्षरित) int

npy_(u)long

(अहस्ताक्षरित) लंबी int

npy_(u)longlong

(अहस्ताक्षरित लंबा लंबा int)

npy_(u)intp

(अहस्ताक्षरित) Py_intptr_t (एक पूर्णांक जो प्लेटफ़ॉर्म पर एक सूचक का आकार है)।

(कॉम्प्लेक्स) फ्लोटिंग पॉइंट

npy_(c)float

नाव

npy_(c)double

दोहरा

npy_(c)longdouble

लंबा दोहरा

जटिल प्रकार .real और .imag सदस्य (उस क्रम में) के साथ संरचनाएं हैं

बिट-चौड़ाई के नाम

हस्ताक्षरित पूर्णांक, अहस्ताक्षरित पूर्णांक, फ़्लोटिंग पॉइंट और विशिष्ट फ़्लोटिंग पॉइंट के जटिल फ़्लोटिंग पॉइंट प्रकार के लिए भी टाइप किए गए हैं। उपलब्ध प्रकार के नाम हैं

npy_int{bits} , npy_uint{bits} , npy_float{bits} , और npy_complex{bits}

जहाँ {bits} प्रकार में बिट्स की संख्या है और पूर्णांक प्रकारों के लिए 8 , 16 , 32 , 64 , 128 और 256 हो सकते हैं; फ्लोटिंग-पॉइंट प्रकारों के लिए 16, 32 , 64 , 80, 96, 128 और 256; और 32, 64 , 128 , 160, 192, और 512 जटिल-मूल्यवान प्रकारों के लिए। कौन सी बिट-चौड़ाई उपलब्ध है यह प्लेटफ़ॉर्म आश्रित है। बोल्ड किए गए बिट-चौड़ाई आमतौर पर सभी प्लेटफार्मों पर उपलब्ध हैं।

Printf स्वरूपण

मुद्रण में मदद के लिए, निम्न तार को प्रिंटफ और संबंधित आदेशों में सही प्रारूप निर्दिष्ट करने वाले के रूप में परिभाषित किया गया है।

NPY_LONGLONG_FMT , NPY_ULONGLONG_FMT , NPY_INTP_FMT , NPY_UINTP_FMT , NPY_LONGDOUBLE_FMT