Matplotlib 3.0 - axes.Axes.pcolormesh

matplotlib.axes.Axes.pcolormesh




matplotlib

matplotlib.axes.Axes.pcolormesh

Axes.pcolormesh(*args, alpha=None, norm=None, cmap=None, vmin=None, vmax=None, shading='flat', antialiased=False, data=None, **kwargs) [source]

एक गैर-नियमित आयताकार ग्रिड के साथ एक छद्म चॉकलेट निर्माता भूखंड बनाएं।

कॉल हस्ताक्षर:

pcolor([X, Y,] C, **kwargs)

एक्स और वाई का उपयोग चतुर्भुज के कोनों को निर्दिष्ट करने के लिए किया जा सकता है।

ध्यान दें

pcolormesh() के समान है। यह ज्यादातर मामलों में बहुत तेज और पसंदीदा है। मतभेदों पर विस्तृत चर्चा के लिए पीसीरोल () और पीसीओलर्मेश () के बीच अंतर देखें।

पैरामीटर:
C : array_like

एक स्केलर 2-डी सरणी। मान रंग-मैप किए जाएंगे।

X, Y : array_like, optional

चतुर्भुज कोनों के निर्देशांक। C[i,j] लिए चतुर्भुज में कोनों हैं:

(X[i+1, j], Y[i+1, j])          (X[i+1, j+1], Y[i+1, j+1])
                      +--------+
                      | C[i,j] |
                      +--------+
    (X[i, j], Y[i, j])          (X[i, j+1], Y[i, j+1]),

ध्यान दें कि स्तंभ अनुक्रमणिका x-निर्देशांक से मेल खाती है, और पंक्ति अनुक्रमणिका y से मेल खाती है। विवरण के लिए, नीचे दिए गए Notes अनुभाग देखें।

X और Y का आयाम C की तुलना में एक अधिक होना चाहिए। वैकल्पिक रूप से, X , Y और C में समान आयाम हो सकते हैं, इस स्थिति में C की अंतिम पंक्ति और स्तंभ को अनदेखा किया जाएगा।

यदि X और / या Y 1-D सरणियाँ या स्तंभ वैक्टर हैं, तो उन्हें उपयुक्त 2-D सरणियों में आवश्यकतानुसार विस्तारित किया जाएगा, जिससे एक आयताकार ग्रिड बन जाएगा।

cmap : str or Colormap, optional

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

norm : Normalize, optional

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

vmin, vmax : scalar, optional, default: None

रंग रेंज। यदि कोई नहीं है , तो उपयुक्त न्यूनतम / अधिकतम मान स्वचालित रूप से Normalize उदाहरण (डिफ़ॉल्ट रैखिक स्केलिंग के मामले में सी के संबंधित न्यूनतम / अधिकतम मूल्यों के लिए चूक) द्वारा चुना जाता है।

edgecolors : {'none', None, 'face', color, color sequence}, optional

किनारों का रंग। 'कोई नहीं' के लिए चूक। संभावित मान:

  • 'कोई नहीं' या '': कोई किनारा नहीं।
  • कोई नहीं : rcParams["image.cmap"] का उपयोग किया जाएगा। ध्यान दें कि वर्तमान में rcParams["image.cmap"] को कार्य करने के लिए यह सही होना चाहिए।
  • 'फेस': आसन्न चेहरे के रंग का उपयोग करें।
  • एक mpl रंग या रंगों का अनुक्रम किनारे का रंग निर्धारित करेगा।

एकवचन रूप edgecolor एक उपनाम के रूप में काम करता है।

alpha : scalar, optional, default: None

अल्फा सम्मिश्रण मान, 0 (पारदर्शी) और 1 (अपारदर्शी) के बीच।

shading : {'flat', 'gouraud'}, optional

भरण शैली, संभव मान:

  • 'फ्लैट': प्रत्येक क्वाड के लिए एक ठोस रंग का उपयोग किया जाता है। क्वाड (i, j), (i + 1, j), (i, j + 1), (i + 1, j + 1) का रंग C[i,j] द्वारा दिया गया C[i,j]
  • 'गौर्ड ’: प्रत्येक क्वाड गौर्ड शेड होगा: कोनों का रंग (i’, j ’) C[i',j'] द्वारा दिया जाता C[i',j'] । बीच के क्षेत्र के रंग मूल्यों को कोने के मूल्यों से प्रक्षेपित किया जाता है। जब Gouraud छायांकन का उपयोग किया जाता है, तो edgecolors को अनदेखा किया जाता है।
