a Sic @sdZddlmZmZddlmZmZmZmZddl m Z ddl m Z Gdd d Z e Zeeje eeeee d d Zdd dZejZejjedd 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@s0eZdZdZddZddZddZdd Zd S) ProjectionRegistryz?A mapping of registered projection names to projection classes.cCs i|_dSN_all_projection_typesselfr[/var/www/html/django/DPS/env/lib/python3.9/site-packages/matplotlib/projections/__init__.py__init__@szProjectionRegistry.__init__cGs|D]}|j}||j|<qdS)z"Register a new set of projections.N)namer)r projections projectionrrrrregisterCszProjectionRegistry.registercCs |j|S)z'Get a projection class from its *name*.r)rrrrrget_projection_classIsz'ProjectionRegistry.get_projection_classcCs t|jS)z9Return the names of all projections currently registered.)sortedrrrrrget_projection_namesMsz'ProjectionRegistry.get_projection_namesN)__name__ __module__ __qualname____doc__rrrrrrrrr =s r cCst|dSr )projection_registryr)clsrrrregister_projection^sr"Nc CsP|dur d}z t|WStyJ}ztd||WYd}~n d}~00dS)z| Get a projection class from its name. If *projection* is None, a standard rectilinear projection is returned. N rectilinearzUnknown projection %r)r rKeyError ValueError)rerrrrrrbs  r)Zprojection_names)N)rrrZgeorrrrpolarr Zmpl_toolkits.mplot3dr r r rAxesr"rrinterpdupdaterrrrs&6