Matplotlib 3.0 - axes_grid1.colorbar

mpl_toolkits.axes_grid1.colorbar




matplotlib

mpl_toolkits.axes_grid1.colorbar

दो वर्गों और एक समारोह के साथ Colorbar टूलकिट:

ColorbarBase
पूर्ण रंग पट्टी ड्राइंग कार्यक्षमता के साथ आधार वर्ग। इसका उपयोग किसी दिए गए कॉलोर्मैप के लिए एक रंग पट्टी बनाने के लिए के रूप में किया जा सकता है; एक mappable ऑब्जेक्ट (जैसे, छवि) की जरूरत नहीं है।
Colorbar
छवियों या समोच्च भूखंडों के साथ उपयोग के लिए व्युत्पन्न वर्ग।
make_axes()
एक कुल्हाड़ी के आकार बदलने और एक रंग-पट्टी के लिए उपयुक्त दूसरी कुल्हाड़ियों को जोड़ने के लिए एक फ़ंक्शन

Colorbar colorbar() विधि make_axes() और Colorbar का उपयोग करता है; colorbar() फ़ंक्शन colorbar() पर एक पतला आवरण है।

class mpl_toolkits.axes_grid1.colorbar.CbarAxesLocator(locator=None, extend='neither', orientation='vertical') [source]

CbarAxesLocator, colorbar axes के लिए एक axes_locator है। यह विस्तारित छोरों के लिए एक जगह बनाने के लिए कुल्हाड़ियों की स्थिति को समायोजित करता है, अर्थात, विस्तारित छोर कुल्हाड़ियों क्षेत्र के बाहर स्थित हैं।

locator : the bbox returned from the locator is used as a
प्रारंभिक अक्ष स्थान। यदि कोई नहीं है, तो axes.bbox का उपयोग किया जाता है।

विस्तार : ColorbarBase अभिविन्यास में के रूप में ही: ColorbarBase में के रूप में ही

get_end_vertices() [source]

कलर्डबार विस्तारित छोरों के लिए दो कोने का टपल लौटाएं। पहला शीर्ष न्यूनतम अंत के लिए है, और दूसरा अधिकतम छोर के लिए है।

get_original_position(axes, renderer) [source]

कुल्हाड़ियों की मूल स्थिति प्राप्त करें।

get_path_ends() [source]

विस्तारित सिरों के लिए मार्ग प्राप्त करें

get_path_patch() [source]

कुल्हाड़ी पैच के लिए रास्ता मिलता है

class mpl_toolkits.axes_grid1.colorbar.Colorbar(ax, mappable, **kw) [source]
add_lines(CS) [source]

एक गैर-भरे ContourSet से लाइनों को ContourSet जोड़ें।

update_bruteforce(mappable) [source]

संबंधित mappable के परिवर्तन को प्रतिबिंबित करने के लिए colorbar कलाकारों को अपडेट करें।

class mpl_toolkits.axes_grid1.colorbar.ColorbarBase(ax, cmap=None, norm=None, alpha=1.0, values=None, boundaries=None, orientation='vertical', extend='neither', spacing='uniform', ticks=None, format=None, drawedges=False, filled=True) [source]

मौजूदा कुल्हाड़ियों में एक रंग पट्टी ड्रा करें।

यह Colorbar वर्ग के लिए एक आधार वर्ग है, जो colorbar() विधि और pyplot फ़ंक्शन के लिए आधार है।

यह एक कॉलॉर्मैप दिखाने के लिए भी अपने आप में उपयोगी है। यदि सीमैप कगार दिया जाता है, लेकिन सीमाओं और मूल्यों को किसी के रूप में नहीं छोड़ा जाता है, तो कॉलॉर्मप को 0-1 पैमाने पर प्रदर्शित किया जाएगा। निम्न और अधिक मूल्य वाले रंगों को दिखाने के लिए, निम्न मान निर्दिष्ट करें:

colors.Normalize(clip=False)

0-1 पैमाने के बजाय रंगों बनाम इंडेक्स को दिखाने के लिए, उपयोग करें:

norm=colors.NoNorm.

उपयोगी विशेषताएं:

ax
एक्सिस का उदाहरण जिसमें रंगीन पट्टी खींची जाती है
lines
यदि रेखाएँ खींची गई हैं तो LineCollection, अन्यथा कोई नहीं
dividers
यदि रेखाचित्र सही है, तो एक रेखा- चित्रण , अन्यथा कोई नहीं

