^jsdZddlmZmZmZddlmZmZmZm Z ddl m Z  ddl m Z Gd d ZeZej'ej(e eeee e ej'e n[ d Zdd Zej.Zej0j'ey#e$rddlZej d dZ YwxYw)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. )_apiaxes _docstring) AitoffAxes HammerAxes LambertAxes MollweideAxes) PolarAxes)Axes3DNzUnable to import Axes3D. This may be due to multiple versions of Matplotlib being installed (e.g. as a system package and as a pip package). As a result, the 3D projection is not available.c,eZdZdZdZdZefdZdZy)ProjectionRegistryz?A mapping of registered projection names to projection classes.ci|_yN)_all_projection_typesselfs X/opt/ringagent/.cad-venv/lib/python3.12/site-packages/matplotlib/projections/__init__.py__init__zProjectionRegistry.__init__Hs %'"cH|D]}|j}||j|<y)z"Register a new set of projections.N)namer)r projections projectionrs rregisterzProjectionRegistry.registerKs*% :J??D/9D & &t , :rcFtj|j||S)z'Get a projection class from its *name*.) _error_clsr)rgetitem_checkedr)rrrs rget_projection_classz'ProjectionRegistry.get_projection_classQs"##D$>$>:/35 5rc,t|jS)z9Return the names of all projections currently registered.)sortedrrs rget_projection_namesz'ProjectionRegistry.get_projection_namesVsd0011rN) __name__ __module__ __qualname____doc__rrKeyErrorr r#rrrrEsI(: 5=5 2rrc.tj|yr)projection_registryr)clss rregister_projectionr-ks  %rc@|d}tj|tS)z| Get a projection class from its name. If *projection* is None, a standard rectilinear projection is returned. rectilinear)r)r+r ValueError)rs rr r os% "  3 3J: 3 VVr)projection_namesr)r'rrrgeorrr r polarr mpl_toolkits.mplot3dr Exceptionwarningswarnrr+rAxesr-r r#interpdr)rrr;s4l&%CC+22,)*II     ( & W+?? -A-CDHMMOPF sB!!CC