§ (ý?ežã ó—dZddlmZmZddlmZmZmZmZddl m Z ddl m Z Gd„d ¦«Z e ¦«Ze eje eeeee ¦«d „Zdd „ZejZej e¦«¬ ¦«d S)a Non-separable transforms that map from data space to screen space. Projections are defined as `~.axes.Axes` subclasses. They include the following elements: - A transformation from data coordinates into display coordinates. - An inverse of that transformation. This is used, for example, to convert mouse positions from screen space back into data space. - Transformations for the gridlines, ticks and ticklabels. Custom projections will often need to place these elements in special locations, and Matplotlib has a facility to help with doing so. - Setting up default values (overriding `~.axes.Axes.cla`), since the defaults for a rectilinear axes may not be appropriate. - Defining the shape of the axes, for example, an elliptical axes, that will be used to draw the background of the plot and for clipping any data elements. - Defining custom locators and formatters for the projection. For example, in a geographic projection, it may be more convenient to display the grid in degrees, even if the data is in radians. - Set up interactive panning and zooming. This is left as an "advanced" feature left to the reader, but there is an example of this for polar plots in `matplotlib.projections.polar`. - Any additional methods for additional convenience or features. Once the projection axes is defined, it can be used in one of two ways: - By defining the class attribute ``name``, the projection axes can be registered with `matplotlib.projections.register_projection` and subsequently simply invoked by name:: fig.add_subplot(projection="my_proj_name") - For more complex, parameterisable projections, a generic "projection" object may be defined which includes the method ``_as_mpl_axes``. ``_as_mpl_axes`` should take no arguments and return the projection's axes subclass and a dictionary of additional arguments to pass to the subclass' ``__init__`` method. Subsequently a parameterised projection can be initialised with:: fig.add_subplot(projection=MyProjection(param1=param1_value)) where MyProjection is an object which implements a ``_as_mpl_axes`` method. A full-fledged and heavily annotated example is in :doc:`/gallery/misc/custom_projection`. The polar plot functionality in `matplotlib.projections.polar` may also be of interest. é)ÚaxesÚ _docstringé)Ú AitoffAxesÚ HammerAxesÚ LambertAxesÚ MollweideAxes)Ú PolarAxesé)ÚAxes3Dcó*—eZdZdZd„Zd„Zd„Zd„ZdS)ÚProjectionRegistryz?A mapping of registered projection names to projection classes.có—i|_dS©N©Ú_all_projection_types©Úselfs ú?lib/python3.11/site-packages/matplotlib/projections/__init__.pyÚ__init__zProjectionRegistry.__init__@s€Ø%'ˆÔ"Ð"Ð"ócó2—|D]}|j}||j|<ŒdS)z"Register a new set of projections.N)Únamer)rÚ projectionsÚ projectionrs rÚregisterzProjectionRegistry.registerCs2€à%ð :ð :ˆJØ”?ˆDØ/9ˆDÔ & tÑ ,Ð ,ð :ð :rcó—|j|S)z'Get a projection class from its *name*.r)rrs rÚget_projection_classz'ProjectionRegistry.get_projection_classIs€àÔ)¨$Ô/Ð/rcó*—t|j¦«S)z9Return the names of all projections currently registered.)Úsortedrrs rÚget_projection_namesz'ProjectionRegistry.get_projection_namesMs€ådÔ0Ñ1Ô1Ð1rN)Ú__name__Ú __module__Ú __qualname__Ú__doc__rrrr!©rrrr=sV€€€€€ØIÐIð(ð(ð(ð:ð:ð:ð 0ð0ð0ð2ð2ð2ð2ð2rrcó:—t |¦«dSr)Úprojection_registryr)Úclss rÚregister_projectionr*^s€Ý× Ò  Ñ%Ô%Ð%Ð%Ð%rNcóŠ—|€d} t |¦«S#t$r}td|z¦«|‚d}~wwxYw)z| Get a projection class from its name. If *projection* is None, a standard rectilinear projection is returned. NÚ rectilinearzUnknown projection %r)r(rÚKeyErrorÚ ValueError)rÚerrs rrrbsb€ð ÐØ"ˆ ðHÝ"×7Ò7¸ ÑCÔCÐCøÝ ðHðHðHÝÐ0°:Ñ=Ñ>Ô>ÀCÐGøøøøðHøøøs†   Aª=½A)Úprojection_namesr)r%ÚrrÚgeorrrr Úpolarr Úmpl_toolkits.mplot3dr rr(rÚAxesr*rr!ÚinterpdÚupdater&rrúr8s6ðð4ð4ðl ÐÐÐÐÐÐÐØCÐCÐCÐCÐCÐCÐCÐCÐCÐCÐCÐCØÐÐÐÐÐØ'Ð'Ð'Ð'Ð'Ð'ð2ð2ð2ð2ð2ñ2ô2ð2ð*)Ð(Ñ*Ô*ÐØ×ÒØ„IØ ØØØØØ ñôðð&ð&ð&ð Hð Hð Hð Hð+Ô?ÐØ Ô×ÒÐ+?Ð+?Ñ+AÔ+AÐÑBÔBÐBÐBÐBr