jdZddlmZmZmZddlmZmZmZm Z ddl m Z  ddl m Z n!#e$rddlZejd dZ YnwxYwGd d ZeZeeje eeee e ee n[ d Zdd ZejZejedS)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.eZdZdZdZdZefdZdZdS)ProjectionRegistryz?A mapping of registered projection names to projection classes.ci|_dSN)_all_projection_typesselfs MC:\Projects\DSCons\.venv\Lib\site-packages\matplotlib\projections\__init__.py__init__zProjectionRegistry.__init__Hs%'"""c2|D]}|j}||j|<dS)z"Register a new set of projections.N)namer)r projections projectionrs rregisterzProjectionRegistry.registerKs2% : :J?D/9D &t , , : :rc:tj|j||S)z'Get a projection class from its *name*.) _error_clsr)rgetitem_checkedr)rrrs rget_projection_classz'ProjectionRegistry.get_projection_classQs&#D$>:/3555 5rc*t|jS)z9Return the names of all projections currently registered.)sortedrrs rget_projection_namesz'ProjectionRegistry.get_projection_namesVsd0111rN) __name__ __module__ __qualname____doc__rrKeyErrorr r#rrrrEs`II(((::: 5=5555 22222rrc:t|dSr)projection_registryr)clss rregister_projectionr-ks  %%%%%rcL|d}t|tS)z| Get a projection class from its name. If *projection* is None, a standard rectilinear projection is returned. N rectilinear)r)r+r ValueError)rs rr r os( "  3 3J: 3 V VVr)projection_namesr)r'rrrgeorrr r polarr mpl_toolkits.mplot3dr Exceptionwarningswarnrr+rAxesr-r r#interpdr)rrr;s44l&%%%%%%%%%CCCCCCCCCCCC+++++++OOOHMOPPPFFF 22222222,)(**I     (((( &&& W W W W+? -A-A-C-CDDDDDs'AA