Matplotlib 3.0 - axes.Axes.imshow

matplotlib.axes.Axes.imshow




matplotlib

matplotlib.axes.Axes.imshow

Axes.imshow(X, cmap=None, norm=None, aspect=None, interpolation=None, alpha=None, vmin=None, vmax=None, origin=None, extent=None, shape=None, filternorm=1, filterrad=4.0, imlim=None, resample=None, url=None, *, data=None, **kwargs) [source]

एक 2 डी नियमित रेखापुंज पर एक छवि, यानी डेटा प्रदर्शित करें।

पैरामीटर:
X : array-like or PIL image

छवि डेटा। समर्थित सरणी आकार हैं:

  • (एम, एन): स्केलर डेटा के साथ एक छवि। डेटा को एक कोलरमैप का उपयोग करके कल्पना की जाती है।
  • (एम, एन, 3): आरजीबी मूल्यों (फ्लोट या uint8) के साथ एक छवि।
  • (एम, एन, 4): RGBA मान (फ्लोट या uint8) के साथ एक छवि, अर्थात पारदर्शिता भी शामिल है।

पहले दो आयाम (M, N) छवि की पंक्तियों और स्तंभों को परिभाषित करते हैं।

आरजीबी (ए) मान फ़्लोटर्स के लिए [0 .. 1] श्रेणी में या पूर्णांक के लिए [0 .. 255] होना चाहिए। आउट-ऑफ-रेंज मानों को इन सीमाओं से जोड़ दिया जाएगा।

cmap : str or Colormap, optional

एक Colormap उदाहरण या पंजीकृत Colormap नाम। Colormap स्केलर डेटा को रंगों में मैप करता है। इसे RGB (A) डेटा के लिए अनदेखा किया जाता है। rcParams["image.cmap"] लिए डिफ़ॉल्ट।

aspect : {'equal', 'auto'} or float, optional

कुल्हाड़ियों के पहलू अनुपात को नियंत्रित करता है। पहलू छवियों के लिए विशेष रूप से प्रासंगिक है क्योंकि यह छवि को विकृत कर सकता है, अर्थात पिक्सेल चौकोर नहीं होगा।

यह पैरामीटर स्पष्ट रूप से Axes.set_aspect कॉल करने के लिए एक शॉर्टकट है। अधिक जानकारी के लिए वहाँ देखें।

  • 'बराबर': 1. का एक आस्पेक्ट रेश्यो सुनिश्चित करता है। पिक्सेल चौकोर होगा (जब तक कि पिक्सेल आकार स्पष्ट रूप से गैर-वर्ग में डेटा निर्देशांक में हद तक उपयोग न किया जाए)।
  • 'ऑटो': अक्षों को स्थिर रखा जाता है और पहलू को समायोजित किया जाता है ताकि डेटा अक्षों में फिट हो। सामान्य तौर पर, इसका परिणाम गैर-वर्ग पिक्सेल होगा।

यदि नहीं दिया गया है, तो rcParams["image.cmap"] (डिफ़ॉल्ट: 'बराबर') का उपयोग करें।

interpolation : str, optional

प्रक्षेप विधि का इस्तेमाल किया। यदि कोई भी rcParams["image.cmap"] का उपयोग किया जाता है, जो 'निकटतम' के लिए चूक करता है।

समर्थित मूल्य 'कोई नहीं', 'निकटतम', 'बिलिनियर', 'बाइसिक्योर', 'स्पलाइन 16', 'स्पलाइन 36', 'हैंगिंग', 'हैमिंग', 'हर्माइट', 'कैसर,' क्वाड्रिक ',' कैट्रोम 'हैं। , 'गाऊसी', 'बेसेल', 'मिचेल', 'सिनस', 'लैंजोस'।

यदि प्रक्षेप inter कोई नहीं ’है, तो एग, पीएस और पीडीएफ बैकेंड पर कोई प्रक्षेप नहीं किया जाता है। अन्य बैकएंड 'निकटतम' पर वापस आ जाएंगे।

समर्थित प्रक्षेप तरीकों के अवलोकन के लिए imshow / matshow के लिए प्रक्षेप देखें।

कुछ प्रक्षेप तरीकों को एक अतिरिक्त त्रिज्या पैरामीटर की आवश्यकता होती है, जिसे फ़िल्टरर द्वारा निर्धारित किया जा सकता है। इसके अतिरिक्त, एंटीग्रेन इमेज रिसाइज फिल्टर को पैरामीटर फिल्टर्नॉर्म द्वारा नियंत्रित किया जाता है

norm : Normalize, optional

यदि अदिश डेटा का उपयोग किया जाता है, तो नॉर्मलाइज़ उदाहरण रंगों को मैप करने के लिए कैनोनिकल कॉलोर्मैप रेंज [0,1] पर डेटा मानों को मापता है। डिफ़ॉल्ट रूप से, डेटा श्रेणी को रेखीय स्केलिंग का उपयोग करके रंगीन पट्टी रेंज में मैप किया जाता है। आरजीबी (ए) डेटा के लिए इस पैरामीटर की अनदेखी की जाती है।

vmin, vmax : scalar, optional

स्केलर डेटा और कोई स्पष्ट मानदंड का उपयोग करते समय, vmin और vmax उस डेटा श्रेणी को परिभाषित करते हैं जो कॉलर्मैप कवर करता है। डिफ़ॉल्ट रूप से, colormap आपूर्ति किए गए डेटा की पूरी मान सीमा को कवर करता है। यदि मानक पैरामीटर का उपयोग किया जाता है, तो vmin , vmax की अनदेखी की जाती है।

alpha : scalar, optional