उपयोगी सार्वजनिक विधियाँ set_label() और add_lines()

add_lines(levels, colors, linewidths) [source]

रंग पट्टी पर रेखाएँ बनाएँ। यह preexisting लाइनों को हटाता है।

set_alpha(alpha) [source]

अल्फा मान सेट करें।

set_label_text(label, **kw) [source]

कलरबार की लंबी अक्ष लेबल

update_artists() [source]

रंग से जुड़े कलाकारों को अपडेट करें, भरा हुआ और समाप्त करें । ध्यान दें कि लाइनें अपडेट नहीं हैं। जब भी संबद्ध छवि में परिवर्तन होता है, तो इसे बुलाया जाना चाहिए।

mpl_toolkits.axes_grid1.colorbar.colorbar(mappable, cax=None, ax=None, **kw) [source]

एक ScalarMappable उदाहरण के लिए एक colorbar बनाएँ।

पाइलॉट पतले आवरण के लिए प्रलेखन:

एक प्लॉट में एक कलरबार जोड़ें।

pyplot इंटरफ़ेस के लिए फ़ंक्शन हस्ताक्षर; सभी लेकिन पहले colorbar() विधि के लिए विधि हस्ताक्षर भी हैं:

colorbar(**kwargs)
colorbar(mappable, **kwargs)
colorbar(mappable, cax=cax, **kwargs)
colorbar(mappable, ax=ax, **kwargs)

तर्क:

mappable
Image , ContourSet , आदि जिस पर ContourSet लागू होता है; यह तर्क colorbar() विधि के लिए अनिवार्य है लेकिन colorbar() फ़ंक्शन के लिए वैकल्पिक है, जो वर्तमान छवि के लिए डिफ़ॉल्ट सेट करता है।

कीवर्ड तर्क:

cax
कोई नहीं | कुल्हाड़ी वस्तु जिसमें रंगबार खींचा जाएगा
कुल्हाड़ी
कोई नहीं | माता-पिता की कुल्हाड़ी वस्तु जिस से एक नए रंग पट्टी अक्षों के लिए जगह चोरी हो जाएगी

अतिरिक्त खोजशब्द तर्क दो प्रकार के होते हैं:

कुल्हाड़ी के गुण:

संपत्ति विवरण
उन्मुखीकरण ऊर्ध्वाधर या क्षैतिज
अंश 0.15; मूल अक्षों का अंश जो कलरबार के लिए उपयोग करता है
तकती 0.05 यदि ऊर्ध्वाधर, 0.15 यदि क्षैतिज; रंगबार और नई छवि अक्षों के बीच मूल अक्षों का अंश
हटना 1.0; अंश जिसके द्वारा कोलतार सिकुड़ता है
पहलू 20; लंबे समय से छोटे आयामों का अनुपात

रंग गुण:

संपत्ति विवरण
विस्तार ['न तो' | 'दोनों' | 'मिनट' | 'अधिकतम'] यदि 'नहीं' नहीं है, तो आउट-ऑफ-रेंज मानों के लिए नुकीले सिरे (एस) बनाएं। ये दिए गए colormap के लिए colormap set_under और set_over विधियों का उपयोग करके सेट किए गए हैं।
अंतर ['वर्दी' | 'आनुपातिक'] समान रिक्ति प्रत्येक असतत रंग को एक ही स्थान देती है; आनुपातिक डेटा अंतराल के लिए आनुपातिक बनाता है।
टिक [कोई नहीं | टिक्स की सूची | लोकेटर ऑब्जेक्ट] यदि कोई नहीं है, तो टिक इनपुट से स्वचालित रूप से निर्धारित किया जाता है।
प्रारूप [कोई नहीं | प्रारूप स्ट्रिंग | ScalarFormatter ऑब्जेक्ट] यदि कोई नहीं, तो ScalarFormatter का उपयोग किया जाता है। यदि एक प्रारूप स्ट्रिंग दिया जाता है, उदाहरण के लिए, '% .3f', जिसका उपयोग किया जाता है। इसके बजाय एक वैकल्पिक Formatter वस्तु दी जा सकती है।
drawedges बूल चाहे रंग सीमाओं पर रेखाएँ खींचे।

निम्नलिखित संभवत: केवल अनुक्रमित रंगों के संदर्भ में उपयोगी होगा (यह है, जब मैप्पेबल के पास आदर्श = NoNorm ()), या अन्य असामान्य परिस्थितियां हैं।

