2197 lines
151 KiB
Plaintext
2197 lines
151 KiB
Plaintext
|
Ë
|
|||
|
|
†R j.+ ã ó — d Z ddlmZ ddlZddlZddlZddlZddlmZ ddl Z ddl
|
|||
|
|
Z ddl Z
|
|||
|
|
ddl mZmZmZmZ ddlmZmZmZ ddlmZmZmZmZmZ ddl m Z ddl m Z ddl m!Z" ddl#m$Z% ddl&m'Z' dd l(m)Z)m*Z* dd
|
|||
|
|
l+m,Z,m-Z-m.Z.m/Z/ ddl0m1Z2 dd l3m4Z4 dd l5m6Z6 dd
|
|||
|
|
l7m8Z8m9Z9m:Z:m;Z; ejx e=« Z>d„ Z? G d„ d« Z@ G d„ de« ZAej„ G d„ deA« « ZCej„ G d„ deA« « ZDd„ ZEy)aÎ
|
|||
|
|
`matplotlib.figure` implements the following classes:
|
|||
|
|
|
|||
|
|
`Figure`
|
|||
|
|
Top level `~matplotlib.artist.Artist`, which holds all plot elements.
|
|||
|
|
Many methods are implemented in `FigureBase`.
|
|||
|
|
|
|||
|
|
`SubFigure`
|
|||
|
|
A logical figure inside a figure, usually added to a figure (or parent `SubFigure`)
|
|||
|
|
with `Figure.add_subfigure` or `Figure.subfigures` methods.
|
|||
|
|
|
|||
|
|
Figures are typically created using pyplot methods `~.pyplot.figure`,
|
|||
|
|
`~.pyplot.subplots`, and `~.pyplot.subplot_mosaic`.
|
|||
|
|
|
|||
|
|
.. plot::
|
|||
|
|
:include-source:
|
|||
|
|
|
|||
|
|
fig, ax = plt.subplots(figsize=(2, 2), facecolor='lightskyblue',
|
|||
|
|
layout='constrained')
|
|||
|
|
fig.suptitle('Figure')
|
|||
|
|
ax.set_title('Axes', loc='left', fontstyle='oblique', fontsize='medium')
|
|||
|
|
|
|||
|
|
Some situations call for directly instantiating a `~.figure.Figure` class,
|
|||
|
|
usually inside an application of some sort (see :ref:`user_interfaces` for a
|
|||
|
|
list of examples) . More information about Figures can be found at
|
|||
|
|
:ref:`figure-intro`.
|
|||
|
|
é )Ú ExitStackN)ÚIntegral)Ú_blocking_inputÚ
|
|||
|
|
backend_basesÚ
|
|||
|
|
_docstringÚ projections)ÚArtistÚallow_rasterizationÚ_finalize_rasterization)Ú DrawEventÚFigureCanvasBaseÚNonGuiExceptionÚ MouseButtonÚ
|
|||
|
|
_get_renderer)ÚAxes)ÚGridSpecÚ
|
|||
|
|
SubplotParams)ÚConstrainedLayoutEngineÚTightLayoutEngineÚ LayoutEngineÚPlaceHolderLayoutEngine)Ú Rectangle)ÚText)ÚAffine2DÚBboxÚBboxTransformToÚTransformedBboxc ó< — | j d¬« x}�||_ y y )NF©Úroot)Ú
|
|||
|
|
get_figureÚstale)ÚselfÚvalÚfigs úT/home/antigravity/intellecton/venv/lib/python3.12/site-packages/matplotlib/figure.pyÚ_stale_figure_callbackr' A s$ € Ø�‰ EˆÓ*Ð*ˆÐ7؈� ð 8ó c ó@ — e Zd ZdZd„ Zd„ Zd„ Zd„ Zd„ Zd„ Z d„ Z
|
|||
|
|
d „ Z y
|
|||
|
|
) Ú
|
|||
|
|
_AxesStacka
|
|||
|
|
|
|||
|
|
Helper class to track Axes in a figure.
|
|||
|
|
|
|||
|
|
Axes are tracked both in the order in which they have been added
|
|||
|
|
(``self._axes`` insertion/iteration order) and in the separate "gca" stack
|
|||
|
|
(which is the index to which they map in the ``self._axes`` dict).
|
|||
|
|
c óD — i | _ t j « | _ y ©N)Ú_axesÚ itertoolsÚcountÚ_counter©r# s r& Ú__init__z_AxesStack.__init__O s € ؈Œ
|
|||
|
|
Ü!Ÿ™Ó)ˆ�
|
|||
|
|
r( c ó — g | j ¢S )z1List the Axes that have been added to the figure.)r- r1 s r& Úas_listz_AxesStack.as_listS s € à �—‘ˆ}Ð r( c ó: — | j j |« y)z Remove the Axes from the stack.N)r- Úpop©r# Úas r& Úremovez_AxesStack.removeW s € à �
|
|||
|
|
‰
|
|||
|
|
�‰�qÕr( c óz — || j vr t d« ‚t | j « | j |< y)z@Move an Axes, which must already exist in the stack, to the top.zAxes has not been added yetN)r- Ú
|
|||
|
|
ValueErrorÚnextr0 r7 s r& Úbubblez_AxesStack.bubble[ s0 € à �D—J‘JÑ Ü Ð :Ó;Ð ;Ü ˜TŸ]™]Ó+ˆ�
|
|||
|
|
‰
|
|||
|
|
�1Š
|
|||
|
|
r( c óf — || j vr#t | j « | j |< yy)z9Add an Axes to the stack, ignoring it if already present.N)r- r< r0 r7 s r& Úaddz_AxesStack.adda s) € à �D—J‘JÑ Ü § ¡ Ó /ˆD�J‰J�qŠMð r( c óZ — t | j | j j d¬« S )z6Return the active Axes, or None if the stack is empty.N)ÚkeyÚdefault)Úmaxr- Ú __getitem__r1 s r& Úcurrentz_AxesStack.currentf s € ä�4—:‘: 4§:¡:×#9Ñ#9À4ÔHÐHr( c ój — i t | « ¥dt | j j « d¬« i¥S )Nr0 r )rB )ÚvarsrC r- Úvaluesr1 s r& Ú __getstate__z_AxesStack.__getstate__j s6 € ð
|
|||
|
|
Ü�4‹jð
|
|||
|
|
à œ˜DŸJ™J× -Ñ -Ó /¸Ô;ñ
|
|||
|
|
ð
|
|||
|
|
r( c óŽ — |j d« }t | « j |« t j |« | _ y )Nr0 )r6 rG Úupdater. r/ r0 )r# ÚstateÚ next_counters r& Ú __setstate__z_AxesStack.__setstate__p s2 € Ø —y‘y Ó,ˆ Ü ˆT‹
|
|||
|
|
×ј%Ô Ü!Ÿ™¨ Ó5ˆ�
|
|||
|
|
r( N) Ú__name__Ú
|
|||
|
|
__module__Ú __qualname__Ú__doc__r2 r4 r9 r= r? rE rI rN © r( r& r* r* F s0 „ ñò*ò òò,ò 0ò
|
|||
|
|
Iò
|
|||
|
|
ó 6r( r* c óÜ ‡ — e Zd ZdZˆ fd„Zd„ Z dQd„Zd„ ZdRd„Zd„ Z e
|
|||
|
|
e j ed ¬
|
|||
|
|
« e d ¬ « Z
|
|||
|
|
d
|
|||
|
|
„ ZdRd„Zd„ Zd„ Z ej& dddddd¬« ej( e« d„ « « Zd„ Z ej& ddddd d ¬« ej( e« d „ « « Zd „ Z ej& d dd!d"dd ¬« ej( e« d#„ « « Zd$„ Zd%„ Zd&„ Z d'„ Z d(„ Z d)„ Z d*„ Z d+„ Z!d,„ Z" e
|
|||
|
|
e e"« Z#dSd.„Z$ejJ d/„ « Z&ejJ d0„ « Z'd1„ Z(dTd-d-d ddddd2œd3„Z)d4„ Z*d5„ Z+dSd6„Z,dSd7„Z-ejJ d8„ « Z.ejJ dRd9„« Z/ejJ dUd:„« Z0 dVd;„Z1dRd<„Z2dRd=„Z3dRd>„Z4dRd?„Z5dTd@„Z6 dWdA„Z7dB„ Z8dC„ Z9dD„ Z:dE„ Z;dd-ddFœdG„Z<dH„ Z=dRddIœdJ„Z>e?dK„ « Z@e?dL„ « ZAd-d-dddMddddNœdO„ZBdP„ ZCˆ xZDS )XÚ
|
|||
|
|
FigureBasez�
|
|||
|
|
Base class for `.Figure` and `.SubFigure` containing the methods that add
|
|||
|
|
artists to the figure or subfigure, create Axes, etc.
|
|||
|
|
c ó‚ •— t ‰| � « | `d | _ d | _ d | _ t
|
|||
|
|
j « t
|
|||
|
|
j « t
|
|||
|
|
j « dœ| _ g | _ g | _
|
|||
|
|
g | _ g | _ g | _
|
|||
|
|
g | _ g | _ g | _ d| _ d | _ | j& di |¤Ž y )N)ÚxÚyÚtitleTrS )Úsuperr2 r- Ú _suptitleÚ
|
|||
|
|
_supxlabelÚ
|
|||
|
|
_supylabelÚcbookÚGrouperÚ_align_label_groupsÚ
|
|||
|
|
_localaxesÚartistsÚlinesÚpatchesÚtextsÚimagesÚlegendsÚsubfigsr" ÚsuppressCompositeÚset)r# ÚkwargsÚ __class__s €r& r2 zFigureBase.__init__{ s« ø€ Ü
|
|||
|
|
‰ÑÔð
|
|||
|
|
|
|||
|
|
ˆJà ˆŒØ ˆŒØ ˆŒô — ‘ “ Ü— ‘ “ Ü—]‘]“_ñ$
|
|||
|
|
ˆÔ 𠈌؈Œ ؈Œ
|
|||
|
|
؈Œ ؈Œ
|
|||
|
|
؈Œ ؈Œ ؈Œ ؈Œ
|
|||
|
|
Ø!%ˆÔ ؈�‰Ñ�6Ór( c óœ — | j « }|j | j « t d„ |D « d„ ¬« }| j D ]| }|j « }|j
|
|||
|
|
|r |||« nd« |j « D ]; }t |d« sŒ|j « }|j
|
|||
|
|
|r |||« nd« Œ= Œ~ |S )zAlso runs apply_aspectc 3 óB K — | ] }|j « rŒ|–— Œ y wr, )Ú get_animated)Ú.0Úartists r& ú <genexpr>z/FigureBase._get_draw_artists.<locals>.<genexpr>¢ s è ø€ Ò G˜°×1DÑ1DÕ1FŒVÑ Gùs ‚ ˜ c ó" — | j « S r, )Ú
|
|||
|
|
get_zorder)rq s r& ú<lambda>z.FigureBase._get_draw_artists.<locals>.<lambda>£ s € ˜v× 0Ñ 0Ó 2€ r( )rA NÚ apply_aspect)Ú get_childrenr9 ÚpatchÚsortedra Úget_axes_locatorrv Úhasattr)r# Úrendererrb ÚaxÚlocatorÚchilds r& Ú_get_draw_artistsz FigureBase._get_draw_artistsœ sÅ € à×#Ñ#Ó%ˆà�‰�t—z‘zÔ"ÜÙ G 'Ô GÙ2ô4ˆð —/‘/ò GˆBØ×)Ñ)Ó+ˆGØ �O‰O±W™G B¨Ô 1À$Ô GàŸ ™ Ó*ò
|
|||
|
|
G�ܘ5 .Õ1Ø #× 4Ñ 4Ó 6�GØ×&Ñ&Ù4;™ xÔ0ÀõGñ
|
|||
|
|
Gð Gð ˆr( c ó — t j g d¢|¬« | j D �cg c] }|j dk7 sŒ|‘Œ }}t d„ |D « « }t |« dk( rG| j d j
|
|||
|
|
|¬« D ]$ }|j |« |j |« Œ& nš|r˜|D ]“ }|j « j « r:|j
|
|||
|
|
|¬« D ]$ }|j |« |j |« Œ& Œ[|j
|
|||
|
|
|¬« D ] }|j d« Œ |j d« Œ• | j « } |r | � | j r| j |¬
|
|||
|
|
« d | _ y c c}w ) a\
|
|||
|
|
Date ticklabels often overlap, so it is useful to rotate them
|
|||
|
|
and right align them. Also, a common use case is a number of
|
|||
|
|
subplots with shared x-axis where the x-axis is date data. The
|
|||
|
|
ticklabels are often long, and it helps to rotate them on the
|
|||
|
|
bottom subplot and turn them off on other subplots, as well as
|
|||
|
|
turn off xlabels.
|
|||
|
|
|
|||
|
|
Parameters
|
|||
|
|
----------
|
|||
|
|
bottom : float, default: 0.2
|
|||
|
|
The bottom of the subplots for `subplots_adjust`.
|
|||
|
|
rotation : float, default: 30 degrees
|
|||
|
|
The rotation angle of the xtick labels in degrees.
|
|||
|
|
ha : {'left', 'center', 'right'}, default: 'right'
|
|||
|
|
The horizontal alignment of the xticklabels.
|
|||
|
|
which : {'major', 'minor', 'both'}, default: 'major'
|
|||
|
|
Selects which ticklabels to rotate.
|
|||
|
|
)ÚmajorÚminorÚboth)Úwhichz
|
|||
|
|
<colorbar>c 3 ó< K — | ] }|j « –— Œ y wr, )Úget_subplotspec)rp r} s r& rr z+FigureBase.autofmt_xdate.<locals>.<genexpr>Æ s è ø€ Ò>°2˜"×,Ñ,×.Ñ>ùs ‚ é r FÚ N)ÚbottomT)Ú_apiÚ
|
|||
|
|
check_in_listÚaxesÚ_labelÚallÚlenÚget_xticklabelsÚset_haÚ set_rotationr‡ Ú is_last_rowÚ set_visibleÚ
|
|||
|
|
set_xlabelÚget_layout_engineÚadjust_compatibleÚsubplots_adjustr" )
|
|||
|
|
r# rŠ ÚrotationÚhar… r} r� Ú allsubplotsÚlabelÚengines
|
|||
|
|
r& Ú
|
|||
|
|
autofmt_xdatezFigureBase.autofmt_xdate¯ sg € ô*
|
|||
|
|
×ÑÒ5¸UÕCØ !ŸY™YÖD�r¨"¯)©)°|Ó*C’ÐDˆÐDÜÑ>¸Ô>Ó>ˆ Ü ˆt‹9˜Š>Ø Ÿ™ 1™ ×5Ñ5¸EÐ5ÓBò
|
|||
|
|
-�Ø— ‘ ˜RÔ Ø×"Ñ" 8Õ,ñ
|
|||
|
|
-ñ Ø ò *�BØ×)Ñ)Ó+×7Ñ7Ô9Ø%'×%7Ñ%7¸eÐ%7Ó%Dò 9˜EØ !ŸL™L¨Ô ,Ø !× .Ñ .¨xÕ 8ñ9ð &(×%7Ñ%7¸eÐ%7Ó%Dò 5˜EØ !× -Ñ -¨eÕ 4ð5àŸ
|
|||
|
|
™
|
|||
|
|
bÕ)ð*ð ×'Ñ'Ó)ˆÙ ˜F˜N¨f×.FÒ.FØ × Ñ ¨Ð Ô /؈�
|
|||
|
|
ùò+ Es
|
|||
|
|
¨E>½E>c óÜ — | j g| j ¢| j ¢| j ¢| j ¢| j
|
|||
|
|
¢| j ¢| j ¢| j ¢S )z.Get a list of artists contained in the figure.) rx rb ra rc rd re rf rg rh r1 s r& rw zFigureBase.get_childrenÜ s € à—
|
|||
|
|
‘
|
|||
|
|
ð Ø— ‘ ð à— ‘ ð ð —‘ð ð — ‘ ð ð
|
|||
|
|
—‘ð ð —‘ð
|
|||
|
|
ð — ‘ ð ð — ‘ ð ð r( Nc óØ — | j | u r| S | j | j u r | j S |€d}t j d|¬« d}|r | j S | j S )a•
|
|||
|
|
Return the `.Figure` or `.SubFigure` instance the (Sub)Figure belongs to.
|
|||
|
|
|
|||
|
|
Parameters
|
|||
|
|
----------
|
|||
|
|
root : bool, default=True
|
|||
|
|
If False, return the (Sub)Figure this artist is on. If True,
|
|||
|
|
return the root Figure for a nested tree of SubFigures.
|
|||
|
|
|
|||
|
|
.. deprecated:: 3.10
|
|||
|
|
|
|||
|
|
From version 3.12 *root* will default to False.
|
|||
|
|
zÿFrom Matplotlib 3.12 SubFigure.get_figure will by default return the direct parent figure, which may be a SubFigure. To suppress this warning, pass the root parameter. Pass `True` to maintain the old behavior and `False` to opt-in to the future behavior.ú3.10©ÚmessageT)Ú _root_figureÚ_parentr‹ Úwarn_deprecated)r# r r¤ s r& r! zFigureBase.get_figureè sq € ð × Ñ Ñ $àˆKà �<‰<˜4×,Ñ,Ñ ,ð —<‘<Ð à ˆ<ð.ˆGô
|
|||
|
|
|
|||
|
|
× Ñ °Õ 9؈Dá Ø×$Ñ$Ð $à�|‰|Ðr( c ón — d}|| j u rt j d|› d�¬« yt |« ‚)zñ
|
|||
|
|
.. deprecated:: 3.10
|
|||
|
|
Currently this method will raise an exception if *fig* is anything other
|
|||
|
|
than the root `.Figure` this (Sub)Figure is on. In future it will always
|
|||
|
|
raise an exception.
|
|||
|
|
z\The parent and root figures of a (Sub)Figure are set at instantiation and cannot be changed.r¢ z= From Matplotlib 3.12 this operation will raise an exception.r£ N)r¥ r‹ r§ r; )r# r% Ú no_switchs r& Ú
|
|||
|
|
set_figurezFigureBase.set_figure sG € ð<ˆ à �$×#Ñ#Ñ #Ü × Ñ ØØ %˜;ð ')ð )õ
|
|||
|
|
+ð
|
|||
|
|
ä˜Ó#Ð#r( Tr zTThe root `Figure`. To get the parent of a `SubFigure`, use the `get_figure` method.©Údocc ó” — | j |« rdi fS | j j |j |j « }|i fS )z|
|
|||
|
|
Test whether the mouse event occurred on the figure.
|
|||
|
|
|
|||
|
|
Returns
|
|||
|
|
-------
|
|||
|
|
bool, {}
|
|||
|
|
F)Ú_different_canvasÚbboxÚcontainsrW rX )r# Ú
|
|||
|
|
mouseeventÚinsides r& r° zFigureBase.contains% sD € ð × !Ñ ! *Ô -ؘ"�9Ð Ø—‘×#Ñ# J§L¡L°*·,±,Ó?ˆØ�rˆzÐr( c ó — | j S r, ©r¯ ©r# r| s r& Úget_window_extentz FigureBase.get_window_extent2 s € à�y‰yÐr( c ó4 — |j dd« }|j dd« }|d dv r|du }n |d dk( r|du }|€|d }|€|d }t j |t « }|j d |d
|
|||
|
|
« |j d |d « |j d
|
|||
|
|
|d
|
|||
|
|
« d|vrL|j dt
|
|||
|
|
j |d « |j dt
|
|||
|
|
j |d « t | |d « }|�7|j |« |j ||f« |j di |¤Ž nN | j |||fi |¤Ž}t | |d |« t j | j |d ¬« |_ |_ d| _ |S )aí
|
|||
|
|
Add a centered %(name)s to the figure.
|
|||
|
|
|
|||
|
|
Parameters
|
|||
|
|
----------
|
|||
|
|
t : str
|
|||
|
|
The %(name)s text.
|
|||
|
|
x : float, default: %(x0)s
|
|||
|
|
The x location of the text in figure coordinates.
|
|||
|
|
y : float, default: %(y0)s
|
|||
|
|
The y location of the text in figure coordinates.
|
|||
|
|
horizontalalignment, ha : {'center', 'left', 'right'}, default: %(ha)s
|
|||
|
|
The horizontal alignment of the text relative to (*x*, *y*).
|
|||
|
|
verticalalignment, va : {'top', 'center', 'bottom', 'baseline'}, default: %(va)s
|
|||
|
|
The vertical alignment of the text relative to (*x*, *y*).
|
|||
|
|
fontsize, size : default: :rc:`figure.%(rc)ssize`
|
|||
|
|
The font size of the text. See `.Text.set_size` for possible
|
|||
|
|
values.
|
|||
|
|
fontweight, weight : default: :rc:`figure.%(rc)sweight`
|
|||
|
|
The font weight of the text. See `.Text.set_weight` for possible
|
|||
|
|
values.
|
|||
|
|
|
|||
|
|
Returns
|
|||
|
|
-------
|
|||
|
|
text
|
|||
|
|
The `.Text` instance of the %(name)s.
|
|||
|
|
|
|||
|
|
Other Parameters
|
|||
|
|
----------------
|
|||
|
|
fontproperties : None or dict, optional
|
|||
|
|
A dict of font properties. If *fontproperties* is given the
|
|||
|
|
default values for font size and weight are taken from the
|
|||
|
|
`.FontProperties` defaults. :rc:`figure.%(rc)ssize` and
|
|||
|
|
:rc:`figure.%(rc)sweight` are ignored in this case.
|
|||
|
|
|
|||
|
|
**kwargs
|
|||
|
|
Additional kwargs are `matplotlib.text.Text` properties.
|
|||
|
|
rW NrX Úname)r\ r[ r] Úx0Úy0Úhorizontalalignmentr› ÚverticalalignmentÚvarš ÚfontpropertiesÚfontsizeÚsizeÚ
|
|||
|
|
fontweightÚweight)r¸ TrS )r6 r^ Únormalize_kwargsr Ú
|
|||
|
|
setdefaultÚmplÚrcParamsÚgetattrÚset_textÚ set_positionrj ÚtextÚsetattrÚ functoolsÚpartialÚ_remove_suplabelÚ_remove_methodÚ_autoposr" )r# ÚtÚinfork rW rX ÚautoposÚsuplabs r& Ú
|
|||
|
|
_suplabelszFigureBase._suplabels6 s¥ € ðR
|
|||
|
|
�J‰J�s˜DÓ !ˆØ �J‰J�s˜DÓ !ˆØ �‰<Ð6Ñ 6ؘ4�i‰GØ
|
|||
|
|
�&‰\˜\Ò
|
|||
|
|
)ؘ4�iˆGØ ˆ9Ø�T‘
|
|||
|
|
ˆAØ ˆ9Ø�T‘
|
|||
|
|
ˆAä×'Ñ'¨´Ó5ˆØ×ÑÐ/°°d±Ô<Ø×ÑÐ-¨t°D©zÔ:Ø×ј* d¨:Ñ&6Ô7à 6Ñ )Ø × Ñ ˜j¬#¯,©,°t¸F±|Ñ*DÔ EØ × Ñ ˜l¬C¯L©L¸¸h¹ Ñ,HÔ I䘘t F™|Ó,ˆØ Ð Ø �O‰O˜AÔ Ø × Ñ A Ô 'Ø ˆF�J‰JÑ ˜Ó à �T—Y‘Y˜q ! QÑ1¨&Ñ1ˆFÜ �D˜$˜v™,¨Ô /Ü$-×$5Ñ$5°d×6KÑ6KØ;?À¹<ô%IˆFÔ !ð "ˆŒØˆŒ
|
|||
|
|
؈
|
|||
|
|
r( c óT — | j j |« t | |d « y r, )re r9 rË )r# r� r¸ s r& rÎ zFigureBase._remove_suplabel‚ s € Ø �
|
|||
|
|
‰
|
|||
|
|
×ј%Ô Ü��d˜DÕ!r( ç à?ç\�Âõ(\ï?z super titleÚcenterÚtoprY )r¹ rº r¸ r› r½ Úrcc ó@ — ddddddddd œ} | j ||fi |¤ŽS )
|
|||
|
|
Nr[ r× rØ rÙ rÚ r zfigure.titlesizezfigure.titleweight©r¸ r¹ rº r› r½ rš rÀ r ©rÕ ©r# rÑ rk rÒ s r& ÚsuptitlezFigureBase.suptitle† s: € ð
|
|||
|
|
$¨3°dØ e¸Ø*Ð6JñLˆð ˆt�‰˜q $Ñ1¨&Ñ1Ð1r( c óB — | j }|€dS |j « S )z<Return the suptitle as string or an empty string if not set.r‰ )r[ Úget_text©r# Útext_objs r& Ú get_suptitlezFigureBase.get_suptitle� s$ € à—>‘>ˆØ Ð%ˆrÐ>¨8×+<Ñ+<Ó+>Ð>r( ç{®Gáz„?z super xlabelrŠ r� c ó@ — ddddddddd œ} | j ||fi |¤ŽS )
|
|||
|
|
Nr\ r× ræ rÙ rŠ r úfigure.labelsizeúfigure.labelweightrÝ rÞ rß s r& Ú supxlabelzFigureBase.supxlabel• s: € ð
|
|||
|
|
%¨C°tØ h¸AØ*Ð6JñLˆð ˆt�‰˜q $Ñ1¨&Ñ1Ð1r( c óB — | j }|€dS |j « S )z=Return the supxlabel as string or an empty string if not set.r‰ )r\ râ rã s r& Ú
|
|||
|
|
get_supxlabelzFigureBase.get_supxlabelŸ ó$ € à—?‘?ˆØ Ð%ˆrÐ>¨8×+<Ñ+<Ó+>Ð>r( ç{®Gáz”?z super ylabelÚleftc
|
|||
|
|
óB — ddddddddd d
|
|||
|
|
œ } | j ||fi |¤ŽS ) Nr] rî r× rï rÙ ÚverticalÚanchorrè ré ) r¸ r¹ rº r› r½ rš Ú
|
|||
|
|
rotation_moderÀ r rÞ rß s r& Ú supylabelzFigureBase.supylabel¤ s< € ð
|
|||
|
|
%¨D¸Ø H¸*Ø!)Ð3EØ.ñ0ˆð ˆt�‰˜q $Ñ1¨&Ñ1Ð1r( c óB — | j }|€dS |j « S )z=Return the supylabel as string or an empty string if not set.r‰ )r] râ rã s r& Ú
|
|||
|
|
get_supylabelzFigureBase.get_supylabel¯ rí r( c ó6 — | j j « S )z+Get the edge color of the Figure rectangle.)rx Ú
|
|||
|
|
get_edgecolorr1 s r& rø zFigureBase.get_edgecolor´ ó € à�z‰z×'Ñ'Ó)Ð)r( c ó6 — | j j « S )z+Get the face color of the Figure rectangle.)rx Ú
|
|||
|
|
get_facecolorr1 s r& rû zFigureBase.get_facecolor¸ rù r( c ó6 — | j j « S )z²
|
|||
|
|
Return the figure's background patch visibility, i.e.
|
|||
|
|
whether the figure background will be drawn. Equivalent to
|
|||
|
|
``Figure.patch.get_visible()``.
|
|||
|
|
)rx Ú get_visibler1 s r& Ú get_frameonzFigureBase.get_frameon¼ s € ð �z‰z×%Ñ%Ó'Ð'r( c ó: — | j j |« y)z
|
|||
|
|
Set the line width of the Figure rectangle.
|
|||
|
|
|
|||
|
|
Parameters
|
|||
|
|
----------
|
|||
|
|
linewidth : number
|
|||
|
|
N)rx Ú
|
|||
|
|
set_linewidth)r# Ú linewidths r& r zFigureBase.set_linewidthÄ s € ð
|
|||
|
|
�
|
|||
|
|
‰
|
|||
|
|
× Ñ Õ+r( c ó6 — | j j « S )z=
|
|||
|
|
Get the line width of the Figure rectangle.
|
|||
|
|
)rx Ú
|
|||
|
|
get_linewidthr1 s r& r zFigureBase.get_linewidthÎ s € ð �z‰z×'Ñ'Ó)Ð)r( c ó: — | j j |« y)z…
|
|||
|
|
Set the edge color of the Figure rectangle.
|
|||
|
|
|
|||
|
|
Parameters
|
|||
|
|
----------
|
|||
|
|
color : :mpltype:`color`
|
|||
|
|
N)rx Ú
|
|||
|
|
set_edgecolor©r# Úcolors r& r zFigureBase.set_edgecolorÔ ó € ð
|
|||
|
|
�
|
|||
|
|
‰
|
|||
|
|
× Ñ Õ'r( c ó: — | j j |« y)z…
|
|||
|
|
Set the face color of the Figure rectangle.
|
|||
|
|
|
|||
|
|
Parameters
|
|||
|
|
----------
|
|||
|
|
color : :mpltype:`color`
|
|||
|
|
N)rx Ú
|
|||
|
|
set_facecolorr s r& r
|
|||
|
|
zFigureBase.set_facecolorÞ r r( c óH — | j j |« d| _ y)zç
|
|||
|
|
Set the figure's background patch visibility, i.e.
|
|||
|
|
whether the figure background will be drawn. Equivalent to
|
|||
|
|
``Figure.patch.set_visible()``.
|
|||
|
|
|
|||
|
|
Parameters
|
|||
|
|
----------
|
|||
|
|
b : bool
|
|||
|
|
TN)rx r• r" )r# Úbs r& Ú set_frameonzFigureBase.set_frameonè s € ð
|
|||
|
|
�
|
|||
|
|
‰
|
|||
|
|
× Ñ ˜qÔ!؈�
|
|||
|
|
r( Fc óR — |j | « | j j |« | j j |_ |j « s|j
|
|||
|
|
| j « |r+|j « €|j | j « d| _ |S )aÙ
|
|||
|
|
Add an `.Artist` to the figure.
|
|||
|
|
|
|||
|
|
Usually artists are added to `~.axes.Axes` objects using
|
|||
|
|
`.Axes.add_artist`; this method can be used in the rare cases where
|
|||
|
|
one needs to add artists directly to the figure instead.
|
|||
|
|
|
|||
|
|
Parameters
|
|||
|
|
----------
|
|||
|
|
artist : `~matplotlib.artist.Artist`
|
|||
|
|
The artist to add to the figure. If the added artist has no
|
|||
|
|
transform previously set, its transform will be set to
|
|||
|
|
``figure.transSubfigure``.
|
|||
|
|
clip : bool, default: False
|
|||
|
|
Whether the added artist should be clipped by the figure patch.
|
|||
|
|
|
|||
|
|
Returns
|
|||
|
|
-------
|
|||
|
|
`~matplotlib.artist.Artist`
|
|||
|
|
The added artist.
|
|||
|
|
T) rª rb Úappendr9 rÏ Úis_transform_setÚ
|
|||
|
|
set_transformÚtransSubfigureÚ
|
|||
|
|
get_clip_pathÚ
|
|||
|
|
set_clip_pathrx r" )r# rq Úclips r& Ú
|
|||
|
|
add_artistzFigureBase.add_artist÷ s… € ð, ×ј$Ô Ø � ‰ ×јFÔ#Ø $§ ¡ × 3Ñ 3ˆÔ à×&Ñ&Ô(Ø × Ñ ×!4Ñ!4Ô 5á �F×(Ñ(Ó*Ð2Ø × Ñ §¡Ô ,àˆŒ
|
|||
|
|
؈
|
|||
|
|
r( c óB — t |« sd|vr t d« ‚d|v r(t |« r t d« ‚|j d« f}t |« dk7 r t j ddt |« « ‚t |d t « r/|\ }|j }|j d¬« | urct d « ‚|\ }t j |« j « st d
|
|||
|
|
|› �« ‚ | j d i |¤Ž\ }} || |fi |¤Ž}||f}| j ||« S ) ad
|
|||
|
|
Add an `~.axes.Axes` to the figure.
|
|||
|
|
|
|||
|
|
Call signatures::
|
|||
|
|
|
|||
|
|
add_axes(rect, projection=None, polar=False, **kwargs)
|
|||
|
|
add_axes(ax)
|
|||
|
|
|
|||
|
|
Parameters
|
|||
|
|
----------
|
|||
|
|
rect : tuple (left, bottom, width, height)
|
|||
|
|
The dimensions (left, bottom, width, height) of the new
|
|||
|
|
`~.axes.Axes`. All quantities are in fractions of figure width and
|
|||
|
|
height.
|
|||
|
|
|
|||
|
|
projection : {None, 'aitoff', 'hammer', 'lambert', 'mollweide', 'polar', 'rectilinear', str}, optional
|
|||
|
|
The projection type of the `~.axes.Axes`. *str* is the name of
|
|||
|
|
a custom projection, see `~matplotlib.projections`. The default
|
|||
|
|
None results in a 'rectilinear' projection.
|
|||
|
|
|
|||
|
|
polar : bool, default: False
|
|||
|
|
If True, equivalent to projection='polar'.
|
|||
|
|
|
|||
|
|
axes_class : subclass type of `~.axes.Axes`, optional
|
|||
|
|
The `.axes.Axes` subclass that is instantiated. This parameter
|
|||
|
|
is incompatible with *projection* and *polar*. See
|
|||
|
|
:ref:`axisartist_users-guide-index` for examples.
|
|||
|
|
|
|||
|
|
sharex, sharey : `~matplotlib.axes.Axes`, optional
|
|||
|
|
Share the x or y `~matplotlib.axis` with sharex and/or sharey.
|
|||
|
|
The axis will have the same limits, ticks, and scale as the axis
|
|||
|
|
of the shared Axes.
|
|||
|
|
|
|||
|
|
label : str
|
|||
|
|
A label for the returned Axes.
|
|||
|
|
|
|||
|
|
Returns
|
|||
|
|
-------
|
|||
|
|
`~.axes.Axes`, or a subclass of `~.axes.Axes`
|
|||
|
|
The returned Axes class depends on the projection used. It is
|
|||
|
|
`~.axes.Axes` if rectilinear projection is used and
|
|||
|
|
`.projections.polar.PolarAxes` if polar projection is used.
|
|||
|
|
|
|||
|
|
Other Parameters
|
|||
|
|
----------------
|
|||
|
|
**kwargs
|
|||
|
|
This method also takes the keyword arguments for
|
|||
|
|
the returned Axes class. The keyword arguments for the
|
|||
|
|
rectilinear Axes class `~.axes.Axes` can be found in
|
|||
|
|
the following table but there might also be other keyword
|
|||
|
|
arguments if another projection is used, see the actual Axes
|
|||
|
|
class.
|
|||
|
|
|
|||
|
|
%(Axes:kwdoc)s
|
|||
|
|
|
|||
|
|
Notes
|
|||
|
|
-----
|
|||
|
|
In rare circumstances, `.add_axes` may be called with a single
|
|||
|
|
argument, an Axes instance already created in the present figure but
|
|||
|
|
not in the figure's list of Axes.
|
|||
|
|
|
|||
|
|
See Also
|
|||
|
|
--------
|
|||
|
|
.Figure.add_subplot
|
|||
|
|
.pyplot.subplot
|
|||
|
|
.pyplot.axes
|
|||
|
|
.Figure.subplots
|
|||
|
|
.pyplot.subplots
|
|||
|
|
|
|||
|
|
Examples
|
|||
|
|
--------
|
|||
|
|
Some simple examples::
|
|||
|
|
|
|||
|
|
rect = l, b, w, h
|
|||
|
|
fig = plt.figure()
|
|||
|
|
fig.add_axes(rect)
|
|||
|
|
fig.add_axes(rect, frameon=False, facecolor='g')
|
|||
|
|
fig.add_axes(rect, polar=True)
|
|||
|
|
ax = fig.add_axes(rect, projection='polar')
|
|||
|
|
fig.delaxes(ax)
|
|||
|
|
fig.add_axes(ax)
|
|||
|
|
Úrectz9add_axes() missing 1 required positional argument: 'rect'z2add_axes() got multiple values for argument 'rect'rˆ Úadd_axesr Fr ú5The Axes must have been created in the present figurez'all entries in rect must be finite not rS )r� Ú TypeErrorr6 r‹ Ú nargs_errorÚ
|
|||
|
|
isinstancer Ú_projection_initr! r; ÚnpÚisfiniter� Ú _process_projection_requirementsÚ_add_axes_internal)r# Úargsrk r8 rA r Úprojection_classÚpkws r& r zFigureBase.add_axes s0 € ôl �4Œy˜V¨6Ñ 1ÜÐ WÓXÐ XØ
|
|||
|
|
�vÑ
|
|||
|
|
Ü�4ŒyÜ Ð TÓUÐUØ—J‘J˜vÓ&Ð)ˆDÜ ˆt‹9˜Š>Ü×"Ñ" :¨q´#°d³)Ó<Ð <ä �d˜1‘gœtÔ $؉BˆAØ×$Ñ$ˆCØ�|‰| ˆ|Ó'¨tÑ3Ü ØKóMð Mð ‰EˆDÜ—;‘;˜tÓ$×(Ñ(Ô*Ü Ð#JÈ4È&Ð!QÓRÐRØ$I D×$IÑ$IÑ$SÈFÑ$SÑ !Ð ˜cñ ! tÑ3¨sÑ3ˆAØ# SÐ)ˆCà×&Ñ& q¨#Ó.Ð.r( c ó^ — d|v rt j dd« ‚t |« dk( rtt |d t j
|
|||
|
|
j j « rC|d j « r0|d }|j }|j d¬« | ur‹t d« ‚|sd}t |« dk( rIt |d t « r6d |d cxk rd
|
|||
|
|
k r(n n%t t t t! |d « « « } | j" d i |¤Ž\ }} || g|¢i |¤Ž}||f}| j% ||« S ) aw
|
|||
|
|
Add an `~.axes.Axes` to the figure as part of a subplot arrangement.
|
|||
|
|
|
|||
|
|
Call signatures::
|
|||
|
|
|
|||
|
|
add_subplot(nrows, ncols, index, **kwargs)
|
|||
|
|
add_subplot(pos, **kwargs)
|
|||
|
|
add_subplot(ax)
|
|||
|
|
add_subplot()
|
|||
|
|
|
|||
|
|
Parameters
|
|||
|
|
----------
|
|||
|
|
*args : int, (int, int, *index*), or `.SubplotSpec`, default: (1, 1, 1)
|
|||
|
|
The position of the subplot described by one of
|
|||
|
|
|
|||
|
|
- Three integers (*nrows*, *ncols*, *index*). The subplot will
|
|||
|
|
take the *index* position on a grid with *nrows* rows and
|
|||
|
|
*ncols* columns. *index* starts at 1 in the upper left corner
|
|||
|
|
and increases to the right. *index* can also be a two-tuple
|
|||
|
|
specifying the (*first*, *last*) indices (1-based, and including
|
|||
|
|
*last*) of the subplot, e.g., ``fig.add_subplot(3, 1, (1, 2))``
|
|||
|
|
makes a subplot that spans the upper 2/3 of the figure.
|
|||
|
|
- A 3-digit integer. The digits are interpreted as if given
|
|||
|
|
separately as three single-digit integers, i.e.
|
|||
|
|
``fig.add_subplot(235)`` is the same as
|
|||
|
|
``fig.add_subplot(2, 3, 5)``. Note that this can only be used
|
|||
|
|
if there are no more than 9 subplots.
|
|||
|
|
- A `.SubplotSpec`.
|
|||
|
|
|
|||
|
|
In rare circumstances, `.add_subplot` may be called with a single
|
|||
|
|
argument, a subplot Axes instance already created in the
|
|||
|
|
present figure but not in the figure's list of Axes.
|
|||
|
|
|
|||
|
|
projection : {None, 'aitoff', 'hammer', 'lambert', 'mollweide', 'polar', 'rectilinear', str}, optional
|
|||
|
|
The projection type of the subplot (`~.axes.Axes`). *str* is the
|
|||
|
|
name of a custom projection, see `~matplotlib.projections`. The
|
|||
|
|
default None results in a 'rectilinear' projection.
|
|||
|
|
|
|||
|
|
polar : bool, default: False
|
|||
|
|
If True, equivalent to projection='polar'.
|
|||
|
|
|
|||
|
|
axes_class : subclass type of `~.axes.Axes`, optional
|
|||
|
|
The `.axes.Axes` subclass that is instantiated. This parameter
|
|||
|
|
is incompatible with *projection* and *polar*. See
|
|||
|
|
:ref:`axisartist_users-guide-index` for examples.
|
|||
|
|
|
|||
|
|
sharex, sharey : `~matplotlib.axes.Axes`, optional
|
|||
|
|
Share the x or y `~matplotlib.axis` with sharex and/or sharey.
|
|||
|
|
The axis will have the same limits, ticks, and scale as the axis
|
|||
|
|
of the shared Axes.
|
|||
|
|
|
|||
|
|
label : str
|
|||
|
|
A label for the returned Axes.
|
|||
|
|
|
|||
|
|
Returns
|
|||
|
|
-------
|
|||
|
|
`~.axes.Axes`
|
|||
|
|
|
|||
|
|
The Axes of the subplot. The returned Axes can actually be an
|
|||
|
|
instance of a subclass, such as `.projections.polar.PolarAxes` for
|
|||
|
|
polar projections.
|
|||
|
|
|
|||
|
|
Other Parameters
|
|||
|
|
----------------
|
|||
|
|
**kwargs
|
|||
|
|
This method also takes the keyword arguments for the returned Axes
|
|||
|
|
base class; except for the *figure* argument. The keyword arguments
|
|||
|
|
for the rectilinear base class `~.axes.Axes` can be found in
|
|||
|
|
the following table but there might also be other keyword
|
|||
|
|
arguments if another projection is used.
|
|||
|
|
|
|||
|
|
%(Axes:kwdoc)s
|
|||
|
|
|
|||
|
|
See Also
|
|||
|
|
--------
|
|||
|
|
.Figure.add_axes
|
|||
|
|
.pyplot.subplot
|
|||
|
|
.pyplot.axes
|
|||
|
|
.Figure.subplots
|
|||
|
|
.pyplot.subplots
|
|||
|
|
|
|||
|
|
Examples
|
|||
|
|
--------
|
|||
|
|
::
|
|||
|
|
|
|||
|
|
fig = plt.figure()
|
|||
|
|
|
|||
|
|
fig.add_subplot(231)
|
|||
|
|
ax1 = fig.add_subplot(2, 3, 1) # equivalent but more general
|
|||
|
|
|
|||
|
|
fig.add_subplot(232, frameon=False) # subplot with no frame
|
|||
|
|
fig.add_subplot(233, projection='polar') # polar subplot
|
|||
|
|
fig.add_subplot(234, sharex=ax1) # subplot sharing x-axis with ax1
|
|||
|
|
fig.add_subplot(235, facecolor="red") # red subplot
|
|||
|
|
|
|||
|
|
ax1.remove() # delete ax1 from the figure
|
|||
|
|
fig.add_subplot(ax1) # add ax1 back to the figure
|
|||
|
|
ÚfigureÚ add_subplotrˆ r Fr r )rˆ rˆ rˆ éd iç rS )r‹ Ú kwarg_errorr� r rÅ r� Ú_baseÚ _AxesBaser‡ r r! r; r ÚtupleÚmapÚintÚstrr! r" )r# r# rk r} rA r$ r% s r& r( zFigureBase.add_subplot‹ s, € ðJ �vÑ ô ×"Ñ" =°(Ó;Ð ;ä �‹I˜ŠNÜ ˜t A™w¬¯©¯©×(@Ñ(@ÔAؘ‘G×+Ñ+Ô-Ø�a‘ˆBØ×%Ñ%ˆCØ�}‰} %ˆ}Ó(°Ñ4Ü ð "6ó 7ð 7ñ Ø �ô �D“ ˜Q’¤:¨d°1©g´xÔ#@ؘt A™wÔ-¨#Õ-Ü œS¤¤c¨$¨q©'£lÓ 3Ó4�Ø$I D×$IÑ$IÑ$SÈFÑ$SÑ !Ð ˜cÙ! $Ð5¨Ò5°Ñ5ˆBØ# SÐ)ˆCØ×&Ñ& r¨3Ó/Ð/r( c ó — | j j |« || j vr| j j |« | j |« | j
|
|||
|
|
|_ ||_ d| _ t |_
|
|||
|
|
|S )z0Private helper for `add_axes` and `add_subplot`.T) Ú_axstackr? ra r ÚscaÚdelaxesrÏ r r" r' Ústale_callback)r# r} rA s r& r" z FigureBase._add_axes_internal se € à �
|
|||
|
|
‰
|
|||
|
|
×ј"Ô Ø
|
|||
|
|
�T—_‘_Ñ $Ø �O‰O× "Ñ " 2Ô &Ø �‰�Œ Ø ŸL™LˆÔà !ˆÔ؈Œ
|
|||
|
|
Ü 2ˆÔ؈ r( )ÚsharexÚshareyÚsqueezeÚ width_ratiosÚ
|
|||
|
|
height_ratiosÚ
|
|||
|
|
subplot_kwÚ gridspec_kwc óÒ — t | xs i « } |�d| v r t d« ‚|| d< |�d| v r t d« ‚|| d< | j ||fd| i| ¤Ž}
|
|||
|
|
|
|
|||
|
|
j ||||¬« } | S )ab
|
|||
|
|
Add a set of subplots to this figure.
|
|||
|
|
|
|||
|
|
This utility wrapper makes it convenient to create common layouts of
|
|||
|
|
subplots in a single call.
|
|||
|
|
|
|||
|
|
Parameters
|
|||
|
|
----------
|
|||
|
|
nrows, ncols : int, default: 1
|
|||
|
|
Number of rows/columns of the subplot grid.
|
|||
|
|
|
|||
|
|
sharex, sharey : bool or {'none', 'all', 'row', 'col'}, default: False
|
|||
|
|
Controls sharing of x-axis (*sharex*) or y-axis (*sharey*):
|
|||
|
|
|
|||
|
|
- True or 'all': x- or y-axis will be shared among all subplots.
|
|||
|
|
- False or 'none': each subplot x- or y-axis will be independent.
|
|||
|
|
- 'row': each subplot row will share an x- or y-axis.
|
|||
|
|
- 'col': each subplot column will share an x- or y-axis.
|
|||
|
|
|
|||
|
|
When subplots have a shared x-axis along a column, only the x tick
|
|||
|
|
labels of the bottom subplot are created. Similarly, when subplots
|
|||
|
|
have a shared y-axis along a row, only the y tick labels of the
|
|||
|
|
first column subplot are created. To later turn other subplots'
|
|||
|
|
ticklabels on, use `~matplotlib.axes.Axes.tick_params`.
|
|||
|
|
|
|||
|
|
When subplots have a shared axis that has units, calling
|
|||
|
|
`.Axis.set_units` will update each axis with the new units.
|
|||
|
|
|
|||
|
|
Note that it is not possible to unshare axes.
|
|||
|
|
|
|||
|
|
squeeze : bool, default: True
|
|||
|
|
- If True, extra dimensions are squeezed out from the returned
|
|||
|
|
array of Axes:
|
|||
|
|
|
|||
|
|
- if only one subplot is constructed (nrows=ncols=1), the
|
|||
|
|
resulting single Axes object is returned as a scalar.
|
|||
|
|
- for Nx1 or 1xM subplots, the returned object is a 1D numpy
|
|||
|
|
object array of Axes objects.
|
|||
|
|
- for NxM, subplots with N>1 and M>1 are returned as a 2D array.
|
|||
|
|
|
|||
|
|
- If False, no squeezing at all is done: the returned Axes object
|
|||
|
|
is always a 2D array containing Axes instances, even if it ends
|
|||
|
|
up being 1x1.
|
|||
|
|
|
|||
|
|
width_ratios : array-like of length *ncols*, optional
|
|||
|
|
Defines the relative widths of the columns. Each column gets a
|
|||
|
|
relative width of ``width_ratios[i] / sum(width_ratios)``.
|
|||
|
|
If not given, all columns will have the same width. Equivalent
|
|||
|
|
to ``gridspec_kw={'width_ratios': [...]}``.
|
|||
|
|
|
|||
|
|
height_ratios : array-like of length *nrows*, optional
|
|||
|
|
Defines the relative heights of the rows. Each row gets a
|
|||
|
|
relative height of ``height_ratios[i] / sum(height_ratios)``.
|
|||
|
|
If not given, all rows will have the same height. Equivalent
|
|||
|
|
to ``gridspec_kw={'height_ratios': [...]}``.
|
|||
|
|
|
|||
|
|
subplot_kw : dict, optional
|
|||
|
|
Dict with keywords passed to the `.Figure.add_subplot` call used to
|
|||
|
|
create each subplot.
|
|||
|
|
|
|||
|
|
gridspec_kw : dict, optional
|
|||
|
|
Dict with keywords passed to the
|
|||
|
|
`~matplotlib.gridspec.GridSpec` constructor used to create
|
|||
|
|
the grid the subplots are placed on.
|
|||
|
|
|
|||
|
|
Returns
|
|||
|
|
-------
|
|||
|
|
`~.axes.Axes` or array of Axes
|
|||
|
|
Either a single `~matplotlib.axes.Axes` object or an array of Axes
|
|||
|
|
objects if more than one subplot was created. The dimensions of the
|
|||
|
|
resulting array can be controlled with the *squeeze* keyword, see
|
|||
|
|
above.
|
|||
|
|
|
|||
|
|
See Also
|
|||
|
|
--------
|
|||
|
|
.pyplot.subplots
|
|||
|
|
.Figure.add_subplot
|
|||
|
|
.pyplot.subplot
|
|||
|
|
|
|||
|
|
Examples
|
|||
|
|
--------
|
|||
|
|
::
|
|||
|
|
|
|||
|
|
# First create some toy data:
|
|||
|
|
x = np.linspace(0, 2*np.pi, 400)
|
|||
|
|
y = np.sin(x**2)
|
|||
|
|
|
|||
|
|
# Create a figure
|
|||
|
|
fig = plt.figure()
|
|||
|
|
|
|||
|
|
# Create a subplot
|
|||
|
|
ax = fig.subplots()
|
|||
|
|
ax.plot(x, y)
|
|||
|
|
ax.set_title('Simple plot')
|
|||
|
|
|
|||
|
|
# Create two subplots and unpack the output array immediately
|
|||
|
|
ax1, ax2 = fig.subplots(1, 2, sharey=True)
|
|||
|
|
ax1.plot(x, y)
|
|||
|
|
ax1.set_title('Sharing Y axis')
|
|||
|
|
ax2.scatter(x, y)
|
|||
|
|
|
|||
|
|
# Create four polar Axes and access them through the returned array
|
|||
|
|
axes = fig.subplots(2, 2, subplot_kw=dict(projection='polar'))
|
|||
|
|
axes[0, 0].plot(x, y)
|
|||
|
|
axes[1, 1].scatter(x, y)
|
|||
|
|
|
|||
|
|
# Share an X-axis with each column of subplots
|
|||
|
|
fig.subplots(2, 2, sharex='col')
|
|||
|
|
|
|||
|
|
# Share a Y-axis with each row of subplots
|
|||
|
|
fig.subplots(2, 2, sharey='row')
|
|||
|
|
|
|||
|
|
# Share both X- and Y-axes with all subplots
|
|||
|
|
fig.subplots(2, 2, sharex='all', sharey='all')
|
|||
|
|
|
|||
|
|
# Note that this is the same as
|
|||
|
|
fig.subplots(2, 2, sharex=True, sharey=True)
|
|||
|
|
r: úQ'height_ratios' must not be defined both as parameter and as key in 'gridspec_kw'r9 úP'width_ratios' must not be defined both as parameter and as key in 'gridspec_kw'r' )r6 r7 r8 r; )Údictr; Ú add_gridspecÚsubplots) r# ÚnrowsÚncolsr6 r7 r8 r9 r: r; r< ÚgsÚaxss r& rB zFigureBase.subplots s € ôr ˜;Ò,¨"Ó-ˆ Ø Ð $Ø +Ñ-Ü ð "Ió Jð Jà+8ˆK˜Ñ (Ø Ð #Ø Ñ,Ü ð "Ió Jð Jà*6ˆK˜Ñ 'à
|
|||
|
|
ˆT×
|
|||
|
|
Ñ
|
|||
|
|
˜u eÑ
|
|||
|
|
H°DÐ
|
|||
|
|
H¸KÑ
|
|||
|
|
HˆØ�k‰k °ÀØ%/ð ó 1ˆàˆ
|
|||
|
|
r( c óV — | j || j | j g¬« y)zY
|
|||
|
|
Remove the `~.axes.Axes` *ax* from the figure; update the current Axes.
|
|||
|
|
)ÚownersN)Ú _remove_axesr2 ra ©r# r} s r& r4 zFigureBase.delaxes¢ s$ € ð
|
|||
|
|
×ј" d§m¡m°T·_±_Ð%EÐÕFr( c óÎ — |D ] }|j |« Œ | j j d| « d| _ | j j
|
|||
|
|
j
|
|||
|
|
|« |j D ]Ö }|j | }|j |« D �cg c] }||usŒ|‘Œ }}|sŒ8|j |« |d j | }|j « j |« |j « j |« |j « j |« |j « j |« ŒØ |j j |« yc c}w )aD
|
|||
|
|
Common helper for removal of standard Axes (via delaxes) and of child Axes.
|
|||
|
|
|
|||
|
|
Parameters
|
|||
|
|
----------
|
|||
|
|
ax : `~.AxesBase`
|
|||
|
|
The Axes to remove.
|
|||
|
|
owners
|
|||
|
|
List of objects (list or _AxesStack) "owning" the Axes, from which the Axes
|
|||
|
|
will be remove()d.
|
|||
|
|
Ú_axes_change_eventTr N)r9 Ú _axobserversÚprocessr" r¥ ÚcanvasÚ
|
|||
|
|
release_mouseÚ _axis_namesÚ _shared_axesÚ get_siblingsÚ _axis_mapÚget_major_formatterÚset_axisÚget_major_locatorÚget_minor_formatterÚget_minor_locatorÚ
|
|||
|
|
_twinned_axes) r# r} rH Úownerr¸ ÚgrouperÚotherÚsiblingsÚremaining_axiss r& rI zFigureBase._remove_axes¨ sA € ð ò ˆEØ �L‰L˜Õ ð ð
|
|||
|
|
×Ñ×!Ñ!Ð"6¸Ô=؈Œ
|
|||
|
|
Ø ×Ñ× Ñ ×.Ñ.¨rÔ2à—N‘Nò
|
|||
|
|
HˆDØ—o‘o dÑ+ˆGØ+2×+?Ñ+?ÀÓ+CÖW %ÀuÐTVšÐWˆHÐWÙØØ �N‰N˜2Ô ð & a™[× 2Ñ 2°4Ñ 8ˆNØ × .Ñ .Ó 0× 9Ñ 9¸.Ô IØ × ,Ñ ,Ó .× 7Ñ 7¸Ô GØ × .Ñ .Ó 0× 9Ñ 9¸.Ô IØ × ,Ñ ,Ó .× 7Ñ 7¸Õ Gð
|
|||
|
|
Hð ×Ñ× Ñ Õ#ùò Xs  E" E"c óž — d| _ | j D ] }|j |¬« Œ g | _ t | j « D ]# }|j « | j |« Œ% g | _ g | _ g | _ g | _ g | _
|
|||
|
|
g | _ |st j « | _ d| _ d| _ d| _ d| _ y)zï
|
|||
|
|
Clear the figure.
|
|||
|
|
|
|||
|
|
Parameters
|
|||
|
|
----------
|
|||
|
|
keep_observers : bool, default: False
|
|||
|
|
Set *keep_observers* to True if, for example,
|
|||
|
|
a gui widget is tracking the Axes in the figure.
|
|||
|
|
N©Úkeep_observersT)ri rh Úclearr- r� r4 rb rc rd re rf rg r^ ÚCallbackRegistryrM r[ r\ r] r" )r# rb Úsubfigr} s r& rc zFigureBase.clearÌ s¿ € ð "&ˆÔ ð —l‘lò 8ˆFØ �L‰L¨ˆLÕ 7ð 8àˆŒ 䘟 ™ Ó"ò ˆBØ �H‰HŒJØ �L‰L˜Õ ð 𠈌 ؈Œ
|
|||
|
|
؈Œ ؈Œ
|
|||
|
|
؈Œ ؈Œ Ù Ü %× 6Ñ 6Ó 8ˆDÔ Ø ˆŒØ ˆŒØ ˆŒàˆ�
|
|||
|
|
r( c ó& — | j |¬« S )a}
|
|||
|
|
[*Discouraged*] Alias for the `clear()` method.
|
|||
|
|
|
|||
|
|
.. admonition:: Discouraged
|
|||
|
|
|
|||
|
|
The use of ``clf()`` is discouraged. Use ``clear()`` instead.
|
|||
|
|
|
|||
|
|
Parameters
|
|||
|
|
----------
|
|||
|
|
keep_observers : bool, default: False
|
|||
|
|
Set *keep_observers* to True if, for example,
|
|||
|
|
a gui widget is tracking the Axes in the figure.
|
|||
|
|
ra )rc )r# rb s r& ÚclfzFigureBase.clfð s € ð �z‰z¨ ˆzÓ8Ð8r( c ó6 — t j | j g|¢i |¤Ž\ }}}|j d| j « t j
|
|||
|
|
| ||fi |¤Ž}| j j |« | j j |_ d| _
|
|||
|
|
|S )a4
|
|||
|
|
Place a legend on the figure.
|
|||
|
|
|
|||
|
|
Call signatures::
|
|||
|
|
|
|||
|
|
legend()
|
|||
|
|
legend(handles, labels)
|
|||
|
|
legend(handles=handles)
|
|||
|
|
legend(labels)
|
|||
|
|
|
|||
|
|
The call signatures correspond to the following different ways to use
|
|||
|
|
this method:
|
|||
|
|
|
|||
|
|
**1. Automatic detection of elements to be shown in the legend**
|
|||
|
|
|
|||
|
|
The elements to be added to the legend are automatically determined,
|
|||
|
|
when you do not pass in any extra arguments.
|
|||
|
|
|
|||
|
|
In this case, the labels are taken from the artist. You can specify
|
|||
|
|
them either at artist creation or by calling the
|
|||
|
|
:meth:`~.Artist.set_label` method on the artist::
|
|||
|
|
|
|||
|
|
ax.plot([1, 2, 3], label='Inline label')
|
|||
|
|
fig.legend()
|
|||
|
|
|
|||
|
|
or::
|
|||
|
|
|
|||
|
|
line, = ax.plot([1, 2, 3])
|
|||
|
|
line.set_label('Label via method')
|
|||
|
|
fig.legend()
|
|||
|
|
|
|||
|
|
Specific lines can be excluded from the automatic legend element
|
|||
|
|
selection by defining a label starting with an underscore.
|
|||
|
|
This is default for all artists, so calling `.Figure.legend` without
|
|||
|
|
any arguments and without setting the labels manually will result in
|
|||
|
|
no legend being drawn.
|
|||
|
|
|
|||
|
|
|
|||
|
|
**2. Explicitly listing the artists and labels in the legend**
|
|||
|
|
|
|||
|
|
For full control of which artists have a legend entry, it is possible
|
|||
|
|
to pass an iterable of legend artists followed by an iterable of
|
|||
|
|
legend labels respectively::
|
|||
|
|
|
|||
|
|
fig.legend([line1, line2, line3], ['label1', 'label2', 'label3'])
|
|||
|
|
|
|||
|
|
|
|||
|
|
**3. Explicitly listing the artists in the legend**
|
|||
|
|
|
|||
|
|
This is similar to 2, but the labels are taken from the artists'
|
|||
|
|
label properties. Example::
|
|||
|
|
|
|||
|
|
line1, = ax1.plot([1, 2, 3], label='label1')
|
|||
|
|
line2, = ax2.plot([1, 2, 3], label='label2')
|
|||
|
|
fig.legend(handles=[line1, line2])
|
|||
|
|
|
|||
|
|
|
|||
|
|
**4. Labeling existing plot elements**
|
|||
|
|
|
|||
|
|
.. admonition:: Discouraged
|
|||
|
|
|
|||
|
|
This call signature is discouraged, because the relation between
|
|||
|
|
plot elements and labels is only implicit by their order and can
|
|||
|
|
easily be mixed up.
|
|||
|
|
|
|||
|
|
To make a legend for all artists on all Axes, call this function with
|
|||
|
|
an iterable of strings, one for each legend item. For example::
|
|||
|
|
|
|||
|
|
fig, (ax1, ax2) = plt.subplots(1, 2)
|
|||
|
|
ax1.plot([1, 3, 5], color='blue')
|
|||
|
|
ax2.plot([2, 4, 6], color='red')
|
|||
|
|
fig.legend(['the blues', 'the reds'])
|
|||
|
|
|
|||
|
|
|
|||
|
|
Parameters
|
|||
|
|
----------
|
|||
|
|
handles : list of `.Artist`, optional
|
|||
|
|
A list of Artists (lines, patches) to be added to the legend.
|
|||
|
|
Use this together with *labels*, if you need full control on what
|
|||
|
|
is shown in the legend and the automatic mechanism described above
|
|||
|
|
is not sufficient.
|
|||
|
|
|
|||
|
|
The length of handles and labels should be the same in this
|
|||
|
|
case. If they are not, they are truncated to the smaller length.
|
|||
|
|
|
|||
|
|
labels : list of str, optional
|
|||
|
|
A list of labels to show next to the artists.
|
|||
|
|
Use this together with *handles*, if you need full control on what
|
|||
|
|
is shown in the legend and the automatic mechanism described above
|
|||
|
|
is not sufficient.
|
|||
|
|
|
|||
|
|
Returns
|
|||
|
|
-------
|
|||
|
|
`~matplotlib.legend.Legend`
|
|||
|
|
|
|||
|
|
Other Parameters
|
|||
|
|
----------------
|
|||
|
|
%(_legend_kw_figure)s
|
|||
|
|
|
|||
|
|
See Also
|
|||
|
|
--------
|
|||
|
|
.Axes.legend
|
|||
|
|
|
|||
|
|
Notes
|
|||
|
|
-----
|
|||
|
|
Some artists are not supported by this function. See
|
|||
|
|
:ref:`legend_guide` for details.
|
|||
|
|
Úbbox_transformT) ÚmlegendÚ_parse_legend_argsr� rÄ r ÚLegendrg r r9 rÏ r" )r# r# rk ÚhandlesÚlabelsÚls r& ÚlegendzFigureBase.legend s‰ € ô^ #*×"<Ñ"<¸T¿Y¹YÐ"XÈÒ"XÐQWÑ"XÑ ˆ�˜à×ÑÐ*¨D×,?Ñ,?Ô@Ü �N‰N˜4 ¨&Ñ ;°FÑ ;ˆØ � ‰ ×јAÔ Ø Ÿ<™<×.Ñ.ˆÔ؈Œ
|
|||
|
|
؈r( c ó — d| j i|�|ni ¥|¥}t d|||dœ|¤Ž}|j | « t |_ | j
|
|||
|
|
j
|
|||
|
|
|« | j
|
|||
|
|
j |_ d| _ |S )a—
|
|||
|
|
Add text to figure.
|
|||
|
|
|
|||
|
|
Parameters
|
|||
|
|
----------
|
|||
|
|
x, y : float
|
|||
|
|
The position to place the text. By default, this is in figure
|
|||
|
|
coordinates, floats in [0, 1]. The coordinate system can be changed
|
|||
|
|
using the *transform* keyword.
|
|||
|
|
|
|||
|
|
s : str
|
|||
|
|
The text string.
|
|||
|
|
|
|||
|
|
fontdict : dict, optional
|
|||
|
|
A dictionary to override the default text properties. If not given,
|
|||
|
|
the defaults are determined by :rc:`font.*`. Properties passed as
|
|||
|
|
*kwargs* override the corresponding ones given in *fontdict*.
|
|||
|
|
|
|||
|
|
Returns
|
|||
|
|
-------
|
|||
|
|
`~.text.Text`
|
|||
|
|
|
|||
|
|
Other Parameters
|
|||
|
|
----------------
|
|||
|
|
**kwargs : `~matplotlib.text.Text` properties
|
|||
|
|
Other miscellaneous text parameters.
|
|||
|
|
|
|||
|
|
%(Text:kwdoc)s
|
|||
|
|
|
|||
|
|
See Also
|
|||
|
|
--------
|
|||
|
|
.Axes.text
|
|||
|
|
.pyplot.text
|
|||
|
|
Ú transform)rW rX rÊ TrS )
|
|||
|
|
r r rª r' r5 re r r9 rÏ r" )r# rW rX ÚsÚfontdictrk Úeffective_kwargsrÊ s r& rÊ zFigureBase.text~ sŽ € ðJ
|
|||
|
|
˜×,Ñ,ð
|
|||
|
|
à#Ð/‰x°Rð
|
|||
|
|
ð ð
|
|||
|
|
Ðô
|
|||
|
|
Ð9�a˜1 1Ñ9Ð(8Ñ9ˆØ �‰˜Ô Ü 4ˆÔà �
|
|||
|
|
‰
|
|||
|
|
×ј$Ô Ø "Ÿj™j× /Ñ /ˆÔ؈Œ
|
|||
|
|
؈ r( c
|
|||
|
|
ó$ — |€
|
|||
|
|
t |dd« }|�€8|€ t d« ‚t |t j « rg |j
|
|||
|
|
¢nt j |« rg |¢n|gd j d¬« }|j « }|j « � |j « j sd}|rXt |t j j j « r*|j « rt! j" |fi |¤Ž\ }}nt! j$ |fi |¤Ž\ }}|j' |« |j) ddd¬« t+ |d « rZ|j d
|
|||
|
|
¬« x}�F|| j, ur8t/ j0 d t3 |« › d t3 | j, « › d
|
|||
|
|
�« g d¢} t! j4 ||fi |j7 « D �
|
|||
|
|
� ci c]
|
|||
|
|
\ }
|
|||
|
|
} |
|
|||
|
|
| vsΠ|
|
|||
|
|
| “Œ c} }
|
|||
|
|
¤Ž} d
|
|||
|
|
|j d¬« _ | S c c} }
|
|||
|
|
w )aP
|
|||
|
|
Add a colorbar to a plot.
|
|||
|
|
|
|||
|
|
Parameters
|
|||
|
|
----------
|
|||
|
|
mappable
|
|||
|
|
The `matplotlib.cm.ScalarMappable` (i.e., `.AxesImage`,
|
|||
|
|
`.ContourSet`, etc.) described by this colorbar. This argument is
|
|||
|
|
mandatory for the `.Figure.colorbar` method but optional for the
|
|||
|
|
`.pyplot.colorbar` function, which sets the default to the current
|
|||
|
|
image.
|
|||
|
|
|
|||
|
|
Note that one can create a `.ScalarMappable` "on-the-fly" to
|
|||
|
|
generate colorbars not attached to a previously drawn artist, e.g.
|
|||
|
|
::
|
|||
|
|
|
|||
|
|
fig.colorbar(cm.ScalarMappable(norm=norm, cmap=cmap), ax=ax)
|
|||
|
|
|
|||
|
|
cax : `~matplotlib.axes.Axes`, optional
|
|||
|
|
Axes into which the colorbar will be drawn. If `None`, then a new
|
|||
|
|
Axes is created and the space for it will be stolen from the Axes(s)
|
|||
|
|
specified in *ax*.
|
|||
|
|
|
|||
|
|
ax : `~matplotlib.axes.Axes` or iterable or `numpy.ndarray` of Axes, optional
|
|||
|
|
The one or more parent Axes from which space for a new colorbar Axes
|
|||
|
|
will be stolen. This parameter is only used if *cax* is not set.
|
|||
|
|
|
|||
|
|
Defaults to the Axes that contains the mappable used to create the
|
|||
|
|
colorbar.
|
|||
|
|
|
|||
|
|
use_gridspec : bool, optional
|
|||
|
|
If *cax* is ``None``, a new *cax* is created as an instance of
|
|||
|
|
Axes. If *ax* is positioned with a subplotspec and *use_gridspec*
|
|||
|
|
is ``True``, then *cax* is also positioned with a subplotspec.
|
|||
|
|
|
|||
|
|
Returns
|
|||
|
|
-------
|
|||
|
|
colorbar : `~matplotlib.colorbar.Colorbar`
|
|||
|
|
|
|||
|
|
Other Parameters
|
|||
|
|
----------------
|
|||
|
|
%(_make_axes_kw_doc)s
|
|||
|
|
%(_colormap_kw_doc)s
|
|||
|
|
|
|||
|
|
Notes
|
|||
|
|
-----
|
|||
|
|
If *mappable* is a `~.contour.ContourSet`, its *extend* kwarg is
|
|||
|
|
included automatically.
|
|||
|
|
|
|||
|
|
The *shrink* kwarg provides a simple way to scale the colorbar with
|
|||
|
|
respect to the Axes. Note that if *cax* is specified, it determines the
|
|||
|
|
size of the colorbar, and *shrink* and *aspect* are ignored.
|
|||
|
|
|
|||
|
|
For more precise control, you can manually specify the positions of the
|
|||
|
|
axes objects in which the mappable and the colorbar are drawn. In this
|
|||
|
|
case, do not use any of the Axes properties kwargs.
|
|||
|
|
|
|||
|
|
It is known that some vector graphics viewers (svg and pdf) render
|
|||
|
|
white gaps between segments of the colorbar. This is due to bugs in
|
|||
|
|
the viewers, not Matplotlib. As a workaround, the colorbar can be
|
|||
|
|
rendered with overlapping segments::
|
|||
|
|
|
|||
|
|
cbar = colorbar()
|
|||
|
|
cbar.solids.set_edgecolor("face")
|
|||
|
|
draw()
|
|||
|
|
|
|||
|
|
However, this has negative consequences in other circumstances, e.g.
|
|||
|
|
with semi-transparent images (alpha < 1) and colorbar extensions;
|
|||
|
|
therefore, this workaround is not used by default (see issue #1188).
|
|||
|
|
|
|||
|
|
Nr� zÌUnable to determine Axes to steal space for Colorbar. Either provide the *cax* argument to use as the Axes for the Colorbar, provide the *ax* argument to steal space from it, or add *mappable* to an Axes.r Fr r„ )Úvisibler… Úaxisr! Tz&Adding colorbar to a different Figure z than z! which fig.colorbar is called on.)ÚfractionÚpadÚshrinkÚaspectrò Úpanchor) rÇ r; r r ÚndarrayÚflatÚiterabler! Úgcar— Úcolorbar_gridspecrÅ r� r+ r, r‡ ÚcbarÚmake_axes_gridspecÚ make_axesr3 Úgridr{ r¥ r‹ Ú
|
|||
|
|
warn_externalÚreprÚColorbarÚitemsr" )
|
|||
|
|
r# ÚmappableÚcaxr} Ú use_gridspecrk r% Ú
|
|||
|
|
current_axÚmappable_host_figÚNON_COLORBAR_KEYSÚkÚvÚcbs
|
|||
|
|
r& ÚcolorbarzFigureBase.colorbar° sý € ðV ˆ:ܘ 6¨4Ó0ˆBà ‰;؈zÜ ð=ó>ð >ô )¨¬R¯Z©ZÔ 8�
|
|||
|
|
�"—'‘'‘
|
|||
|
|
Ü Ÿk™k¨"œo�U�r‘UØ�T˜1ñ ÷ )™j¨e˜jÓ 4ð
|
|||
|
|
ð Ÿ™›ˆJØ×%Ñ%Ó'Ð3Ø×-Ñ-Ó/×AÒAØ $� Ù Ü" 2¤s§x¡x§~¡~×'?Ñ'?Ô@Ø×*Ñ*Ô,Ü "× 5Ñ 5°bÑ C¸FÑ C‘ �‘Vä "Ÿn™n¨RÑ :°6Ñ :‘ ��Và �G‰G�JÔ Ø �H‰H˜U¨&°vˆHÔ >ä �H˜lÔ +Ø&.×&9Ñ&9¸tÐ&9Ó&DÐDÐ"ÐQà ¨×(9Ñ(9Ñ9Ü×"Ñ"Ø@Ü Ð 1Ó2Ð3°6Ü × 1Ñ 1Ó2Ð3ð 45ð6ô7ò HÐä
|
|||
|
|
�]‰]˜3 ñ LØ #Ÿ\™\›^÷-KÙ�Q˜¨qÐ8IÒ/IˆAˆq‰Dó-Kñ Lˆà+/ˆ�‰˜EˆÓ"Ô(؈ ùó-Ks Ç H Ç(H c ór — | j « �0| j « j st j d« y| j j ||||||« | j D ]A }|j « €Œ|j |j « j | « « ŒC d| _
|
|||
|
|
y)aQ
|
|||
|
|
Adjust the subplot layout parameters.
|
|||
|
|
|
|||
|
|
Unset parameters are left unmodified; initial values are given by
|
|||
|
|
:rc:`figure.subplot.[name]`.
|
|||
|
|
|
|||
|
|
.. plot:: _embedded_plots/figure_subplots_adjust.py
|
|||
|
|
|
|||
|
|
Parameters
|
|||
|
|
----------
|
|||
|
|
left : float, optional
|
|||
|
|
The position of the left edge of the subplots,
|
|||
|
|
as a fraction of the figure width.
|
|||
|
|
right : float, optional
|
|||
|
|
The position of the right edge of the subplots,
|
|||
|
|
as a fraction of the figure width.
|
|||
|
|
bottom : float, optional
|
|||
|
|
The position of the bottom edge of the subplots,
|
|||
|
|
as a fraction of the figure height.
|
|||
|
|
top : float, optional
|
|||
|
|
The position of the top edge of the subplots,
|
|||
|
|
as a fraction of the figure height.
|
|||
|
|
wspace : float, optional
|
|||
|
|
The width of the padding between subplots,
|
|||
|
|
as a fraction of the average Axes width.
|
|||
|
|
hspace : float, optional
|
|||
|
|
The height of the padding between subplots,
|
|||
|
|
as a fraction of the average Axes height.
|
|||
|
|
Nz�This figure was using a layout engine that is incompatible with subplots_adjust and/or tight_layout; not calling subplots_adjust.T) r— r˜ r‹ r‡ Ú subplotparsrK r� r‡ Ú
|
|||
|
|
_set_positionÚ get_positionr" )r# rï rŠ ÚrightrÚ ÚwspaceÚhspacer} s r& r™ zFigureBase.subplots_adjust( sª € ð>
|
|||
|
|
× "Ñ "Ó $Ð 0Ø×*Ñ*Ó,×>Ò>Ü × Ñ ð/ô
|
|||
|
|
0ð
|
|||
|
|
Ø ×Ñ× Ñ f¨e°S¸&À&ÔIØ—)‘)ò JˆBØ×!Ñ!Ó#Ñ/Ø× Ñ ×!3Ñ!3Ó!5×!BÑ!BÀ4Ó!HÕIð Jð ˆ�
|
|||
|
|
r( c ó† — |€ | j }t j |« D �cg c] }|j « €Œ|‘Œ }}|D ]ö }t j d|j
|
|||
|
|
« « |j « j }|j j « }|D ]— }|j j « |k( sŒ!|j « j }|dk( r|j |j k( s |dk( sŒ_|j |j k( sŒy| j d j ||« Œ™ Œø yc c}w )a²
|
|||
|
|
Align the xlabels of subplots in the same subplot row if label
|
|||
|
|
alignment is being done automatically (i.e. the label position is
|
|||
|
|
not manually set).
|
|||
|
|
|
|||
|
|
Alignment persists for draw events after this is called.
|
|||
|
|
|
|||
|
|
If a label is on the bottom, it is aligned with labels on Axes that
|
|||
|
|
also have their label on the bottom and that have the same
|
|||
|
|
bottom-most subplot row. If the label is on the top,
|
|||
|
|
it is aligned with labels on Axes with the same top-most row.
|
|||
|
|
|
|||
|
|
Parameters
|
|||
|
|
----------
|
|||
|
|
axs : list of `~matplotlib.axes.Axes`
|
|||
|
|
Optional list of (or `~numpy.ndarray`) `~matplotlib.axes.Axes`
|
|||
|
|
to align the xlabels.
|
|||
|
|
Default is to align all Axes on the figure.
|
|||
|
|
|
|||
|
|
See Also
|
|||
|
|
--------
|
|||
|
|
matplotlib.figure.Figure.align_ylabels
|
|||
|
|
matplotlib.figure.Figure.align_titles
|
|||
|
|
matplotlib.figure.Figure.align_labels
|
|||
|
|
|
|||
|
|
Notes
|
|||
|
|
-----
|
|||
|
|
This assumes that all Axes in ``axs`` are from the same `.GridSpec`,
|
|||
|
|
so that their `.SubplotSpec` positions correspond to figure positions.
|
|||
|
|
|
|||
|
|
Examples
|
|||
|
|
--------
|
|||
|
|
Example with rotated xtick labels::
|
|||
|
|
|
|||
|
|
fig, axs = plt.subplots(1, 2)
|
|||
|
|
for tick in axs[0].get_xticklabels():
|
|||
|
|
tick.set_rotation(55)
|
|||
|
|
axs[0].set_xlabel('XLabel 0')
|
|||
|
|
axs[1].set_xlabel('XLabel 1')
|
|||
|
|
fig.align_xlabels()
|
|||
|
|
Nú Working on: %srÚ rŠ rW )r� r Úravelr‡ Ú_logÚdebugÚ
|
|||
|
|
get_xlabelÚrowspanÚxaxisÚget_label_positionÚstartÚstopr` Újoin)r# rF r} r¢ ÚposÚaxcÚrowspancs r& Ú
|
|||
|
|
align_xlabelszFigureBase.align_xlabelsT s € ðT ˆ;Ø—)‘)ˆCÜ ŸH™H S›MÖN�b¨R×-?Ñ-?Ó-AÑ-MŠrÐNˆÐNØò DˆBÜ �J‰JÐ(¨"¯-©-«/Ô :Ø×(Ñ(Ó*×2Ñ2ˆGØ—(‘(×-Ñ-Ó/ˆCð ò
|
|||
|
|
D�Ø—9‘9×/Ñ/Ó1°SÓ8Ø "× 2Ñ 2Ó 4× <Ñ <�Hؘuš ¨¯ © ¸(¿.¹.Ò)HØ 8›O°· ± ÀÇ
|
|||
|
|
Á
|
|||
|
|
Ó0Mà ×0Ñ0°Ñ5×:Ñ:¸2¸sÕCñ
|
|||
|
|
|
|||
|
|
Dñ Dùò Oó
|
|||
|
|
¦D>¼D>c ó† — |€ | j }t j |« D �cg c] }|j « €Œ|‘Œ }}|D ]ö }t j d|j
|
|||
|
|
« « |j « j }|j j « }|D ]— }|j j « |k( sŒ!|j « j }|dk( r|j |j k( s |dk( sŒ_|j |j k( sŒy| j d j ||« Œ™ Œø yc c}w )a�
|
|||
|
|
Align the ylabels of subplots in the same subplot column if label
|
|||
|
|
alignment is being done automatically (i.e. the label position is
|
|||
|
|
not manually set).
|
|||
|
|
|
|||
|
|
Alignment persists for draw events after this is called.
|
|||
|
|
|
|||
|
|
If a label is on the left, it is aligned with labels on Axes that
|
|||
|
|
also have their label on the left and that have the same
|
|||
|
|
left-most subplot column. If the label is on the right,
|
|||
|
|
it is aligned with labels on Axes with the same right-most column.
|
|||
|
|
|
|||
|
|
Parameters
|
|||
|
|
----------
|
|||
|
|
axs : list of `~matplotlib.axes.Axes`
|
|||
|
|
Optional list (or `~numpy.ndarray`) of `~matplotlib.axes.Axes`
|
|||
|
|
to align the ylabels.
|
|||
|
|
Default is to align all Axes on the figure.
|
|||
|
|
|
|||
|
|
See Also
|
|||
|
|
--------
|
|||
|
|
matplotlib.figure.Figure.align_xlabels
|
|||
|
|
matplotlib.figure.Figure.align_titles
|
|||
|
|
matplotlib.figure.Figure.align_labels
|
|||
|
|
|
|||
|
|
Notes
|
|||
|
|
-----
|
|||
|
|
This assumes that all Axes in ``axs`` are from the same `.GridSpec`,
|
|||
|
|
so that their `.SubplotSpec` positions correspond to figure positions.
|
|||
|
|
|
|||
|
|
Examples
|
|||
|
|
--------
|
|||
|
|
Example with large yticks labels::
|
|||
|
|
|
|||
|
|
fig, axs = plt.subplots(2, 1)
|
|||
|
|
axs[0].plot(np.arange(0, 1000, 50))
|
|||
|
|
axs[0].set_ylabel('YLabel 0')
|
|||
|
|
axs[1].set_ylabel('YLabel 1')
|
|||
|
|
fig.align_ylabels()
|
|||
|
|
Nr� rï r™ rX )r� r rž r‡ rŸ r Ú
|
|||
|
|
get_ylabelÚcolspanÚyaxisr¤ r¥ r¦ r` r§ )r# rF r} r¯ r¨ r© Úcolspancs r& Ú
|
|||
|
|
align_ylabelszFigureBase.align_ylabels’ s € ðR ˆ;Ø—)‘)ˆCÜ ŸH™H S›MÖN�b¨R×-?Ñ-?Ó-AÑ-MŠrÐNˆÐNØò DˆBÜ �J‰JÐ(¨"¯-©-«/Ô :Ø×(Ñ(Ó*×2Ñ2ˆGØ—(‘(×-Ñ-Ó/ˆCð ò
|
|||
|
|
D�Ø—9‘9×/Ñ/Ó1°SÓ8Ø "× 2Ñ 2Ó 4× <Ñ <�Hؘvš
|
|||
|
|
¨'¯-©-¸8¿>¹>Ò*IØ 7›N¨w¯|©|¸x¿}¹}Ó/Là ×0Ñ0°Ñ5×:Ñ:¸2¸sÕCñ
|
|||
|
|
|
|||
|
|
Dñ Dùò Or¬ c óÎ — |€ | j }t j |« D �cg c] }|j « €Œ|‘Œ }}|D ]š }t j d|j
|
|||
|
|
« « |j « j }|D ]U }|j « j }|j |j k( sŒ7| j d j ||« ŒW Œœ yc c}w )aP
|
|||
|
|
Align the titles of subplots in the same subplot row if title
|
|||
|
|
alignment is being done automatically (i.e. the title position is
|
|||
|
|
not manually set).
|
|||
|
|
|
|||
|
|
Alignment persists for draw events after this is called.
|
|||
|
|
|
|||
|
|
Parameters
|
|||
|
|
----------
|
|||
|
|
axs : list of `~matplotlib.axes.Axes`
|
|||
|
|
Optional list of (or ndarray) `~matplotlib.axes.Axes`
|
|||
|
|
to align the titles.
|
|||
|
|
Default is to align all Axes on the figure.
|
|||
|
|
|
|||
|
|
See Also
|
|||
|
|
--------
|
|||
|
|
matplotlib.figure.Figure.align_xlabels
|
|||
|
|
matplotlib.figure.Figure.align_ylabels
|
|||
|
|
matplotlib.figure.Figure.align_labels
|
|||
|
|
|
|||
|
|
Notes
|
|||
|
|
-----
|
|||
|
|
This assumes that all Axes in ``axs`` are from the same `.GridSpec`,
|
|||
|
|
so that their `.SubplotSpec` positions correspond to figure positions.
|
|||
|
|
|
|||
|
|
Examples
|
|||
|
|
--------
|
|||
|
|
Example with titles::
|
|||
|
|
|
|||
|
|
fig, axs = plt.subplots(1, 2)
|
|||
|
|
axs[0].set_aspect('equal')
|
|||
|
|
axs[0].set_title('Title 0')
|
|||
|
|
axs[1].set_title('Title 1')
|
|||
|
|
fig.align_titles()
|
|||
|
|
Nr� rY ) r� r rž r‡ rŸ r Ú get_titler¢ r¥ r` r§ )r# rF r} r¢ r© rª s r& Ú align_titleszFigureBase.align_titlesÏ sÌ € ðH ˆ;Ø—)‘)ˆCÜ ŸH™H S›MÖN�b¨R×-?Ñ-?Ó-AÑ-MŠrÐNˆÐNØò DˆBÜ �J‰JÐ(¨"¯,©,«.Ô 9Ø×(Ñ(Ó*×2Ñ2ˆGØò
|
|||
|
|
D�Ø ×.Ñ.Ó0×8Ñ8�Ø—M‘M X§^¡^Ó3Ø×,Ñ,¨WÑ5×:Ñ:¸2¸sÕCñ
|
|||
|
|
Dñ Dùò Os
|
|||
|
|
¦C"¼C"c óL — | j |¬« | j |¬« y)a€
|
|||
|
|
Align the xlabels and ylabels of subplots with the same subplots
|
|||
|
|
row or column (respectively) if label alignment is being
|
|||
|
|
done automatically (i.e. the label position is not manually set).
|
|||
|
|
|
|||
|
|
Alignment persists for draw events after this is called.
|
|||
|
|
|
|||
|
|
Parameters
|
|||
|
|
----------
|
|||
|
|
axs : list of `~matplotlib.axes.Axes`
|
|||
|
|
Optional list (or `~numpy.ndarray`) of `~matplotlib.axes.Axes`
|
|||
|
|
to align the labels.
|
|||
|
|
Default is to align all Axes on the figure.
|
|||
|
|
|
|||
|
|
See Also
|
|||
|
|
--------
|
|||
|
|
matplotlib.figure.Figure.align_xlabels
|
|||
|
|
matplotlib.figure.Figure.align_ylabels
|
|||
|
|
matplotlib.figure.Figure.align_titles
|
|||
|
|
|
|||
|
|
Notes
|
|||
|
|
-----
|
|||
|
|
This assumes that all Axes in ``axs`` are from the same `.GridSpec`,
|
|||
|
|
so that their `.SubplotSpec` positions correspond to figure positions.
|
|||
|
|
)rF N)r« r² )r# rF s r& Ú align_labelszFigureBase.align_labelsþ s& € ð4
|
|||
|
|
×јsÐÔ#Ø ×јsÐÕ#r( c óH — |j dd« }t d||| dœ|¤Ž}|S )aS
|
|||
|
|
Low-level API for creating a `.GridSpec` that has this figure as a parent.
|
|||
|
|
|
|||
|
|
This is a low-level API, allowing you to create a gridspec and
|
|||
|
|
subsequently add subplots based on the gridspec. Most users do
|
|||
|
|
not need that freedom and should use the higher-level methods
|
|||
|
|
`~.Figure.subplots` or `~.Figure.subplot_mosaic`.
|
|||
|
|
|
|||
|
|
Parameters
|
|||
|
|
----------
|
|||
|
|
nrows : int, default: 1
|
|||
|
|
Number of rows in grid.
|
|||
|
|
|
|||
|
|
ncols : int, default: 1
|
|||
|
|
Number of columns in grid.
|
|||
|
|
|
|||
|
|
Returns
|
|||
|
|
-------
|
|||
|
|
`.GridSpec`
|
|||
|
|
|
|||
|
|
Other Parameters
|
|||
|
|
----------------
|
|||
|
|
**kwargs
|
|||
|
|
Keyword arguments are passed to `.GridSpec`.
|
|||
|
|
|
|||
|
|
See Also
|
|||
|
|
--------
|
|||
|
|
matplotlib.pyplot.subplots
|
|||
|
|
|
|||
|
|
Examples
|
|||
|
|
--------
|
|||
|
|
Adding a subplot that spans two rows::
|
|||
|
|
|
|||
|
|
fig = plt.figure()
|
|||
|
|
gs = fig.add_gridspec(2, 2)
|
|||
|
|
ax1 = fig.add_subplot(gs[0, 0])
|
|||
|
|
ax2 = fig.add_subplot(gs[1, 0])
|
|||
|
|
# spans two rows:
|
|||
|
|
ax3 = fig.add_subplot(gs[:, 1])
|
|||
|
|
|
|||
|
|
r' N)rC rD r' rS )r6 r )r# rC rD rk Ú_rE s r& rA zFigureBase.add_gridspec s0 € ðV
|
|||
|
|
�J‰J�x Ó &ˆÜ
|
|||
|
|
Ð
|
|||
|
|
F˜E¨°tÑ
|
|||
|
|
F¸vÑ
|
|||
|
|
FˆØˆ r( c
|
|||
|
|
óH — t ||| ||||dddd¬« } t j ||ft ¬« }
|
|||
|
|
t |« D ]/ } t |« D ] } | j
|
|||
|
|
| | | f fi |¤Ž|
|
|||
|
|
| | f< Œ! Œ1 | j
|
|||
|
|
« €p|€|�l| j | « \ }
|
|||
|
|
}}}t |
|
|||
|
|
|
|
|||
|
|
|« D ]F \ }}}t |||« D ]0 \ }}}t j ||||« }|j |¬« Œ2 ŒH |r/|
|
|||
|
|
j dk( r|
|
|||
|
|
j « S |
|
|||
|
|
j « S |
|
|||
|
|
S )a*
|
|||
|
|
Add a set of subfigures to this figure or subfigure.
|
|||
|
|
|
|||
|
|
A subfigure has the same artist methods as a figure, and is logically
|
|||
|
|
the same as a figure, but cannot print itself.
|
|||
|
|
See :doc:`/gallery/subplots_axes_and_figures/subfigures`.
|
|||
|
|
|
|||
|
|
.. versionchanged:: 3.10
|
|||
|
|
subfigures are now added in row-major order.
|
|||
|
|
|
|||
|
|
Parameters
|
|||
|
|
----------
|
|||
|
|
nrows, ncols : int, default: 1
|
|||
|
|
Number of rows/columns of the subfigure grid.
|
|||
|
|
|
|||
|
|
squeeze : bool, default: True
|
|||
|
|
If True, extra dimensions are squeezed out from the returned
|
|||
|
|
array of subfigures.
|
|||
|
|
|
|||
|
|
wspace, hspace : float, default: None
|
|||
|
|
The amount of width/height reserved for space between subfigures,
|
|||
|
|
expressed as a fraction of the average subfigure width/height.
|
|||
|
|
If not given, the values will be inferred from rcParams if using
|
|||
|
|
constrained layout (see `~.ConstrainedLayoutEngine`), or zero if
|
|||
|
|
not using a layout engine.
|
|||
|
|
|
|||
|
|
width_ratios : array-like of length *ncols*, optional
|
|||
|
|
Defines the relative widths of the columns. Each column gets a
|
|||
|
|
relative width of ``width_ratios[i] / sum(width_ratios)``.
|
|||
|
|
If not given, all columns will have the same width.
|
|||
|
|
|
|||
|
|
height_ratios : array-like of length *nrows*, optional
|
|||
|
|
Defines the relative heights of the rows. Each row gets a
|
|||
|
|
relative height of ``height_ratios[i] / sum(height_ratios)``.
|
|||
|
|
If not given, all rows will have the same height.
|
|||
|
|
r rˆ ) rC rD r' rš r› r9 r: rï r™ rŠ rÚ ©Údtyper´ )r r ÚemptyÚobjectÚrangeÚ
|
|||
|
|
add_subfigurer— Úget_grid_positionsÚzipr Ú from_extentsÚ_redo_transform_rel_figrÀ Úitemr8 )r# rC rD r8 rš r› r9 r: rk rE ÚsfarrÚiÚjÚbottomsÚtopsÚleftsÚrightsÚsfrowrŠ rÚ Úsfrï r™ r¯ s r& Ú
|
|||
|
|
subfigureszFigureBase.subfiguresJ sZ € ôP ˜E¨°tØ #¨FØ#/Ø$1Ø A¨a°Qô 8ˆô —‘˜% ˜ ¬vÔ6ˆÜ�u“ ò EˆAܘ5“\ò
|
|||
|
|
E�Ø 0˜d× 0Ñ 0°°A°q°D±Ñ D¸VÑ D��a˜�d’ ñ
|
|||
|
|
Eð Eð × !Ñ !Ó #Ð +°Ð1CØ17Ð1Cð ,.×+@Ñ+@ÀÓ+FÑ (ˆG�T˜5 &Ü&)¨%°¸$Ó&?ò
|
|||
|
|
:Ñ"��v˜sÜ'*¨5°%¸Ó'@ò :‘O�B˜˜eÜ ×,Ñ,¨T°6¸5À#ÓF�DØ×.Ñ.°DÐ.Õ9ñ:ð
|
|||
|
|
:ñ
|
|||
|
|
ð $)§:¡:°¢?�5—:‘:“<Ð G¸¿
|
|||
|
|
¹
|
|||
|
|
»Ð Gð ˆLr( c ó¦ — t | |fi |¤Ž}| xj |gz
|
|||
|
|
c_ | j j |_ t |_ d| _ |S )aø
|
|||
|
|
Add a `.SubFigure` to the figure as part of a subplot arrangement.
|
|||
|
|
|
|||
|
|
Parameters
|
|||
|
|
----------
|
|||
|
|
subplotspec : `.gridspec.SubplotSpec`
|
|||
|
|
Defines the region in a parent gridspec where the subfigure will
|
|||
|
|
be placed.
|
|||
|
|
|
|||
|
|
Returns
|
|||
|
|
-------
|
|||
|
|
`.SubFigure`
|
|||
|
|
|
|||
|
|
Other Parameters
|
|||
|
|
----------------
|
|||
|
|
**kwargs
|
|||
|
|
Are passed to the `.SubFigure` object.
|
|||
|
|
|
|||
|
|
See Also
|
|||
|
|
--------
|
|||
|
|
.Figure.subfigures
|
|||
|
|
T)Ú SubFigurerh r9 rÏ r' r5 r" )r# Ú subplotspecrk rÎ s r& rÀ zFigureBase.add_subfigure� sK € ô. �t˜[Ñ
|
|||
|
|
3¨FÑ
|
|||
|
|
3ˆØ � Š ˜˜Ñ � Ø ŸL™L× /Ñ /ˆÔÜ 2ˆÔ؈Œ
|
|||
|
|
؈ r( c ót — | j j |« | j j d| « |S )z.Set the current Axes to be *a* and return *a*.rL )r2 r= rM rN r7 s r& r3 zFigureBase.sca s0 € à �
|
|||
|
|
‰
|
|||
|
|
× Ñ ˜QÔ Ø ×Ñ×!Ñ!Ð"6¸Ô=؈r( c ó^ — | j j « }|�|S | j « S )aŒ
|
|||
|
|
Get the current Axes.
|
|||
|
|
|
|||
|
|
If there is currently no Axes on this Figure, a new one is created
|
|||
|
|
using `.Figure.add_subplot`. (To test whether there is currently an
|
|||
|
|
Axes on a Figure, check whether ``figure.axes`` is empty. To test
|
|||
|
|
whether there is currently a Figure on the pyplot figure stack, check
|
|||
|
|
whether `.pyplot.get_fignums()` is empty.)
|
|||
|
|
)r2 rE r( rJ s r& r� zFigureBase.gca³ s. € ð �]‰]×
|
|||
|
|
"Ñ
|
|||
|
|
"Ó
|
|||
|
|
$ˆØ�^ˆrÐ;¨×)9Ñ)9Ó);Ð;r( c óÆ — | j j « }|€y|j « }|�|S t | j « D ] }|j « }|€Œ|c S y)a>
|
|||
|
|
Get the current colorable artist.
|
|||
|
|
|
|||
|
|
Specifically, returns the current `.ScalarMappable` instance (`.Image`
|
|||
|
|
created by `imshow` or `figimage`, `.Collection` created by `pcolor` or
|
|||
|
|
`scatter`, etc.), or *None* if no such instance has been defined.
|
|||
|
|
|
|||
|
|
The current image is an attribute of the current Axes, or the nearest
|
|||
|
|
earlier Axes in the current figure that contains an image.
|
|||
|
|
|
|||
|
|
Notes
|
|||
|
|
-----
|
|||
|
|
Historically, the only colorable artists were images; hence the name
|
|||
|
|
``gci`` (get current image).
|
|||
|
|
N)r2 rE Ú_gciÚreversedr� )r# r} Úims r& rÖ zFigureBase._gciÀ sg € ð$ �]‰]×
|
|||
|
|
"Ñ
|
|||
|
|
"Ó
|
|||
|
|
$ˆØ
|
|||
|
|
ˆ:ØØ
|
|||
|
|
�W‰W‹YˆØ
|
|||
|
|
ˆ>؈Iô ˜4Ÿ9™9Ó%ò ˆBØ—‘“ˆB؉~Ø’ ð ð r( )Ú
|
|||
|
|
axes_classÚpolarÚ
|
|||
|
|
projectionc óF — |�|s|� t d« ‚|}||fS |r|�|dk7 rt d|› d|›d�« ‚d}t |t « s|€t j |« }||fS t |d« r)|j
|
|||
|
|
« \ }} |j di |¤Ž ||fS t d|›�« ‚) zÊ
|
|||
|
|
Handle the args/kwargs to add_axes/add_subplot/gca, returning::
|
|||
|
|
|
|||
|
|
(axes_proj_class, proj_class_kwargs)
|
|||
|
|
|
|||
|
|
which can be used for new Axes initialization/identification.
|
|||
|
|
z7Cannot combine 'axes_class' and 'projection' or 'polar'rÚ zpolar=z, yet projection=z1. Only one of these arguments should be supplied.Ú _as_mpl_axeszJprojection must be a string, None or implement a _as_mpl_axes method, not rS ) r; r r0 r Úget_projection_classr{ rÝ rK r )r# rÙ rÚ rÛ rk r$ Ú extra_kwargss r& r! z+FigureBase._process_projection_requirementsá s € ð Ð !Ù˜
|
|||
|
|
Ð.Ü ØMóOð Oà )Ð ð( Ð'Ð'ñ# Ø Ð)¨j¸GÒ.CÜ$Ø Ð'8¸¸ð GJð Jóð ð %�
|
|||
|
|
ä˜*¤cÔ*¨jÐ.@Ü#.×#CÑ#CÀJÓ#OÐ ð Ð'Ð'ô ˜ ^Ô4Ø1;×1HÑ1HÓ1JÑ.Ð ,Ø �—
|
|||
|
|
‘
|
|||
|
|
Ñ- Ò-ð
|
|||
|
|
Ð'Ð'ô ð0Ø0:¨~ð?ó@ð @r( c ó — | j « D �cg c]$ }|j « r|j « r|‘Œ& }}| j D ]2 }|j « sŒ|j |j « « Œ4 |S c c}w )zU
|
|||
|
|
Return a list of Artists typically used in `.Figure.get_tightbbox`.
|
|||
|
|
)rw rý Ú
|
|||
|
|
get_in_layoutr� ÚextendÚ get_default_bbox_extra_artists)r# rq Ú bbox_artistsr} s r& rã z)FigureBase.get_default_bbox_extra_artists s‡ € ð .2×->Ñ->Ó-@ö N 6Ø "× .Ñ .Ô 0°V×5IÑ5IÔ5Kò ð Nˆ ð Nà—)‘)ò IˆBØ�~‰~Õ Ø ×#Ñ# B×$EÑ$EÓ$GÕHð Ið Ðùò Ns “)B©Úbbox_extra_artistsc óà — |€ | j d¬« j « }g }|€L| j « D �cg c]2 }|| j vr"|j « r|j « r|‘Œ4 }}n|}|D ]' }|j
|
|||
|
|
|« }|€Œ|j |« Œ) | j D ]8 }|j « sŒ |j
|
|||
|
|
||¬« }|j |« Œ: |D � cg c]` } t j | j « r?t j | j « r | j dk7 s| j dk7 r| ‘Œb }} t | d« }
|
|||
|
|
t |« dk( r|
|
|||
|
|
r | j S | j g}t# j$ |« } |
|
|||
|
|
r$t' | | j( j+ « « } | S c c}w # t $ r |j
|
|||
|
|
|« }Y �Œw xY wc c} w )aF
|
|||
|
|
Return a (tight) bounding box of the figure *in inches*.
|
|||
|
|
|
|||
|
|
Note that `.FigureBase` differs from all other artists, which return
|
|||
|
|
their `.Bbox` in pixels.
|
|||
|
|
|
|||
|
|
Artists that have ``artist.set_in_layout(False)`` are not included
|
|||
|
|
in the bbox.
|
|||
|
|
|
|||
|
|
Parameters
|
|||
|
|
----------
|
|||
|
|
renderer : `.RendererBase` subclass
|
|||
|
|
Renderer that will be used to draw the figures (i.e.
|
|||
|
|
``fig.canvas.get_renderer()``)
|
|||
|
|
|
|||
|
|
bbox_extra_artists : list of `.Artist` or ``None``
|
|||
|
|
List of artists to include in the tight bounding box. If
|
|||
|
|
``None`` (default), then all artist children of each Axes are
|
|||
|
|
included in the tight bounding box.
|
|||
|
|
|
|||
|
|
Returns
|
|||
|
|
-------
|
|||
|
|
`.BboxBase`
|
|||
|
|
containing the bounding box (in figure inches).
|
|||
|
|
Tr rå r Ú bbox_inches)r! r rw r� rý rá Ú
|
|||
|
|
get_tightbboxr r r r ÚwidthÚheightr{ r� rè r¯ r Úunionr Údpi_scale_transÚinverted) r# r| ræ Úbbrq rb r8 r¯ r} r ÚisfigureÚ_bboxs r& ré zFigureBase.get_tightbbox sÚ € ð6 Ð Ø—‘¨D�Ó1×?Ñ?ÓAˆHà
|
|||
|
|
ˆØ Ð %Ø,0×,=Ñ,=Ó,?ö 8 &Ø!¨¯©Ñ2°v×7IÑ7IÔ7KØ %× 3Ñ 3Ô 5ò ð 8ˆGñ 8ð )ˆGàò ˆAØ—?‘? 8Ó,ˆDØÑ Ø— ‘ ˜$•ð ð
|
|||
|
|
—)‘)ò ˆBØ�~‰~Õ ð6Ø ×+Ñ+Ø Ð5Gð ,ó I�Dð — ‘ ˜$•ð ð ö 8�AÜ—+‘+˜aŸg™gÔ&¬2¯;©;°q·x±xÔ+@Ø—w‘w !’| q§x¡x°1¢}ò ð 8ˆð 8ô ˜4 Ó/ˆÜ ˆr‹7�aŠ<ÙØ×'Ñ'Ð'ð —i‘i�[�ä—
|
|||
|
|
‘
|
|||
|
|
˜2“ˆá ä# E¨4×+?Ñ+?×+HÑ+HÓ+JÓKˆEàˆ ùòO8øô$ !ò 6Ø ×+Ñ+¨HÓ5“Dð6üò8s ¹7GÃG
|
|||
|
|
Ã,A%G+Ç
|
|||
|
|
G(Ç'G(c óÊ — i }| j « D ]M \ }}t |t « r |D ] }||v rt d|›d�« ‚|||< Œ Œ6||v rt d|›d�« ‚|||< ŒO |S )NzThe key z appears multiple times.)rŠ r r- r; )Úper_subplot_kwÚexpandedr‘ r’ Úsub_keys r& Ú_norm_per_subplot_kwz FigureBase._norm_per_subplot_kwX s‘ € àˆØ"×(Ñ(Ó*ò ‰DˆAˆqܘ!œUÔ#Ø ò *�GØ (Ñ*Ü (¨8°G°;Ð>VÐ)WÓ XÐXØ()�H˜WÒ%ñ*ð
|
|||
|
|
˜‘=Ü$ x°¨uÐ4LÐ%MÓNÐNØ �˜’ ð ð ˆr( c ó — d| vr(| j d« D �cg c]
|
|||
|
|
}t |« ‘Œ c}S t j | « } | j d« j d« D �cg c]
|
|||
|
|
}t |« ‘Œ c}S c c}w c c}w )Nú
|
|||
|
|
ú;)ÚsplitÚlistÚinspectÚcleandocÚstrip)ÚlayoutÚlns r& Ú_normalize_grid_stringz!FigureBase._normalize_grid_stringg sn € à �vÑ à'-§|¡|°CÓ'8Ö9 ”D˜•HÒ9Ð 9ô ×%Ñ% fÓ-ˆFØ'-§|¡|°DÓ'9×'?Ñ'?ÀÓ'EÖF ”D˜•HÒFÐ Fùò :ùò Gs ˜A9Á$A>ú.)r6 r7 r9 r: Úempty_sentinelr; ró r< c ó’ ‡ ‡‡‡‡‡‡— ‰xs i Št | xs i « } ‰xs i Š|�d| v r t d« ‚|| d< |�d| v r t d« ‚|| d< t |t « r>‰ j |« }‰j « D �
|
|||
|
|
� ci c] \ }
|
|||
|
|
} t
|
|||
|
|
|
|
|||
|
|
« | “Œ c} }
|
|||
|
|
Š‰ j ‰« Št j t ||¬« d„ Šˆˆfd„Šˆˆˆˆ ˆfd„Š ‰|« }|j \ } }
|
|||
|
|
‰ j | |
|
|||
|
|
fi | ¤Ž} ‰||g ‰|« ¢Ž }t t |j « « « }|j « D ]M }|r#|j! |« |j# d ¬
|
|||
|
|
« |sŒ+|j% |« |j' d ¬
|
|||
|
|
« ŒO t) ‰« t) |« z
|
|||
|
|
x}rt d |› d �« ‚|S c c} }
|
|||
|
|
w )
|
|||
|
|
aó
|
|||
|
|
Build a layout of Axes based on ASCII art or nested lists.
|
|||
|
|
|
|||
|
|
This is a helper function to build complex GridSpec layouts visually.
|
|||
|
|
|
|||
|
|
See :ref:`mosaic`
|
|||
|
|
for an example and full API documentation
|
|||
|
|
|
|||
|
|
Parameters
|
|||
|
|
----------
|
|||
|
|
mosaic : list of list of {hashable or nested} or str
|
|||
|
|
|
|||
|
|
A visual layout of how you want your Axes to be arranged
|
|||
|
|
labeled as strings. For example ::
|
|||
|
|
|
|||
|
|
x = [['A panel', 'A panel', 'edge'],
|
|||
|
|
['C panel', '.', 'edge']]
|
|||
|
|
|
|||
|
|
produces 4 Axes:
|
|||
|
|
|
|||
|
|
- 'A panel' which is 1 row high and spans the first two columns
|
|||
|
|
- 'edge' which is 2 rows high and is on the right edge
|
|||
|
|
- 'C panel' which in 1 row and 1 column wide in the bottom left
|
|||
|
|
- a blank space 1 row and 1 column wide in the bottom center
|
|||
|
|
|
|||
|
|
Any of the entries in the layout can be a list of lists
|
|||
|
|
of the same form to create nested layouts.
|
|||
|
|
|
|||
|
|
If input is a str, then it can either be a multi-line string of
|
|||
|
|
the form ::
|
|||
|
|
|
|||
|
|
'''
|
|||
|
|
AAE
|
|||
|
|
C.E
|
|||
|
|
'''
|
|||
|
|
|
|||
|
|
where each character is a column and each line is a row. Or it
|
|||
|
|
can be a single-line string where rows are separated by ``;``::
|
|||
|
|
|
|||
|
|
'AB;CC'
|
|||
|
|
|
|||
|
|
The string notation allows only single character Axes labels and
|
|||
|
|
does not support nesting but is very terse.
|
|||
|
|
|
|||
|
|
The Axes identifiers may be `str` or a non-iterable hashable
|
|||
|
|
object (e.g. `tuple` s may not be used).
|
|||
|
|
|
|||
|
|
sharex, sharey : bool, default: False
|
|||
|
|
If True, the x-axis (*sharex*) or y-axis (*sharey*) will be shared
|
|||
|
|
among all subplots. In that case, tick label visibility and axis
|
|||
|
|
units behave as for `subplots`. If False, each subplot's x- or
|
|||
|
|
y-axis will be independent.
|
|||
|
|
|
|||
|
|
width_ratios : array-like of length *ncols*, optional
|
|||
|
|
Defines the relative widths of the columns. Each column gets a
|
|||
|
|
relative width of ``width_ratios[i] / sum(width_ratios)``.
|
|||
|
|
If not given, all columns will have the same width. Equivalent
|
|||
|
|
to ``gridspec_kw={'width_ratios': [...]}``. In the case of nested
|
|||
|
|
layouts, this argument applies only to the outer layout.
|
|||
|
|
|
|||
|
|
height_ratios : array-like of length *nrows*, optional
|
|||
|
|
Defines the relative heights of the rows. Each row gets a
|
|||
|
|
relative height of ``height_ratios[i] / sum(height_ratios)``.
|
|||
|
|
If not given, all rows will have the same height. Equivalent
|
|||
|
|
to ``gridspec_kw={'height_ratios': [...]}``. In the case of nested
|
|||
|
|
layouts, this argument applies only to the outer layout.
|
|||
|
|
|
|||
|
|
subplot_kw : dict, optional
|
|||
|
|
Dictionary with keywords passed to the `.Figure.add_subplot` call
|
|||
|
|
used to create each subplot. These values may be overridden by
|
|||
|
|
values in *per_subplot_kw*.
|
|||
|
|
|
|||
|
|
per_subplot_kw : dict, optional
|
|||
|
|
A dictionary mapping the Axes identifiers or tuples of identifiers
|
|||
|
|
to a dictionary of keyword arguments to be passed to the
|
|||
|
|
`.Figure.add_subplot` call used to create each subplot. The values
|
|||
|
|
in these dictionaries have precedence over the values in
|
|||
|
|
*subplot_kw*.
|
|||
|
|
|
|||
|
|
If *mosaic* is a string, and thus all keys are single characters,
|
|||
|
|
it is possible to use a single string instead of a tuple as keys;
|
|||
|
|
i.e. ``"AB"`` is equivalent to ``("A", "B")``.
|
|||
|
|
|
|||
|
|
.. versionadded:: 3.7
|
|||
|
|
|
|||
|
|
gridspec_kw : dict, optional
|
|||
|
|
Dictionary with keywords passed to the `.GridSpec` constructor used
|
|||
|
|
to create the grid the subplots are placed on. In the case of
|
|||
|
|
nested layouts, this argument applies only to the outer layout.
|
|||
|
|
For more complex layouts, users should use `.Figure.subfigures`
|
|||
|
|
to create the nesting.
|
|||
|
|
|
|||
|
|
empty_sentinel : object, optional
|
|||
|
|
Entry in the layout to mean "leave this space empty". Defaults
|
|||
|
|
to ``'.'``. Note, if *layout* is a string, it is processed via
|
|||
|
|
`inspect.cleandoc` to remove leading white space, which may
|
|||
|
|
interfere with using white-space as the empty sentinel.
|
|||
|
|
|
|||
|
|
Returns
|
|||
|
|
-------
|
|||
|
|
dict[label, Axes]
|
|||
|
|
A dictionary mapping the labels to the Axes objects. The order of
|
|||
|
|
the Axes is left-to-right and top-to-bottom of their position in the
|
|||
|
|
total layout.
|
|||
|
|
|
|||
|
|
r: r> r9 r? )r6 r7 c óä — | ^}}t |t « r t d« ‚t |d¬« D ]d \ }}t |t « r t d« ‚t |« t |« k7 sŒ9t d|›dt |« › d|› d|›dt |« › d� « ‚ t j t | « t |« ft ¬ « }t | « D ] \ }}t |« D ] \ }}||||f< Œ Œ! |S )
|
|||
|
|
aJ
|
|||
|
|
Convert input into 2D array
|
|||
|
|
|
|||
|
|
We need to have this internal function rather than
|
|||
|
|
``np.asarray(..., dtype=object)`` so that a list of lists
|
|||
|
|
of lists does not get converted to an array of dimension > 2.
|
|||
|
|
|
|||
|
|
Returns
|
|||
|
|
-------
|
|||
|
|
2D object array
|
|||
|
|
z$List mosaic specification must be 2Drˆ )r¥ z@All of the rows must be the same length, however the first row (z
|
|||
|
|
) has length z and row z (r r» )r r0 r; Ú enumerater� r Úzerosr¾ )ÚinpÚr0ÚrestrÈ ÚrÚoutr‘ r’ s r& Ú _make_arrayz.FigureBase.subplot_mosaic.<locals>._make_arrayú s € ð ˆIˆB�ܘ"œcÔ"Ü Ð!GÓHÐHÜ! $¨aÔ0ò
|
|||
|
|
‘��1Ü ˜a¤Ô%Ü$Ð%KÓLÐLÜ�r“7œc !›fÓ$Ü$ð*Ø*,¨¨}¼SÀ»W¸Ið F#Ø#$ # R¨ u¨M¼#¸a»&¸ÀðDóð ð
|
|||
|
|
ô —(‘(œC ›H¤c¨"£gÐ.´fÔ=ˆCÜ! #›ò
|
|||
|
|
"‘��1Ü % a›Lò "‘D�A�qØ !�C˜˜1˜’Iñ"ð
|
|||
|
|
"ð ˆJr( c ó
|
|||
|
|
•— t j « }i }t | « D ]R \ }}t |« D ]? \ }}|‰k( rŒ t j |« s ‰|« |||f< Œ/|j |« ŒA ŒT t |« |fS )ar
|
|||
|
|
Given a 2D object array, identify unique IDs and nested mosaics
|
|||
|
|
|
|||
|
|
Parameters
|
|||
|
|
----------
|
|||
|
|
mosaic : 2D object array
|
|||
|
|
|
|||
|
|
Returns
|
|||
|
|
-------
|
|||
|
|
unique_ids : tuple
|
|||
|
|
The unique non-sub mosaic entries in this mosaic
|
|||
|
|
nested : dict[tuple[int, int], 2D object array]
|
|||
|
|
)r^ Ú _OrderedSetr Úis_scalar_or_stringr? r- ) ÚmosaicÚ
|
|||
|
|
unique_idsÚnestedrÈ Úrowr‘ r’ r
|
|||
|
|
r s €€r& Ú_identify_keys_and_nestedz<FigureBase.subplot_mosaic.<locals>._identify_keys_and_nested s� ø€ ô ×*Ñ*Ó,ˆJ؈FÜ# FÓ+ò
|
|||
|
|
*‘��3Ü % c›Nò *‘D�A�qؘNÒ*Ø Ü "× 6Ñ 6°qÔ 9Ù)4°Q« ˜ 1˜všà"Ÿ™ qÕ)ñ
|
|||
|
|
*ð
|
|||
|
|
*ô ˜Ó$ fÐ,Ð ,r( c
|
|||
|
|
ó¬ •— t « }t « }|D ]› }t j ||k( « }t j |d¬« \ }} t j |d¬« dz \ }
|
|||
|
|
} t ||
|
|||
|
|
« t | | « f} || |k7 j
|
|||
|
|
« rt d|›d|›d�« ‚|| df||| f< Œ� |j « D ] \ \ }
|
|||
|
|
}}d|d f||
|
|||
|
|
|f< Œ t |« D ]ë }|| \ }}}|dk( rR|} ||v rt d
|
|||
|
|
|› d |›�« ‚ ‰j | | fi d t |« i‰ ¥‰j |i « ¥¤Ž}|||< Œc|d k( rz|}|\ }
|
|||
|
|
}|j \ }} ‰| |
|
|||
|
|
|f j ||« |g ‰|« ¢Ž }t |« t |« z }|rt d
|
|||
|
|
|› d
|
|||
|
|
|›d|› �« ‚|j! |« Œât# d« ‚ |S )a<
|
|||
|
|
Recursively do the mosaic.
|
|||
|
|
|
|||
|
|
Parameters
|
|||
|
|
----------
|
|||
|
|
gs : GridSpec
|
|||
|
|
mosaic : 2D object array
|
|||
|
|
The input converted to a 2D array for this level.
|
|||
|
|
unique_ids : tuple
|
|||
|
|
The identified scalar labels at this level of nesting.
|
|||
|
|
nested : dict[tuple[int, int]], 2D object array
|
|||
|
|
The identified nested mosaics, if any.
|
|||
|
|
|
|||
|
|
Returns
|
|||
|
|
-------
|
|||
|
|
dict[label, Axes]
|
|||
|
|
A flat dict of all of the Axes created.
|
|||
|
|
r )rx rˆ zWhile trying to layout
|
|||
|
|
z
|
|||
|
|
we found that the label z4 specifies a non-rectangular or non-contiguous area.r� Nr zThere are duplicate keys z in the layout
|
|||
|
|
r� z between the outer layout
|
|||
|
|
z
|
|||
|
|
and the nested layout
|
|||
|
|
zThis should never happen)r@ r ÚargwhereÚminrC ÚsliceÚanyr; rŠ ry r( r0 ÚgetÚshapeÚ subgridspecrj rK Ú RuntimeError) rE r r r ÚoutputÚ
|
|||
|
|
this_levelr¸ ÚindxÚ start_rowÚ start_colÚend_rowÚend_colÚslcrÈ r‘ Ú
|
|||
|
|
nested_mosaicrA ÚargÚmethodr} ÚrowsÚcolsÚ
|
|||
|
|
nested_outputÚoverlapÚ
|
|||
|
|
_do_layoutr ró r# r; s €€€€€r& r. z-FigureBase.subplot_mosaic.<locals>._do_layout4 s� ø€ ô& “VˆFô ›ˆJð #ò
|
|||
|
|
I�ä—{‘{ 6¨T¡>Ó2�Ü')§v¡v¨d¸Ô';Ñ$� ˜9Ü#%§6¡6¨$°QÔ#7¸!Ñ#;Ñ �˜ä ˜Y¨Ó0´%¸ À7Ó2KÐL�à˜3‘K 4Ñ'×,Ñ,Ô.Ü$Ø2°6°*ð =3Ø37°(ð ;BðBóCð Cð
|
|||
|
|
7;¸CÀÐ5H�
|
|||
|
|
˜I yÐ1Ò2ð
|
|||
|
|
Ið$ *0¯ © « ò
|
|||
|
|
EÑ%‘��A˜
|
|||
|
|
Ø&*¨M¸8Ð%D�
|
|||
|
|
˜A˜q˜6Ò"ð
|
|||
|
|
Eô
|
|||
|
|
˜jÓ)ò &
|
|||
|
|
C�Ø$.¨s¡OÑ!��c˜6ð ˜VÒ#Ø �Cà˜v‘~Ü (Ð+DÀTÀFð K;Ø;A¸*ð*Fó Gð Gà)˜×)Ñ)ؘ3™ñà #¤S¨£Yð$à (ð$ð -× 0Ñ 0°°rÓ :ð$ñ�Bð $&�F˜4’LؘxÒ'Ø$'�MØ ‘D�A�qà!.×!4Ñ!4‘J�D˜$Ù$.ؘ1˜a˜4™×,Ñ,¨T°4Ó8Ø%ð%ñ 3°=ÓAò%�Mô
|
|||
|
|
" &›k¬C°
|
|||
|
|
Ó,>Ñ >�GÙ Ü (Ø 7¸°yð A9Ø9?¸
|
|||
|
|
ð C6Ø6C°_ð Fó ð ð
|
|||
|
|
—M‘M -Õ0ä&Ð'AÓBÐBðM&
|
|||
|
|
CðN ˆMr( T)Úskip_non_rectangular_axesz The keys z/ are in *per_subplot_kw* but not in the mosaic.)r@ r; r r0 r rŠ r- rö r‹ Úcheck_isinstanceÚboolr rA r< ÚiterrH r6 Ú_label_outer_xaxisr7 Ú_label_outer_yaxisrj )r# r r6 r7 r9 r: r r; ró r< r‘ r’ r* r+ rE ÚretÚax0r} Úextrar. r r
|
|||
|
|
s ` ``` @@@r& Úsubplot_mosaiczFigureBase.subplot_mosaicq sÿ þ€ ð\ Ò% 2ˆ
|
|||
|
|
ܘ;Ò,¨"Ó-ˆ Ø'Ò-¨2ˆà Ð $Ø +Ñ-Ü ð "Ió Jð Jà+8ˆK˜Ñ (Ø Ð #Ø Ñ,Ü ð "Ió Jð Jà*6ˆK˜Ñ 'ô �fœcÔ "Ø×0Ñ0°Ó8ˆFà(6×(<Ñ(<Ó(>÷ Ù $ 1”�a“˜!‘ ó ˆNð ×2Ñ2°>ÓBˆô
|
|||
|
|
× Ñ œd¨6¸&ÕAò õ< -÷8] ð ] ñ~ ˜VÓ$ˆØ—\‘\‰
|
|||
|
|
ˆˆdØ
|
|||
|
|
ˆT×
|
|||
|
|
Ñ
|
|||
|
|
˜t TÑ
|
|||
|
|
9¨[Ñ
|
|||
|
|
9ˆÙ˜˜VÐHÑ&?ÀÓ&GÒHˆÜ”4˜Ÿ
|
|||
|
|
™
|
|||
|
|
› Ó%Ó&ˆØ—*‘*“,ò FˆBÙØ— ‘ ˜#”Ø×%Ñ%ÀÐ%ÔEÚØ— ‘ ˜#”Ø×%Ñ%ÀÐ%ÕEð
|
|||
|
|
Fô ˜Ó'¬#¨c«(Ñ2Ð 2ˆ5Ð 2Ü Ø˜E˜7ð #)ð )óð
|
|||
|
|
ð ˆ
|
|||
|
|
ùóg s ÂGc ó| — || k7 r|j | « t |_ |j | j « y r, )rª r' r5 r r r7 s r& Ú_set_artist_propsz FigureBase._set_artist_props¦ s/ € Ø �Š9Ø
|
|||
|
|
�L‰L˜Ô Ü1ˆÔØ �‰˜×+Ñ+Õ,r( )gš™™™™™É?é r™ r‚ r, ©F)rˆ rˆ )NNT)NNNNNN)rˆ rˆ TNNNN)ErO rP rQ rR r2 r€ rŸ rw r! rª ÚpropertyrÌ rÍ r' r° r¶ rÕ rÎ r Ú SubstitutionÚcopyrà rå rê rì rô rö rø rû rþ r r r r
|
|||
|
|
r
|
|||
|
|
Úframeonr Úinterpdr r( r" rB r4 rI rc rg rp rÊ r” r™ r« r² rµ r· rA rÏ rÀ r3 r� rÖ r! rã ré Ú staticmethodrö r r8 r: Ú
|
|||
|
|
__classcell__©rl s @r& rU rU v s ø„ ñô òBð( >Eó+òZ
|
|||
|
|
ó% òN$ñ$ Ð'�i×'Ñ'¨
|
|||
|
|
¸Ô>À
|
|||
|
|
ð :ô<€Fò óòJòX"ð €Z× Ñ ¨°=ÀXØ %¨'ô3à€Z‡_�_�ZÓ ñ2ó !ó3ð2ò?ð
|
|||
|
|
€Z× Ñ ¨°>ÀhØ (¨Wô6à€Z‡_�_�ZÓ ñ2ó !ó6ð2ò?ð
|
|||
|
|
€Z× Ñ ¨°>ÀfØ (¨Wô6à€Z‡_�_�ZÓ ñ2ó !ó6ð2ò?ò
|
|||
|
|
*ò*ò(ò,ò*ò (ò(ò ñ �{ KÓ0€Gó!ðF ×Ññn/ó ðn/ð` ×Ññ}0ó ð}0ò~ ðH°5ÀØ ¨DÀØ ¨dôHòTGò "$óH!óH9ð, ×Ññuó ðuðn ×Ñò/ó ð/ðb ×Ñà<@òuó ðuðn GKØ,0ó*óX<Dó|;Dóz-Dó^$ó:-ð^ 48Ø'+Ø48óCòJ ò<ò <ò ðB >BÈØ48ô!(òF ðGÀô GðR ñ ó ð ð ñGó ðGð 05¸UØ$(¸Ø&)Ø"&°tÈôsöj -r( rU c óÎ ‡ — e Zd ZdZdddddœˆ fd„
|
|||
|
|
Zed„ « Zed„ « Zej d„ « Zd „ Z d
|
|||
|
|
„ Z
|
|||
|
|
d „ Z dd „Z d
|
|||
|
|
„ Z
|
|||
|
|
dd„Zd„ Zed„ « Zej" Zd„ Zˆ xZS )rÑ a¿
|
|||
|
|
Logical figure that can be placed inside a figure.
|
|||
|
|
|
|||
|
|
See :ref:`figure-api-subfigure` for an index of methods on this class.
|
|||
|
|
Typically instantiated using `.Figure.add_subfigure` or
|
|||
|
|
`.SubFigure.add_subfigure`, or `.SubFigure.subfigures`. A subfigure has
|
|||
|
|
the same methods as a figure except for those particularly tied to the size
|
|||
|
|
or dpi of the figure, and is confined to a prescribed region of the figure.
|
|||
|
|
For example the following puts two subfigures side-by-side::
|
|||
|
|
|
|||
|
|
fig = plt.figure()
|
|||
|
|
sfigs = fig.subfigures(1, 2)
|
|||
|
|
axsL = sfigs[0].subplots(1, 2)
|
|||
|
|
axsR = sfigs[1].subplots(2, 1)
|
|||
|
|
|
|||
|
|
See :doc:`/gallery/subplots_axes_and_figures/subfigures`
|
|||
|
|
Nç )Ú facecolorÚ edgecolorr r@ c ó4 •— t ‰| � d i |¤Ž |€d}|€t j d }|€t j d }|| _ || _ |j | _ |j | _ |j | _ |j | _ |j | _
|
|||
|
|
|j | _ t j « | _ | j « | j
|
|||
|
|
j | _ t# | j | j
|
|||
|
|
j$ « | _ t) | j& « | _ t+ ddd||||d| j$ ¬« | _ | j/ | j, « | j, j1 d« y)
|
|||
|
|
až
|
|||
|
|
Parameters
|
|||
|
|
----------
|
|||
|
|
parent : `.Figure` or `.SubFigure`
|
|||
|
|
Figure or subfigure that contains the SubFigure. SubFigures
|
|||
|
|
can be nested.
|
|||
|
|
|
|||
|
|
subplotspec : `.gridspec.SubplotSpec`
|
|||
|
|
Defines the region in a parent gridspec where the subfigure will
|
|||
|
|
be placed.
|
|||
|
|
|
|||
|
|
facecolor : default: ``"none"``
|
|||
|
|
The figure patch face color; transparent by default.
|
|||
|
|
|
|||
|
|
edgecolor : default: :rc:`figure.edgecolor`
|
|||
|
|
The figure patch edge color.
|
|||
|
|
|
|||
|
|
linewidth : float
|
|||
|
|
The linewidth of the frame (i.e. the edge linewidth of the figure
|
|||
|
|
patch).
|
|||
|
|
|
|||
|
|
frameon : bool, default: :rc:`figure.frameon`
|
|||
|
|
If ``False``, suppress drawing the figure background patch.
|
|||
|
|
|
|||
|
|
Other Parameters
|
|||
|
|
----------------
|
|||
|
|
**kwargs : `.SubFigure` properties, optional
|
|||
|
|
|
|||
|
|
%(SubFigure:kwdoc)s
|
|||
|
|
NÚnoneúfigure.edgecolorúfigure.frameon©r r rˆ F) Úxyrê rë rw rG rH r Ú in_layoutrr rS )rZ r2 rÅ rÆ Ú _subplotspecr¦ r¥ r2 r– rí rM Ú transFigurer ÚnullÚ
|
|||
|
|
bbox_relativerÄ Úfigbboxr r r¯ r r rx r: Úset_antialiased) r# ÚparentrÒ rG rH r r@ rk rl s €r& r2 zSubFigure.__init__Á sW ø€ ôH ‰ÑÑ"˜6Ò"Ø Ð Ø ˆIØ Ð ÜŸ ™ Ð%7Ñ8ˆIØ ˆ?Ü—l‘lÐ#3Ñ4ˆGà 'ˆÔØ ˆŒ Ø "× /Ñ /ˆÔð Ÿ™ˆŒ
|
|||
|
|
Ø!×-Ñ-ˆÔØ %× 5Ñ 5ˆÔ Ø "× /Ñ /ˆÔØ!×-Ñ-ˆÔÜ !ŸY™Y›[ˆÔØ ×$Ñ$Ô&Ø—|‘|×+Ñ+ˆŒ Ü# D×$6Ñ$6Ø$(§L¡L×$?Ñ$?óAˆŒ ä -¨d¯i©iÓ 8ˆÔä ؘQ q°'Ø ¨9À à t×':Ñ':ô <ˆŒ
|
|||
|
|
ð
|
|||
|
|
|
|||
|
|
× Ñ ˜tŸz™zÔ*Ø �
|
|||
|
|
‰
|
|||
|
|
×"Ñ" 5Õ)r( c ó. — | j j S r, )r¦ rO r1 s r& rO zSubFigure.canvas s € à�|‰|×"Ñ"Ð"r( c ó. — | j j S r, ©r¦ Údpir1 s r& rZ z
|
|||
|
|
SubFigure.dpi
|
|||
|
|
s € à�|‰|× Ñ Ð r( c ó& — || j _ y r, rY )r# Úvalues r& rZ z
|
|||
|
|
SubFigure.dpi s € à ˆ� ‰ Õr( c ó. — | j j S )zY
|
|||
|
|
Return the resolution of the parent figure in dots-per-inch as a float.
|
|||
|
|
rY r1 s r& Úget_dpizSubFigure.get_dpi s € ð �|‰|× Ñ Ð r( c ó4 — || j _ d| _ y)z‚
|
|||
|
|
Set the resolution of parent figure in dots-per-inch.
|
|||
|
|
|
|||
|
|
Parameters
|
|||
|
|
----------
|
|||
|
|
val : float
|
|||
|
|
TN)r¦ rZ r" ©r# r$ s r& Úset_dpizSubFigure.set_dpi s € ð ˆ� ‰ Ô؈�
|
|||
|
|
r( c ó6 — | j j « S r, )r¦ r r1 s r& r zSubFigure._get_renderer# s € Ø�|‰|×)Ñ)Ó+Ð+r( c ó| — |�7|j | j _ |j | j _ y| j j « }t j |j « « }t j |j « « }|| j j j « |j « z }|| j j j « |j « z }|d| j j j j « |j « z }d|d| j j j j « |j « z z
|
|||
|
|
}||f| j _ ||z ||z f| j _ y)a
|
|||
|
|
Make the transSubfigure bbox relative to Figure transform.
|
|||
|
|
|
|||
|
|
Parameters
|
|||
|
|
----------
|
|||
|
|
bbox : bbox or None
|
|||
|
|
If not None, then the bbox is used for relative bounding box.
|
|||
|
|
Otherwise, it is calculated from the subplotspec.
|
|||
|
|
Nrˆ )Úp0rS Úp1rP Ú get_gridspecr ÚasarrayÚget_width_ratiosÚget_height_ratiosr¯ Úsumr¢ r¥ r¦ ) r# r¯ rE ÚwrÚhrÚdxÚdyr¹ rº s r& rÄ z!SubFigure._redo_transform_rel_fig& s_ € ð Ð Ø$(§G¡GˆD× Ñ Ô !Ø$(§G¡GˆD× Ñ Ô !Ø à
|
|||
|
|
×
|
|||
|
|
Ñ
|
|||
|
|
×
|
|||
|
|
+Ñ
|
|||
|
|
+Ó
|
|||
|
|
-ˆÜ
|
|||
|
|
�Z‰Z˜×+Ñ+Ó-Ó
|
|||
|
|
.ˆÜ
|
|||
|
|
�Z‰Z˜×,Ñ,Ó.Ó
|
|||
|
|
/ˆØ
|
|||
|
|
�×!Ñ!×)Ñ)Ñ
|
|||
|
|
*×
|
|||
|
|
.Ñ
|
|||
|
|
.Ó
|
|||
|
|
0°2·6±6³8Ñ
|
|||
|
|
;ˆØ
|
|||
|
|
�×!Ñ!×)Ñ)Ñ
|
|||
|
|
*×
|
|||
|
|
.Ñ
|
|||
|
|
.Ó
|
|||
|
|
0°2·6±6³8Ñ
|
|||
|
|
;ˆØ
|
|||
|
|
Ð0�×"Ñ"×*Ñ*×0Ñ0Ð
|
|||
|
|
1×
|
|||
|
|
5Ñ
|
|||
|
|
5Ó
|
|||
|
|
7¸"¿&¹&»(Ñ
|
|||
|
|
BˆØ
|
|||
|
|
�Ð3�T×&Ñ&×.Ñ.×3Ñ3Ð4×8Ñ8Ó:¸R¿V¹V»XÑEÑ
|
|||
|
|
EˆØ!# R ˆ×ÑÔ Ø!# b¡¨"¨r©'Ð 2ˆ×ÑÕ r( c ó6 — | j j « S ©zo
|
|||
|
|
Return whether constrained layout is being used.
|
|||
|
|
|
|||
|
|
See :ref:`constrainedlayout_guide`.
|
|||
|
|
)r¦ Úget_constrained_layoutr1 s r& rq z SubFigure.get_constrained_layout? s € ð �|‰|×2Ñ2Ó4Ð4r( c ó: — | j j |¬« S )ab
|
|||
|
|
Get padding for ``constrained_layout``.
|
|||
|
|
|
|||
|
|
Returns a list of ``w_pad, h_pad`` in inches and
|
|||
|
|
``wspace`` and ``hspace`` as fractions of the subplot.
|
|||
|
|
|
|||
|
|
See :ref:`constrainedlayout_guide`.
|
|||
|
|
|
|||
|
|
Parameters
|
|||
|
|
----------
|
|||
|
|
relative : bool
|
|||
|
|
If `True`, then convert from inches to figure relative.
|
|||
|
|
)Úrelative)r¦ Úget_constrained_layout_pads)r# rs s r& rt z%SubFigure.get_constrained_layout_padsG s € ð �|‰|×7Ñ7ÀÐ7ÓJÐJr( c ó6 — | j j « S r, )r¦ r— r1 s r& r— zSubFigure.get_layout_engineW s € Ø�|‰|×-Ñ-Ó/Ð/r( c ó — | j dd S )a–
|
|||
|
|
List of Axes in the SubFigure. You can access and modify the Axes
|
|||
|
|
in the SubFigure through this list.
|
|||
|
|
|
|||
|
|
Modifying this list has no effect. Instead, use `~.SubFigure.add_axes`,
|
|||
|
|
`~.SubFigure.add_subplot` or `~.SubFigure.delaxes` to add or remove an
|
|||
|
|
Axes.
|
|||
|
|
|
|||
|
|
Note: The `.SubFigure.axes` property and `~.SubFigure.get_axes` method
|
|||
|
|
are equivalent.
|
|||
|
|
N)ra r1 s r& r� zSubFigure.axesZ s € ð �‰™qÐ!Ð!r( c ón — | j « sy | j |« } |j d| j « ¬« | j j |« t
|
|||
|
|
j || || j d¬« j « |j d« d| _ y # d| _ w xY w)NÚ subfigure©ÚgidTr F) rý r€ Ú
|
|||
|
|
open_groupÚget_gidrx ÚdrawÚmimageÚ _draw_list_compositing_imagesr! ri Ú close_groupr" ©r# r| rb s r& r} zSubFigure.drawk s™ € ð × Ñ Ô!Ø à×(Ñ(¨Ó2ˆð Ø × Ñ °· ± ³ Ð Ô @Ø �J‰J�O‰O˜HÔ %Ü × 0Ñ 0ؘ$ ¨¯ © ¸d¨ Ó)C×)UÑ)Uô
|
|||
|
|
Wà × Ñ Ô -ð ˆD�Jø˜ˆD�Jús ¤A?B+ Â+ B4r, r< )rO rP rQ rR r2 r= rO rZ Úsetterr^ ra r rÄ rq rt r— r� ÚfgetÚget_axesr} rC rD s @r& rÑ rÑ s¥ ø„ ñð& Ø Ø Ø ö C*ðJ ñ#ó ð#ð ñ ó ð ð ‡Z�Zñ!ó ð!ò ò ò,ó3ò25óKò 0ð ñ "ó ð "ð �y‰y€Hö r( rÑ c
|
|||
|
|
ó, ‡ — e Zd ZdZ ej
|
|||
|
|
« Zd„ Zd„ Z d>dddddddddœˆ fd„ Z ˆ fd„Z
|
|||
|
|
d „ Z d?d
|
|||
|
|
„Z d „ Z
|
|||
|
|
d „ Zd@d„Zed„ « Zej$ Zed„ « Zej* d„ « Zd„ Zd„ Zd@d„Z eeed¬« Zd„ Z ej8 ddd
|
|||
|
|
¬« d„ « Z d „ Z ej8 dd d
|
|||
|
|
¬« d „ « Z ej8 dd d
|
|||
|
|
¬« d „ « Z ej8 dd!d
|
|||
|
|
¬« dAd"„« Z!d#„ Z"e#jH dBdd$œd%„« Z%dCd&„Z&d'„ Z'd(„ Z(d)„ Z)d*„ Z*d+„ Z+d@d,„Z,d@d-„Z-dAˆ fd.„ Z.e/e0d/„ « « Z1d0„ Z2d1„ Z3ˆ fd2„Z4d3„ Z5d4„ Z6dd5œd6„Z7d7d8d
|
|||
|
|
e8jr e8jt e8jv fd9„Z<dDd:„Z=d;dddd<œd=„Z>ˆ xZ?S )EÚFigureaÛ
|
|||
|
|
The top level container for all the plot elements.
|
|||
|
|
|
|||
|
|
See `matplotlib.figure` for an index of class methods.
|
|||
|
|
|
|||
|
|
Attributes
|
|||
|
|
----------
|
|||
|
|
patch
|
|||
|
|
The `.Rectangle` instance representing the figure background patch.
|
|||
|
|
|
|||
|
|
suppressComposite
|
|||
|
|
For multiple images, the figure will make composite images
|
|||
|
|
depending on the renderer option_image_nocomposite function. If
|
|||
|
|
*suppressComposite* is a boolean, this will override the renderer.
|
|||
|
|
c óF — dt | j j « z S )Nz
|
|||
|
|
Figure(%gx%g))r- r¯ rÀ r1 s r& Ú__str__zFigure.__str__� s € Ø ¤ t§y¡y§~¡~Ó!6Ñ6Ð6r( c óÖ — dj | j j | j j d | j j d t | j « ¬« S )Nz.<{clsname} size {h:g}x{w:g} with {naxes} Axes>r rˆ )ÚclsnameÚhÚwÚnaxes)Úformatrl rO r¯ rÀ r� r� r1 s r& Ú__repr__zFigure.__repr__ sR € Ø?×FÑFØ—N‘N×+Ñ+Ø�i‰i�n‰n˜QÑ 4§9¡9§>¡>°!Ñ#4Ü�d—i‘i“.ð Gó
|
|||
|
|
ð
|
|||
|
|
r( NrF )rG rH r r@ r– Ú tight_layoutÚconstrained_layoutrÿ c
|
|||
|
|
óP •— t ‰
|
|||
|
|
| � di | ¤Ž | | _ d| _ |
|
|||
|
|
�A|�t j
|
|||
|
|
d« | �t j
|
|||
|
|
d« | j
|
|||
|
|
|
|
|||
|
|
¬« nÈ|�Z| �t j
|
|||
|
|
d« | j
|
|||
|
|
d¬« t |t « r� | j « j di |¤Ž nl| �Xt | t « r3| j
|
|||
|
|
d¬« | j « j di | ¤Ž n'| r%| j
|
|||
|
|
d¬« n| j
|
|||
|
|
|
|
|||
|
|
¬« t j t j ¬« | _ | j j } | d t" j$ « | d
|
|||
|
|
t" j$ « | d
|
|||
|
|
t" j$ « | d t" j& « | d t" j& « | d
|
|||
|
|
t" j& « | dt" j& « g| _ | d | j* « | _ | d
|
|||
|
|
| j* « | _ |€t0 j2 d }|€t0 j2 d }|€t0 j2 d }|€t0 j2 d }|€t0 j2 d }t5 j6 |« j9 « r&t5 j: |« dk j= « rt? d|› �« ‚tA jB ddg|¢Ž | _" tG « jI |« | _% || _& tO | jD | jJ « | _( | jP | _) tU | jP « | _+ | jV | _, t[ ddd||||d¬« | _. | j_ | j\ « | j\ ja d« t | « |€
|
|||
|
|
tc « }|| _2 tg « | _4 | jk « y)aø
|
|||
|
|
Parameters
|
|||
|
|
----------
|
|||
|
|
figsize : 2-tuple of floats, default: :rc:`figure.figsize`
|
|||
|
|
Figure dimension ``(width, height)`` in inches.
|
|||
|
|
|
|||
|
|
dpi : float, default: :rc:`figure.dpi`
|
|||
|
|
Dots per inch.
|
|||
|
|
|
|||
|
|
facecolor : default: :rc:`figure.facecolor`
|
|||
|
|
The figure patch facecolor.
|
|||
|
|
|
|||
|
|
edgecolor : default: :rc:`figure.edgecolor`
|
|||
|
|
The figure patch edge color.
|
|||
|
|
|
|||
|
|
linewidth : float
|
|||
|
|
The linewidth of the frame (i.e. the edge linewidth of the figure
|
|||
|
|
patch).
|
|||
|
|
|
|||
|
|
frameon : bool, default: :rc:`figure.frameon`
|
|||
|
|
If ``False``, suppress drawing the figure background patch.
|
|||
|
|
|
|||
|
|
subplotpars : `~matplotlib.gridspec.SubplotParams`
|
|||
|
|
Subplot parameters. If not given, the default subplot
|
|||
|
|
parameters :rc:`figure.subplot.*` are used.
|
|||
|
|
|
|||
|
|
tight_layout : bool or dict, default: :rc:`figure.autolayout`
|
|||
|
|
Whether to use the tight layout mechanism. See `.set_tight_layout`.
|
|||
|
|
|
|||
|
|
.. admonition:: Discouraged
|
|||
|
|
|
|||
|
|
The use of this parameter is discouraged. Please use
|
|||
|
|
``layout='tight'`` instead for the common case of
|
|||
|
|
``tight_layout=True`` and use `.set_tight_layout` otherwise.
|
|||
|
|
|
|||
|
|
constrained_layout : bool, default: :rc:`figure.constrained_layout.use`
|
|||
|
|
This is equal to ``layout='constrained'``.
|
|||
|
|
|
|||
|
|
.. admonition:: Discouraged
|
|||
|
|
|
|||
|
|
The use of this parameter is discouraged. Please use
|
|||
|
|
``layout='constrained'`` instead.
|
|||
|
|
|
|||
|
|
layout : {'constrained', 'compressed', 'tight', 'none', `.LayoutEngine`, None}, default: None
|
|||
|
|
The layout mechanism for positioning of plot elements to avoid
|
|||
|
|
overlapping Axes decorations (labels, ticks, etc). Note that
|
|||
|
|
layout managers can have significant performance penalties.
|
|||
|
|
|
|||
|
|
- 'constrained': The constrained layout solver adjusts Axes sizes
|
|||
|
|
to avoid overlapping Axes decorations. Can handle complex plot
|
|||
|
|
layouts and colorbars, and is thus recommended.
|
|||
|
|
|
|||
|
|
See :ref:`constrainedlayout_guide` for examples.
|
|||
|
|
|
|||
|
|
- 'compressed': uses the same algorithm as 'constrained', but
|
|||
|
|
removes extra space between fixed-aspect-ratio Axes. Best for
|
|||
|
|
simple grids of Axes.
|
|||
|
|
|
|||
|
|
- 'tight': Use the tight layout mechanism. This is a relatively
|
|||
|
|
simple algorithm that adjusts the subplot parameters so that
|
|||
|
|
decorations do not overlap.
|
|||
|
|
|
|||
|
|
See :ref:`tight_layout_guide` for examples.
|
|||
|
|
|
|||
|
|
- 'none': Do not use a layout engine.
|
|||
|
|
|
|||
|
|
- A `.LayoutEngine` instance. Builtin layout classes are
|
|||
|
|
`.ConstrainedLayoutEngine` and `.TightLayoutEngine`, more easily
|
|||
|
|
accessible by 'constrained' and 'tight'. Passing an instance
|
|||
|
|
allows third parties to provide their own layout engine.
|
|||
|
|
|
|||
|
|
If not given, fall back to using the parameters *tight_layout* and
|
|||
|
|
*constrained_layout*, including their config defaults
|
|||
|
|
:rc:`figure.autolayout` and :rc:`figure.constrained_layout.use`.
|
|||
|
|
|
|||
|
|
Other Parameters
|
|||
|
|
----------------
|
|||
|
|
**kwargs : `.Figure` properties, optional
|
|||
|
|
|
|||
|
|
%(Figure:kwdoc)s
|
|||
|
|
NzdThe Figure parameters 'layout' and 'tight_layout' cannot be used together. Please use 'layout' only.zjThe Figure parameters 'layout' and 'constrained_layout' cannot be used together. Please use 'layout' only.)rÿ ztThe Figure parameters 'tight_layout' and 'constrained_layout' cannot be used together. Please use 'layout' parameterÚtightÚ constrained)ÚsignalsÚkey_press_eventÚkey_release_eventÚbutton_press_eventÚbutton_release_eventÚ scroll_eventÚmotion_notify_eventúfigure.figsizez
|
|||
|
|
figure.dpizfigure.facecolorrK rL r ú(figure size must be positive finite not rM rˆ F)rN rê rë rw rG rH r rO rS )6rZ r2 r¥ Ú_layout_enginer‹ r‡ Úset_layout_enginer r@ r— rj r^ rd r
|
|||
|
|
ÚeventsÚ_canvas_callbacksÚ_connect_picklabler Ú _key_handlerÚ_mouse_handlerÚ_mouse_key_idsÚpickÚ_button_pick_idÚ_scroll_pick_idrÅ rÆ r r r� Úarrayr r; r Ú from_boundsrè r Úscalerí Ú_dpir r¯ rT r rQ r r rx r: rU r r– r* r2 rc )r# ÚfigsizerZ rG rH r r@ r– r� r‘ rÿ rk Úconnectrl s €r& r2 zFigure.__init__§ s¨ ø€ ô@ ‰ÑÑ"˜6Ò"Ø ˆÔØ "ˆÔà Ð Ø Ð(Ü×"Ñ"ðBôCð #Ð.Ü×"Ñ"ðIôJð
|
|||
|
|
× "Ñ "¨&Ð "Õ 1Ø
|
|||
|
|
Ð
|
|||
|
|
%Ø!Ð-Ü×"Ñ"ð)ô*ð
|
|||
|
|
× "Ñ "¨'Ð "Ô 2ܘ,¬Ô-Ø,�×&Ñ&Ó(×,Ñ,Ñ<¨|Ó<Ø
|
|||
|
|
Ð
|
|||
|
|
+ÜÐ,¬dÔ3Ø×&Ñ&¨mÐ&Ô<Ø,�×&Ñ&Ó(×,Ñ,ÑBÐ/AÓBÙ#Ø×&Ñ&¨mÐ&Õ<ð
|
|||
|
|
× "Ñ "¨&Ð "Ô 1ô
|
|||
|
|
"'×!7Ñ!7Ü$×+Ñ+ô"-ˆÔ à×(Ñ(×;Ñ;ˆá Ð%¤}×'AÑ'AÓ BÙ Ð'¬ ×)CÑ)CÓ DÙ Ð'¬ ×)CÑ)CÓ DÙ Ð(¬-×*FÑ*FÓ GÙ Ð*¬M×,HÑ,HÓ IÙ �N¤M×$@Ñ$@Ó AÙ Ð)¬=×+GÑ+GÓ Hð
|
|||
|
|
ˆÔñ 'Ð';¸T¿Y¹YÓ GˆÔ Ù & ~°t·y±yÓ AˆÔ à ˆ?Ü—l‘lÐ#3Ñ4ˆGØ ˆ;Ü—,‘,˜|Ñ,ˆCØ Ð ÜŸ ™ Ð%7Ñ8ˆIØ Ð ÜŸ ™ Ð%7Ñ8ˆIØ ˆ?Ü—l‘lÐ#3Ñ4ˆGä�{‰{˜7Ó#×'Ñ'Ô)¬b¯h©h°wÓ.?À!Ñ.C×-HÑ-HÔ-JÜ Ð GØ '˜yð *ó +ð
|
|||
|
|
+ä ×+Ñ+¨A¨qÐ;°7Ò;ˆÔä '›z× /Ñ /°Ó 4ˆÔ àˆŒ Ü# D×$4Ñ$4°d×6JÑ6JÓKˆŒ Ø—y‘yˆŒ Ü*¨4¯9©9Ó5ˆÔØ "× .Ñ .ˆÔä ؘQ q°'Ø ¨9À àô ˆŒ
|
|||
|
|
ð
|
|||
|
|
|
|||
|
|
× Ñ ˜tŸz™zÔ*Ø �
|
|||
|
|
‰
|
|||
|
|
×"Ñ" 5Ô)ä˜Ô à Ð Ü'›/ˆKà&ˆÔä"› ˆŒ
|
|||
|
|
Ø �
|
|||
|
|
‰
|
|||
|
|
� r( c ón •— | j j j « st ‰| � |« y y r, )rO Ú
|
|||
|
|
widgetlockÚlockedrZ r¦ )r# r± rl s €r& r¦ z Figure.picke
|
|||
|
|
s* ø€ Ø�{‰{×%Ñ%×,Ñ,Ô.Ü ‰G‰L˜Õ $ð /r( c ó€ — |�|€y|j |j k( ry| j D ] }t |d« sŒ y y)zÂ
|
|||
|
|
Helper for set_layout engine
|
|||
|
|
|
|||
|
|
If the figure has used the old engine and added a colorbar then the
|
|||
|
|
value of colorbar_gridspec must be the same on the new engine.
|
|||
|
|
TÚ _colorbarF)r‚ r� r{ )r# ÚoldÚnewr} s r& Ú _check_layout_engines_compatz#Figure._check_layout_engines_compati
|
|||
|
|
sN € ð ˆ;˜#˜+ØØ × Ñ C×$9Ñ$9Ò 9Øð —)‘)ò ˆBÜ�r˜;Õ'á ð ð r( c ó
|
|||
|
|
— |€4t j d rd}n t j d rd}nd| _ y|dk( r t d i |¤Ž}nŽ|dk( r t d i |¤Ž}n}|dk( rt d ddi|¤Ž}nj|d k( rD| j �5t | j j | j j « }n$d}n!t |t « r|}nt d
|
|||
|
|
|›�« ‚| j | j |« r|| _ yt d « ‚)
|
|||
|
|
aÑ
|
|||
|
|
Set the layout engine for this figure.
|
|||
|
|
|
|||
|
|
Parameters
|
|||
|
|
----------
|
|||
|
|
layout : {'constrained', 'compressed', 'tight', 'none', `.LayoutEngine`, None}
|
|||
|
|
|
|||
|
|
- 'constrained' will use `~.ConstrainedLayoutEngine`
|
|||
|
|
- 'compressed' will also use `~.ConstrainedLayoutEngine`, but with
|
|||
|
|
a correction that attempts to make a good layout for fixed-aspect
|
|||
|
|
ratio Axes.
|
|||
|
|
- 'tight' uses `~.TightLayoutEngine`
|
|||
|
|
- 'none' removes layout engine.
|
|||
|
|
|
|||
|
|
If a `.LayoutEngine` instance, that instance will be used.
|
|||
|
|
|
|||
|
|
If `None`, the behavior is controlled by :rc:`figure.autolayout`
|
|||
|
|
(which if `True` behaves as if 'tight' was passed) and
|
|||
|
|
:rc:`figure.constrained_layout.use` (which if `True` behaves as if
|
|||
|
|
'constrained' was passed). If both are `True`,
|
|||
|
|
:rc:`figure.autolayout` takes priority.
|
|||
|
|
|
|||
|
|
Users and libraries can define their own layout engines and pass
|
|||
|
|
the instance directly as well.
|
|||
|
|
|
|||
|
|
**kwargs
|
|||
|
|
The keyword arguments are passed to the layout engine to set things
|
|||
|
|
like padding and margin sizes. Only used if *layout* is a string.
|
|||
|
|
|
|||
|
|
Núfigure.autolayoutr“ ú figure.constrained_layout.user” Ú
|
|||
|
|
compressedÚcompressTrJ z Invalid value for 'layout': zzColorbar layout of new layout engine not compatible with old engine, and a colorbar has been created. Engine not changed.rS )
|
|||
|
|
rÅ rÆ rž r r r r˜ r‚ r r r; r¶ r )r# rÿ rk Únew_layout_engines r& rŸ zFigure.set_layout_engine|
|
|||
|
|
s( € ð> ˆ>Ü�|‰|Ð /Ò0Ø ‘Ü— ‘ Ð =Ò>Ø&‘à&*�Ô#ØØ �WÒ Ü 1Ñ ;°FÑ ;Ñ Ø
|
|||
|
|
�}Ò
|
|||
|
|
$Ü 7Ñ A¸&Ñ AÑ Ø
|
|||
|
|
�|Ò
|
|||
|
|
#Ü 7ñ !BÀð !BØ:@ñ!BÑ à
|
|||
|
|
�vÒ
|
|||
|
|
Ø×"Ñ"Ð.Ü$;Ø×'Ñ'×9Ñ9Ø×'Ñ'×9Ñ9ó%Ñ!ð
|
|||
|
|
%)Ñ!Ü
|
|||
|
|
˜¤ Ô
|
|||
|
|
-Ø &Ñ ä Ð ;¸F¸:Ð FÓGÐ Gà × ,Ñ ,¨T×-@Ñ-@Ø->ô @à"3ˆDÕ ä ð Hó Ið
|
|||
|
|
Ir( c ó — | j S r, )rž r1 s r& r— zFigure.get_layout_engine¿
|
|||
|
|
s € Ø×"Ñ"Ð"r( c ót — dt | j « j v rddlm} |j | « S y )NÚWebAggr )Úbackend_webagg)ÚtyperO rO Úmatplotlib.backendsrÀ Úipython_inline_display)r# rÀ s r& Ú _repr_html_zFigure._repr_html_Æ
|
|||
|
|
s4 € ð ”t˜DŸK™KÓ(×1Ñ1Ñ 1Ý :Ø!×8Ñ8¸Ó>Ð >ð 2r( Tc ó — | j j € t d« ‚ | j j j « y# t $ r/}|r#t j t |« « Y d}~yY d}~yd}~ww xY w)a¼
|
|||
|
|
If using a GUI backend with pyplot, display the figure window.
|
|||
|
|
|
|||
|
|
If the figure was not created using `~.pyplot.figure`, it will lack
|
|||
|
|
a `~.backend_bases.FigureManagerBase`, and this method will raise an
|
|||
|
|
AttributeError.
|
|||
|
|
|
|||
|
|
.. warning::
|
|||
|
|
|
|||
|
|
This does not manage an GUI event loop. Consequently, the figure
|
|||
|
|
may only be shown briefly or not shown at all if you or your
|
|||
|
|
environment are not managing an event loop.
|
|||
|
|
|
|||
|
|
Use cases for `.Figure.show` include running this from a GUI
|
|||
|
|
application (where there is persistently an event loop running) or
|
|||
|
|
from a shell, like IPython, that install an input hook to allow the
|
|||
|
|
interactive shell to accept input while the figure is also being
|
|||
|
|
shown and interactive. Some, but not all, GUI toolkits will
|
|||
|
|
register an input hook on import. See :ref:`cp_integration` for
|
|||
|
|
more details.
|
|||
|
|
|
|||
|
|
If you're in a shell without input hook integration or executing a
|
|||
|
|
python script, you should use `matplotlib.pyplot.show` with
|
|||
|
|
``block=True`` instead, which takes care of starting and running
|
|||
|
|
the event loop for you.
|
|||
|
|
|
|||
|
|
Parameters
|
|||
|
|
----------
|
|||
|
|
warn : bool, default: True
|
|||
|
|
If ``True`` and we are not running headless (i.e. on Linux with an
|
|||
|
|
unset DISPLAY), issue warning when called on a non-GUI backend.
|
|||
|
|
|
|||
|
|
NzYFigure.show works only for figures managed by pyplot, normally created by pyplot.figure())rO ÚmanagerÚAttributeErrorÚshowr r‹ r‡ r0 )r# ÚwarnÚexcs r& rÈ z Figure.showÍ
|
|||
|
|
so € ðD �;‰;× Ñ Ð &Ü ð6ó7ð
|
|||
|
|
7ð -Ø �K‰K× Ñ × $Ñ $Õ &øÜ ò -ÙÜ×"Ñ"¤3 s£8×,Ñ,ô ûð -ús £$A Á B Á A;Á;B c ó6 — | j j « S )as
|
|||
|
|
List of Axes in the Figure. You can access and modify the Axes in the
|
|||
|
|
Figure through this list.
|
|||
|
|
|
|||
|
|
Do not modify the list itself. Instead, use `~Figure.add_axes`,
|
|||
|
|
`~.Figure.add_subplot` or `~.Figure.delaxes` to add or remove an Axes.
|
|||
|
|
|
|||
|
|
Note: The `.Figure.axes` property and `~.Figure.get_axes` method are
|
|||
|
|
equivalent.
|
|||
|
|
)r2 r4 r1 s r& r� z Figure.axesù
|
|||
|
|
s € ð �}‰}×$Ñ$Ó&Ð&r( c óH — t | d« r | j S t d« ‚)z5The figure id, used to identify figures in `.pyplot`.Ú_numberze'Figure' object has no attribute 'number'. In the future thiswill change to returning 'None' instead.)r{ rÍ rÇ r1 s r& Únumberz
|
|||
|
|
Figure.number s* € ô �4˜Ô #Ø—<‘<Ð ä ð;ó<ð
|
|||
|
|
<r( c ó@ — t j dd¬« || _ y )Nr¢ zcChanging 'Figure.number' is deprecated since %(since)s and will raise an error starting %(removal)sr£ )r‹ r§ rÍ )r# Únums r& rÎ z
|
|||
|
|
Figure.number s" € ä × Ñ Ø ð?õ @ð ˆ� r( c óx — t | j d« r| j j « S t | « S )NÚ get_renderer)r{ rO rÒ r r1 s r& r zFigure._get_renderer' s. € Ü �4—;‘; Ô /Ø—;‘;×+Ñ+Ó-Ð -ä Ó&Ð &r( c ó — | j S r, )r¬ r1 s r& Ú_get_dpizFigure._get_dpi- s € Ø�y‰yÐr( c óÒ — || j k( ry|| _ | j j « j |« | j « \ }}| j |||¬« y)z�
|
|||
|
|
Parameters
|
|||
|
|
----------
|
|||
|
|
dpi : float
|
|||
|
|
|
|||
|
|
forward : bool
|
|||
|
|
Passed on to `~.Figure.set_size_inches`
|
|||
|
|
N©Úforward)r¬ rí rc r« Úget_size_inchesÚset_size_inches)r# rZ r× rŒ r‹ s r& Ú_set_dpizFigure._set_dpi0 s^ € ð �$—)‘)Ò à ؈Œ Ø × Ñ ×"Ñ"Ó$×*Ñ*¨3Ô/Ø×#Ñ#Ó%‰ˆˆ1Ø × Ñ ˜Q ¨7Ð Õ3r( z The resolution in dots per inch.r« c ó> — t | j « t « S )z=Return whether `.Figure.tight_layout` is called when drawing.)r r— r r1 s r& Úget_tight_layoutzFigure.get_tight_layoutC s € ä˜$×0Ñ0Ó2Ô4EÓFÐFr( z3.6rŸ )Ú alternativeÚpendingc ó¨ — |€t j d }t |« rdnd}t |t « r|ni } | j
|
|||
|
|
|fi |¤Ž d| _ y)aÊ
|
|||
|
|
Set whether and how `.Figure.tight_layout` is called when drawing.
|
|||
|
|
|
|||
|
|
Parameters
|
|||
|
|
----------
|
|||
|
|
tight : bool or dict with keys "pad", "w_pad", "h_pad", "rect" or None
|
|||
|
|
If a bool, sets whether to call `.Figure.tight_layout` upon drawing.
|
|||
|
|
If ``None``, use :rc:`figure.autolayout` instead.
|
|||
|
|
If a dict, pass it as kwargs to `.Figure.tight_layout`, overriding the
|
|||
|
|
default paddings.
|
|||
|
|
Nr¸ r“ rJ T©rÅ rÆ r1 r r@ rŸ r" )r# r“ Ú_tightÚ_tight_parameterss r& Úset_tight_layoutzFigure.set_tight_layoutG sS € ð ˆ=Ü—L‘LÐ!4Ñ5ˆEÜ œK‘¨VˆÜ%/°´tÔ%<™EÀ"ÐØ ˆ× Ñ ˜vÑ;Ð):Ò;؈�
|
|||
|
|
r( c ó> — t | j « t « S rp )r r— r r1 s r& rq z Figure.get_constrained_layout\ s € ô ˜$×0Ñ0Ó2Ô4KÓLÐLr( z set_layout_engine('constrained')c ó¨ — |€t j d }t |« rdnd}t |t « r|ni } | j
|
|||
|
|
|fi |¤Ž d| _ y)aý
|
|||
|
|
Set whether ``constrained_layout`` is used upon drawing.
|
|||
|
|
|
|||
|
|
If None, :rc:`figure.constrained_layout.use` value will be used.
|
|||
|
|
|
|||
|
|
When providing a dict containing the keys ``w_pad``, ``h_pad``
|
|||
|
|
the default ``constrained_layout`` paddings will be
|
|||
|
|
overridden. These pads are in inches and default to 3.0/72.0.
|
|||
|
|
``w_pad`` is the width padding and ``h_pad`` is the height padding.
|
|||
|
|
|
|||
|
|
Parameters
|
|||
|
|
----------
|
|||
|
|
constrained : bool or dict or None
|
|||
|
|
Nr¹ r” rJ Trà )r# r” Ú _constrainedÚ _parameterss r& Úset_constrained_layoutz Figure.set_constrained_layoutd sS € ð" Ð Ü Ÿ,™,Ð'FÑGˆKÜ(,¨[Ô(9‘}¸vˆ Ü%/° ¼TÔ%B‘kȈ Ø ˆ× Ñ ˜|Ñ;¨{Ò;؈�
|
|||
|
|
r( z figure.get_layout_engine().set()c ó‚ — t | j « t « r! | j « j di |¤Ž yy)aS
|
|||
|
|
Set padding for ``constrained_layout``.
|
|||
|
|
|
|||
|
|
Tip: The parameters can be passed from a dictionary by using
|
|||
|
|
``fig.set_constrained_layout(**pad_dict)``.
|
|||
|
|
|
|||
|
|
See :ref:`constrainedlayout_guide`.
|
|||
|
|
|
|||
|
|
Parameters
|
|||
|
|
----------
|
|||
|
|
w_pad : float, default: :rc:`figure.constrained_layout.w_pad`
|
|||
|
|
Width padding in inches. This is the pad around Axes
|
|||
|
|
and is meant to make sure there is enough room for fonts to
|
|||
|
|
look good. Defaults to 3 pts = 0.04167 inches
|
|||
|
|
|
|||
|
|
h_pad : float, default: :rc:`figure.constrained_layout.h_pad`
|
|||
|
|
Height padding in inches. Defaults to 3 pts.
|
|||
|
|
|
|||
|
|
wspace : float, default: :rc:`figure.constrained_layout.wspace`
|
|||
|
|
Width padding between subplots, expressed as a fraction of the
|
|||
|
|
subplot width. The total padding ends up being w_pad + wspace.
|
|||
|
|
|
|||
|
|
hspace : float, default: :rc:`figure.constrained_layout.hspace`
|
|||
|
|
Height padding between subplots, expressed as a fraction of the
|
|||
|
|
subplot width. The total padding ends up being h_pad + hspace.
|
|||
|
|
|
|||
|
|
NrS )r r— r rj )r# rk s r& Úset_constrained_layout_padsz"Figure.set_constrained_layout_pads| s: € ô> �d×,Ñ,Ó.Ô0GÔ HØ (ˆD× "Ñ "Ó $× (Ñ (Ñ 2¨6Ó 2ð Ir( z fig.get_layout_engine().get()c ó< — t | j « t « sy| j « j « }|d }|d }|d }|d }|rD|€|�@| j « }|j
|
|||
|
|
}||z |j z }||z |j z }||||fS )a¥
|
|||
|
|
Get padding for ``constrained_layout``.
|
|||
|
|
|
|||
|
|
Returns a list of ``w_pad, h_pad`` in inches and
|
|||
|
|
``wspace`` and ``hspace`` as fractions of the subplot.
|
|||
|
|
All values are None if ``constrained_layout`` is not used.
|
|||
|
|
|
|||
|
|
See :ref:`constrainedlayout_guide`.
|
|||
|
|
|
|||
|
|
Parameters
|
|||
|
|
----------
|
|||
|
|
relative : bool
|
|||
|
|
If `True`, then convert from inches to figure relative.
|
|||
|
|
)NNNNÚw_padÚh_padrš r› )r r— r r r rZ rê rë ) r# rs rÒ rì rí rš r› r| rZ s r& rt z"Figure.get_constrained_layout_padsž s € ô" ˜$×0Ñ0Ó2Ô4KÔLØ)Ø×%Ñ%Ó'×+Ñ+Ó-ˆØ�W‘
|
|||
|
|
ˆØ�W‘
|
|||
|
|
ˆØ�h‘ ˆØ�h‘ ˆá ˜Ð*¨eÐ.?Ø×)Ñ)Ó+ˆHØ—,‘,ˆCؘC‘K (§.¡.Ñ0ˆEؘC‘K (§/¡/Ñ1ˆEà�e˜V VÐ+Ð+r( c ó — || _ y)z~
|
|||
|
|
Set the canvas that contains the figure
|
|||
|
|
|
|||
|
|
Parameters
|
|||
|
|
----------
|
|||
|
|
canvas : FigureCanvas
|
|||
|
|
N)rO )r# rO s r& Ú
|
|||
|
|
set_canvaszFigure.set_canvas¿ s € ð ˆ� r( )Ú colorizerc
|
|||
|
|
ó — |
|
|||
|
|
rQ| j « }
|
|||
|
|
|j d |j d fD �cg c] }||
|
|||
|
|
z ‘Œ }}| j |d¬« t j | f||| ||| dœ| ¤Ž}t
|
|||
|
|
|_ |j |« |j |« |€&|j | ||¬« |j ||« | j j |« | j j |_ d| _ |S c c}w )ai
|
|||
|
|
Add a non-resampled image to the figure.
|
|||
|
|
|
|||
|
|
The image is attached to the lower or upper left corner depending on
|
|||
|
|
*origin*.
|
|||
|
|
|
|||
|
|
Parameters
|
|||
|
|
----------
|
|||
|
|
X
|
|||
|
|
The image data. This is an array of one of the following shapes:
|
|||
|
|
|
|||
|
|
- (M, N): an image with scalar data. Color-mapping is controlled
|
|||
|
|
by *cmap*, *norm*, *vmin*, and *vmax*.
|
|||
|
|
- (M, N, 3): an image with RGB values (0-1 float or 0-255 int).
|
|||
|
|
- (M, N, 4): an image with RGBA values (0-1 float or 0-255 int),
|
|||
|
|
i.e. including transparency.
|
|||
|
|
|
|||
|
|
xo, yo : int
|
|||
|
|
The *x*/*y* image offset in pixels.
|
|||
|
|
|
|||
|
|
alpha : None or float
|
|||
|
|
The alpha blending value.
|
|||
|
|
|
|||
|
|
%(cmap_doc)s
|
|||
|
|
|
|||
|
|
This parameter is ignored if *X* is RGB(A).
|
|||
|
|
|
|||
|
|
%(norm_doc)s
|
|||
|
|
|
|||
|
|
This parameter is ignored if *X* is RGB(A).
|
|||
|
|
|
|||
|
|
%(vmin_vmax_doc)s
|
|||
|
|
|
|||
|
|
This parameter is ignored if *X* is RGB(A).
|
|||
|
|
|
|||
|
|
origin : {'upper', 'lower'}, default: :rc:`image.origin`
|
|||
|
|
Indicates where the [0, 0] index of the array is in the upper left
|
|||
|
|
or lower left corner of the Axes.
|
|||
|
|
|
|||
|
|
resize : bool
|
|||
|
|
If *True*, resize the figure to match the given image size.
|
|||
|
|
|
|||
|
|
%(colorizer_doc)s
|
|||
|
|
|
|||
|
|
This parameter is ignored if *X* is RGB(A).
|
|||
|
|
|
|||
|
|
Returns
|
|||
|
|
-------
|
|||
|
|
`matplotlib.image.FigureImage`
|
|||
|
|
|
|||
|
|
Other Parameters
|
|||
|
|
----------------
|
|||
|
|
**kwargs
|
|||
|
|
Additional kwargs are `.Artist` kwargs passed on to `.FigureImage`.
|
|||
|
|
|
|||
|
|
Notes
|
|||
|
|
-----
|
|||
|
|
figimage complements the Axes image (`~matplotlib.axes.Axes.imshow`)
|
|||
|
|
which will be resampled to fit the current Axes. If you want
|
|||
|
|
a resampled image to fill the entire figure, you can define an
|
|||
|
|
`~matplotlib.axes.Axes` with extent [0, 0, 1, 1].
|
|||
|
|
|
|||
|
|
Examples
|
|||
|
|
--------
|
|||
|
|
::
|
|||
|
|
|
|||
|
|
f = plt.figure()
|
|||
|
|
nx = int(f.get_figwidth() * f.dpi)
|
|||
|
|
ny = int(f.get_figheight() * f.dpi)
|
|||
|
|
data = np.random.random((ny, nx))
|
|||
|
|
f.figimage(data)
|
|||
|
|
plt.show()
|
|||
|
|
rˆ r TrÖ )ÚcmapÚnormrð ÚoffsetxÚoffsetyÚorigin)ÚvminÚvmax)r^ r rÙ r~ Ú FigureImager' r5 Ú set_arrayÚ set_alphaÚ _check_exclusionary_keywordsÚset_climrf r r9 rÏ r" )r# ÚXÚxoÚyoÚalpharó rò r÷ rø rö Úresizerð rk rZ rW r rØ s r& ÚfigimagezFigure.figimageÉ s € ñZ Ø—,‘,“.ˆCØ)*¯©°©°Q·W±W¸Q±ZÐ(@ÖA 1�q˜3“wÐAˆGÐAØ × Ñ °$Ð Ô 7ä
|
|||
|
|
×
|
|||
|
|
Ñ
|
|||
|
|
ð 9¨4°dØ*3Ø(*°BØ'-ñ9ð 28ñ9ˆô 3ˆÔà
|
|||
|
|
� ‰ �QŒØ
|
|||
|
|
� ‰ �UÔØ ˆ<Ø × +Ñ +¨I¸DÀtÐ +Ô LØ �K‰K˜˜dÔ #Ø � ‰ ×ј2Ô Ø ŸK™K× .Ñ .ˆÔ؈Œ
|
|||
|
|
؈ ùò# Bs ³ Dc óŠ — |€|\ }}t j ||g« }t j |« j « r|dk j « rt d|› �« ‚|| j _ |rG| j j }|�/ |j || j z j t « Ž d| _ y)aH
|
|||
|
|
Set the figure size in inches.
|
|||
|
|
|
|||
|
|
Call signatures::
|
|||
|
|
|
|||
|
|
fig.set_size_inches(w, h) # OR
|
|||
|
|
fig.set_size_inches((w, h))
|
|||
|
|
|
|||
|
|
Parameters
|
|||
|
|
----------
|
|||
|
|
w : (float, float) or float
|
|||
|
|
Width and height in inches (if height not specified as a separate
|
|||
|
|
argument) or width.
|
|||
|
|
h : float
|
|||
|
|
Height in inches.
|
|||
|
|
forward : bool, default: True
|
|||
|
|
If ``True``, the canvas size is automatically updated, e.g.,
|
|||
|
|
you can resize the figure window from the shell.
|
|||
|
|
|
|||
|
|
See Also
|
|||
|
|
--------
|
|||
|
|
matplotlib.figure.Figure.get_size_inches
|
|||
|
|
matplotlib.figure.Figure.set_figwidth
|
|||
|
|
matplotlib.figure.Figure.set_figheight
|
|||
|
|
|
|||
|
|
Notes
|
|||
|
|
-----
|
|||
|
|
To transform from pixels to inches divide by `Figure.dpi`.
|
|||
|
|
Nr r� T)r r© r r� r r; rè re rO rÆ r rZ Úastyper/ r" )r# rŒ r‹ r× rÀ rÆ s r& rÙ zFigure.set_size_inches+ s§ € ð<
|
|||
|
|
ˆ9؉DˆAˆqÜ�x‰x˜˜A˜Ó ˆÜ�{‰{˜4Ó ×$Ñ$Ô&¨4°!©8¯.©.Ô*:Ü Ð GÈÀvÐ NÓOÐ OØ "ˆ×ÑÔÙ Ø—k‘k×)Ñ)ˆGØÐ"Ø �—‘ ¨¯©¡ × 8Ñ 8¼Ó =Ñ>؈�
|
|||
|
|
r( c óT — t j | j j « S )aË
|
|||
|
|
Return the current size of the figure in inches.
|
|||
|
|
|
|||
|
|
Returns
|
|||
|
|
-------
|
|||
|
|
ndarray
|
|||
|
|
The size (width, height) of the figure in inches.
|
|||
|
|
|
|||
|
|
See Also
|
|||
|
|
--------
|
|||
|
|
matplotlib.figure.Figure.set_size_inches
|
|||
|
|
matplotlib.figure.Figure.get_figwidth
|
|||
|
|
matplotlib.figure.Figure.get_figheight
|
|||
|
|
|
|||
|
|
Notes
|
|||
|
|
-----
|
|||
|
|
The size in pixels can be obtained by multiplying with `Figure.dpi`.
|
|||
|
|
)r r© rè re r1 s r& rØ zFigure.get_size_inchesU s € ô& �x‰x˜×(Ñ(×+Ñ+Ó,Ð,r( c ó. — | j j S )z"Return the figure width in inches.)rè rê r1 s r& Ú get_figwidthzFigure.get_figwidthj s € à× Ñ ×%Ñ%Ð%r( c ó. — | j j S )z#Return the figure height in inches.)rè rë r1 s r& Ú
|
|||
|
|
get_figheightzFigure.get_figheightn s € à× Ñ ×&Ñ&Ð&r( c ó — | j S )z2Return the resolution in dots per inch as a float.)rZ r1 s r& r^ zFigure.get_dpir s € à�x‰xˆr( c ó — || _ d| _ y)z
|
|||
|
|
Set the resolution of the figure in dots-per-inch.
|
|||
|
|
|
|||
|
|
Parameters
|
|||
|
|
----------
|
|||
|
|
val : float
|
|||
|
|
TN)rZ r" r` s r& ra zFigure.set_dpiv s € 𠈌؈�
|
|||
|
|
r( c óH — | j || j « |¬« y)a0
|
|||
|
|
Set the width of the figure in inches.
|
|||
|
|
|
|||
|
|
Parameters
|
|||
|
|
----------
|
|||
|
|
val : float
|
|||
|
|
forward : bool
|
|||
|
|
See `set_size_inches`.
|
|||
|
|
|
|||
|
|
See Also
|
|||
|
|
--------
|
|||
|
|
matplotlib.figure.Figure.set_figheight
|
|||
|
|
matplotlib.figure.Figure.set_size_inches
|
|||
|
|
rÖ N)rÙ r
|
|||
|
|
©r# r$ r× s r& Ú set_figwidthzFigure.set_figwidth� s" € ð
|
|||
|
|
× Ñ ˜S $×"4Ñ"4Ó"6ÀÐ ÕHr( c óH — | j | j « ||¬« y)a0
|
|||
|
|
Set the height of the figure in inches.
|
|||
|
|
|
|||
|
|
Parameters
|
|||
|
|
----------
|
|||
|
|
val : float
|
|||
|
|
forward : bool
|
|||
|
|
See `set_size_inches`.
|
|||
|
|
|
|||
|
|
See Also
|
|||
|
|
--------
|
|||
|
|
matplotlib.figure.Figure.set_figwidth
|
|||
|
|
matplotlib.figure.Figure.set_size_inches
|
|||
|
|
rÖ N)rÙ r r s r& Ú
|
|||
|
|
set_figheightzFigure.set_figheight’ s" € ð
|
|||
|
|
× Ñ ˜T× .Ñ .Ó 0°#¸wÐ ÕGr( c óx •— t ‰| � |¬« | j j }|�|j « y y )Nra )rZ rc rO ÚtoolbarrK )r# rb r rl s €r& rc z Figure.clear£ s7 ø€ ä
|
|||
|
|
‰‰
|
|||
|
|
^ˆ
|
|||
|
|
Ô4ð —+‘+×%Ñ%ˆØ Ð Ø �N‰NÕ ð r( c óp — | j « sy | j 5 | j |« } |j d| j « ¬« | j
|
|||
|
|
r0| j
|
|||
|
|
« � | j
|
|||
|
|
« j | « | j j |« t j || || j « |j d« d| _ t! d| j" |« j% « d d d « y # t $ r Y ŒŽw xY w# d| _ w xY w# 1 sw Y y xY w)Nr' ry FÚ
|
|||
|
|
draw_event)rý Ú _render_lockr€ r{ r| r� r— Úexecuter; rx r} r~ r ri r€ r" r rO Ú_processr� s r& r} z Figure.draw¬ s € ð × Ñ Ô!Ø à
|
|||
|
|
×
|
|||
|
|
Ñ
|
|||
|
|
ñ Fà×,Ñ,¨XÓ6ˆGð
|