अल्फा सम्मिश्रण मान, 0 (पारदर्शी) और 1 (अपारदर्शी) के बीच। RGBA इनपुट डेटा के लिए इस पैरामीटर की अनदेखी की जाती है।

origin : {'upper', 'lower'}, optional

अक्षों के ऊपरी बाएँ या निचले बाएँ कोने में [0,0] का सूचकांक रखें। कन्वेंशन 'अपर' का इस्तेमाल आमतौर पर मैट्रिस और इमेज के लिए किया जाता है। यदि नहीं दिया गया है, तो rcParams["image.cmap"] का उपयोग किया जाता है, जो 'ऊपरी' के लिए डिफ़ॉल्ट है।

ध्यान दें कि ऊर्ध्वाधर कुल्हाड़ी 'कम' के लिए ऊपर की ओर इंगित करती है लेकिन 'ऊपरी' के लिए नीचे की ओर।

extent : scalars (left, right, bottom, top), optional

डेटा में बाउंडिंग बॉक्स समन्वय करता है कि छवि भर जाएगी। बॉक्स भरने के लिए छवि को व्यक्तिगत रूप से x और y के साथ बढ़ाया जाता है।

डिफ़ॉल्ट सीमा निम्नलिखित शर्तों द्वारा निर्धारित की जाती है। पिक्सेल का डेटा निर्देशांक में इकाई आकार होता है। उनके केंद्र पूर्णांक निर्देशांक पर हैं, और उनके केंद्र निर्देशांक 0 से कॉलम -1 तक क्षैतिज और 0 से पंक्तियों -1 तक लंबवत हैं।

ध्यान दें कि ऊर्ध्वाधर अक्ष की दिशा और इस प्रकार ऊपर और नीचे के लिए डिफ़ॉल्ट मान उत्पत्ति पर निर्भर करते हैं :

  • origin == 'upper' डिफ़ॉल्ट है (-0.5, numcols-0.5, numrows-0.5, -0.5)
  • origin == 'lower' डिफ़ॉल्ट है (-0.5, numcols-0.5, -0.5, numrows-0.5)

अधिक विस्तृत विवरण के लिए उदाहरण और imshow में सीमा देखें।

shape : scalars (columns, rows), optional, default: None

कच्चे बफर छवियों के लिए।

filternorm : bool, optional, default: True

एंटीग्रेन छवि के लिए एक पैरामीटर फ़िल्टर आकार (एंटीग्रेन प्रलेखन देखें)। यदि फिल्टर्नॉर्म सेट किया जाता है, तो फ़िल्टर पूर्णांक मानों को सामान्य करता है और गोलाई त्रुटियों को ठीक करता है। यह स्रोत फ़्लोटिंग पॉइंट मानों के साथ कुछ भी नहीं करता है, यह 1.0 के नियम के अनुसार केवल पूर्णांकों को सही करता है जिसका अर्थ है कि पिक्सेल भार का कोई योग 1.0 के बराबर होना चाहिए। तो, फिल्टर फ़ंक्शन को उचित आकार का एक ग्राफ बनाना होगा।

filterrad : float > 0, optional, default: 4.0

फिल्टर के लिए फिल्टर त्रिज्या जिसमें त्रिज्या पैरामीटर होता है, अर्थात जब प्रक्षेप में से एक होता है: 'sinc', 'lanczos' या 'blackman'।

resample : bool, optional

जब सत्य है , तो एक पूर्ण पुनरुत्पादन विधि का उपयोग करें। जब गलत है , केवल तब पुन: उत्पन्न होता है जब आउटपुट छवि इनपुट छवि से बड़ी होती है।

url : str, optional

निर्मित AxesImage का url सेट करें। Artist.set_url देखें Artist.set_url

यह दिखाता है:
image : AxesImage
अन्य पैरामीटर:
**kwargs : Artist properties

ये पैरामीटर AxesImage आर्टिस्ट के कंस्ट्रक्टर को दिए AxesImage हैं।

यह भी देखें

matshow
एक छवि के रूप में एक मैट्रिक्स या एक सरणी प्लॉट करें।

टिप्पणियाँ

जब तक सीमा का उपयोग नहीं किया जाता है, पिक्सेल केंद्र पूर्णांक निर्देशांक पर स्थित होंगे। दूसरे शब्दों में: मूल पिक्सेल के केंद्र (0, 0) के साथ मेल खाएगा।

एक अल्फा चैनल के साथ RGB छवियों के लिए दो सामान्य अभ्यावेदन हैं:

  • स्ट्रेट (बिना पढ़े) अल्फा: आर, जी और बी चैनल पिक्सेल के रंग का प्रतिनिधित्व करते हैं, इसकी अपारदर्शिता को नापसंद करते हैं।
  • Premultiplied (संबद्ध) अल्फा: R, G, और B चैनल पिक्सेल के रंग का प्रतिनिधित्व करते हैं, गुणन द्वारा इसकी अस्पष्टता के लिए समायोजित किया जाता है।

imshow उम्मीद है कि आरजीबी इमेज स्ट्रेट (अनसोसेस्ड) अल्फा प्रतिनिधित्व को अपनाएंगे।

ध्यान दें

ऊपर वर्णित तर्कों के अलावा, यह फ़ंक्शन डेटा कीवर्ड तर्क ले सकता है। यदि ऐसा कोई डेटा तर्क दिया जाता है, तो निम्न तर्क डेटा द्वारा प्रतिस्थापित किए जाते हैं [<arg>] :

  • सभी स्थिति और सभी खोजशब्द तर्क।

डेटा के रूप में पारित वस्तुओं को आइटम एक्सेस ( data[<arg>] ) और सदस्यता परीक्षण ( <arg> in data ) का समर्थन करना चाहिए।

matplotlib.axes.Axes.imshow का उपयोग कर उदाहरण