snap : bool, optional, default: False

चाहे पिक्सेल की सीमाओं के लिए जाल को स्नैप करें।

यह दिखाता है:
mesh : matplotlib.collections.QuadMesh
अन्य पैरामीटर:
** kwargs

इसके अतिरिक्त, निम्न तर्कों की अनुमति है। वे QuadMesh निर्माता के साथ पारित कर रहे हैं:

संपत्ति विवरण
agg_filter एक फिल्टर फ़ंक्शन, जो एक (एम, एन, 3) फ्लोट ऐरे और एक डीपीआई मूल्य लेता है, और एक (एम, एन, 3) एरे लौटाता है।
alpha फ्लोट या कोई नहीं
animated bool
antialiased बूल या बूल का क्रम
array ndarray
capstyle {'बट', 'राउंड', 'प्रोजेक्टिंग'}
clim तैरने की लंबाई 2 अनुक्रम; vmin और vmax kwargs वाले तरीकों को ओवरराइड किया जा सकता है।
clip_box Bbox
clip_on bool
clip_path [( Path , Transform ) | Patch | कोई नहीं]
cmap colormap या पंजीकृत colormap नाम
color matplotlib रंग arg या rgba tuples का अनुक्रम
contains प्रतिदेय
edgecolor रंगों का रंग या क्रम
facecolor रंगों का रंग या क्रम
figure Figure
gid str
hatch {'/', '\', '।', '-', '+', 'x', 'ओ', 'ओ', '।', '*'}।
in_layout bool
joinstyle {'मैंटर', 'राउंड', 'बेवल'}
label वस्तु
linestyle {'-', '-', '-', ':', '', (ऑफसेट, ऑन-ऑफ-सीक), ...}
linewidth तैरने की क्रिया या क्रम
norm Normalize
offset_position {'स्क्रीन', 'डेटा'}
offsets तैरने की क्रिया या क्रम
path_effects AbstractPathEffect
picker कोई नहीं या बूल या तैरने या बुलाने योग्य
pickradius अनजान
rasterized बूल या कोई नहीं
sketch_params (पैमाना: फ्लोट, लंबाई: फ्लोट, यादृच्छिकता: फ्लोट)
snap बूल या कोई नहीं
transform Transform
url str
urls सूची [str] या कोई नहीं
visible bool
zorder नाव

यह भी देखें

pcolor()
थोड़ा अलग सुविधाओं के साथ एक वैकल्पिक कार्यान्वयन। मतभेदों पर विस्तृत चर्चा के लिए पीसीरोल () और पीसीओलर्मेश () के बीच अंतर देखें।
imshow
यदि X और Y प्रत्येक समतुल्य हैं, तो imshow एक तेज़ विकल्प हो सकता है।

टिप्पणियाँ

नकाबपोश गिरफ्तार

सी एक नकाबपोश सरणी हो सकती है। यदि C[i, j] को मास्क किया जाता है, तो संबंधित चतुर्भुज पारदर्शी होगा। X और Y की मास्किंग समर्थित नहीं है। यदि आपको इस कार्यक्षमता की आवश्यकता है, तो pcolor() उपयोग करें।

ग्रिड ओरिएंटेशन

ग्रिड ओरिएंटेशन मानक मैट्रिक्स कन्वेंशन का अनुसरण करता है: आकृति के साथ एक सरणी सी (nrows, ncolumns) को स्तंभ संख्या X और Y के रूप में पंक्ति संख्या के साथ प्लॉट किया जाता है।

PColor () और PColormesh के बीच अंतर

दोनों विधियों का उपयोग चतुर्भुज का उपयोग करके 2-डी सरणी के छद्म चॉकलेट प्लॉट बनाने के लिए किया जाता है।

मुख्य अंतर निर्मित वस्तु और आंतरिक डेटा हैंडलिंग में निहित है: जबकि pcolor() एक PolyCollection लौटाता है, pcolormesh एक QuadMesh लौटाता है। उत्तरार्द्ध दिए गए उद्देश्य के लिए अधिक विशिष्ट है और इस प्रकार तेज है। यह लगभग हमेशा पसंद किया जाना चाहिए।

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

एक और अंतर pcolormesh में pcolormesh शेडिंग का समर्थन है, जो pcolor() साथ उपलब्ध नहीं है।

ध्यान दें

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

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

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

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