संपत्ति विवरण
सीमाओं कोई नहीं या एक क्रम
मान कोई भी या एक अनुक्रम जो सीमाओं के अनुक्रम से कम 1 लंबाई का होना चाहिए। सीमाओं में आसन्न प्रविष्टियों द्वारा सीमांकित प्रत्येक क्षेत्र के लिए, मूल्यों में संबंधित मान के लिए मैप किए गए रंग का उपयोग किया जाएगा।

यदि mappable एक ContourSet , तो इसका विस्तार kwarg स्वचालित रूप से शामिल है।

ध्यान दें कि हटना kwarg एक ऊर्ध्वाधर colorbar रखने के लिए एक सरल तरीका प्रदान करता है, उदाहरण के लिए, मैप्पेबल की कुल्हाड़ियों से अधिक लंबा होने से जो colorbar संलग्न है; लेकिन यह एक मैनुअल विधि है जिसमें कुछ परीक्षण और त्रुटि की आवश्यकता होती है। यदि रंग पट्टी बहुत अधिक लंबी है (या एक क्षैतिज रंग पट्टी बहुत चौड़ी है) तो छोटे मूल्य का उपयोग करें।

अधिक सटीक नियंत्रण के लिए, आप कुल्हाड़ियों की वस्तुओं को मैन्युअल रूप से निर्दिष्ट कर सकते हैं जिसमें मैप करने योग्य और रंगीन पट्टी खींची जाती है। इस मामले में, कुल्हाड़ियों के किसी भी गुण का उपयोग न करें।

यह ज्ञात है कि कुछ वेक्टर ग्राफिक्स दर्शक (svg और pdf) कलरबार के खंडों के बीच सफेद अंतराल का प्रतिपादन करते हैं। यह दर्शकों में बग के कारण होता है न कि मैटलोट्लिब। एक वर्कअराउंड के रूप में कलरबार को ओवरलैपिंग सेगमेंट के साथ प्रदान किया जा सकता है:

cbar = colorbar()
cbar.solids.set_edgecolor("face")
draw()

हालांकि इसका अन्य परिस्थितियों में नकारात्मक परिणाम है। विशेष रूप से अर्ध पारदर्शी छवियों (अल्फा <1) और रंगबार एक्सटेंशन के साथ और डिफ़ॉल्ट रूप से सक्षम नहीं है (मुद्दा # 1188)।

रिटर्न:
Colorbar उदाहरण; इसका आधार वर्ग, ColorbarBase भी देखें। set_label() को लेबल करने के लिए set_label() विधि को कॉल करें।

कॉक्स का ट्रांसडेटा समायोजित किया जाता है ताकि सबसे लंबे अक्ष में सीमाएं वास्तव में रंगबार रेंज में सीमा से मेल खाती हैं। दूसरी ओर, सबसे छोटी अक्ष में [1,2] की डेटा सीमा होती है, जिसका अपरंपरागत मान लॉग स्केल का उपयोग करने पर अंडरफ़्लो को रोकने के लिए होता है।

mpl_toolkits.axes_grid1.colorbar.make_axes(parent, *, fraction=0.15, shrink=1.0, aspect=20, **kw) [source]

माता-पिता की कुल्हाड़ियों का आकार बदलें और उनका पुनरावर्तन करें, और एक रंग-पट्टी के लिए उपयुक्त बाल कुल्हाड़ियों को वापस करें

cax, kw = make_axes(parent, **kw)

कीवर्ड तर्क में निम्नलिखित शामिल हो सकते हैं (चूक के साथ):

उन्मुखीकरण
'ऊर्ध्वाधर' या 'क्षैतिज'
संपत्ति विवरण
उन्मुखीकरण ऊर्ध्वाधर या क्षैतिज
अंश 0.15; मूल अक्षों का अंश जो कलरबार के लिए उपयोग करता है
तकती 0.05 यदि ऊर्ध्वाधर, 0.15 यदि क्षैतिज; रंगबार और नई छवि अक्षों के बीच मूल अक्षों का अंश
हटना 1.0; अंश जिसके द्वारा कोलतार सिकुड़ता है
पहलू 20; लंबे समय से छोटे आयामों का अनुपात

सभी लेकिन इनमें से पहले इनपुट kw सेट से छीन लिए गए हैं।

रिटर्न (cax, kw), बाल कुल्हाड़ियों और कम kw शब्दकोश।