o o h?:@s`ddlmZmZddlmZddlmZddgiZdaddZ d d Z d d Z Gd ddZ dS)) BaseSeriesGenericDataSeriessympy_deprecation_warning) is_sequence) Plot.append Plot.extend matplotlibTcCsdadS)z/ Disable show(). For use in the tests. FN)_showr r x/var/www/html/construction_image-detection-poc/venv/lib/python3.10/site-packages/sympy/plotting/backends/base_backend.py unset_showsr cCs"td|d|ddddddS)NzThe `z` property is deprecated. The `z` keyword argument should be passed to a plotting function, which generates the appropriate data series. If needed, index the plot object to retrieve a specific data series.z1.13z.deprecated-markers-annotations-fill-rectangles)deprecated_since_versionactive_deprecations_target stacklevelr)attrr r r _deprecation_msg_m_a_r_fs  rcKstgd}g}|D]/}||g}|durg}t|tr|g}|D]}|dg}|t|g|Ri|q q|S)N) annotationsmarkersfill rectanglesargs)pop isinstancedictappendr)kwargskeywordsserieskw dictionariesdrr r r _create_generic_data_series"s   r#c@s eZdZdZddddddddddddddddddddd d d Zed d ZeddZddZddZ ddZ ddZ ddZ ddZ ddZddZd d!Zed"d#Zejd$d#Zed%d&Zejd'd&Zed(d)Zejd*d)Zed+d,Zejd-d,ZdS).PlotaBase class for all backends. A backend represents the plotting library, which implements the necessary functionalities in order to use SymPy plotting functions. For interactive work the function :func:`plot` is better suited. This class permits the plotting of SymPy expressions using numerous backends (:external:mod:`matplotlib`, textplot, the old pyglet module for SymPy, Google charts api, etc). The figure can contain an arbitrary number of plots of SymPy expressions, lists of coordinates of points, etc. Plot has a private attribute _series that contains all data series to be plotted (expressions for lines or surfaces, lists of points, etc (all subclasses of BaseSeries)). Those data series are instances of classes not imported by ``from sympy import *``. The customization of the figure is on two levels. Global options that concern the figure as a whole (e.g. title, xlabel, scale, etc) and per-data series options (e.g. name) and aesthetics (e.g. color, point shape, line type, etc.). The difference between options and aesthetics is that an aesthetic can be a function of the coordinates (or parameters in a parametric plot). The supported values for an aesthetic are: - None (the backend uses default values) - a constant - a function of one variable (the first coordinate or parameter) - a function of two variables (the first and second coordinate or parameters) - a function of three variables (only in nonparametric 3D plots) Their implementation depends on the backend so they may not work in some backends. If the plot is parametric and the arity of the aesthetic function permits it the aesthetic is calculated over parameters and not over coordinates. If the arity does not permit calculation over parameters the calculation is done over coordinates. Only cartesian coordinates are supported for the moment, but you can use the parametric plots to plot in polar, spherical and cylindrical coordinates. The arguments for the constructor Plot must be subclasses of BaseSeries. Any global option can be specified as a keyword argument. The global options for a figure are: - title : str - xlabel : str or Symbol - ylabel : str or Symbol - zlabel : str or Symbol - legend : bool - xscale : {'linear', 'log'} - yscale : {'linear', 'log'} - axis : bool - axis_center : tuple of two floats or {'center', 'auto'} - xlim : tuple of two floats - ylim : tuple of two floats - aspect_ratio : tuple of two floats or {'auto'} - autoscale : bool - margin : float in [0, 1] - backend : {'default', 'matplotlib', 'text'} or a subclass of BaseBackend - size : optional tuple of two floats, (width, height); default: None The per data series options and aesthetics are: There are none in the base series. See below for options for subclasses. Some data series support additional aesthetics or options: :class:`~.LineOver1DRangeSeries`, :class:`~.Parametric2DLineSeries`, and :class:`~.Parametric3DLineSeries` support the following: Aesthetics: - line_color : string, or float, or function, optional Specifies the color for the plot, which depends on the backend being used. For example, if ``MatplotlibBackend`` is being used, then Matplotlib string colors are acceptable (``"red"``, ``"r"``, ``"cyan"``, ``"c"``, ...). Alternatively, we can use a float number, 0 < color < 1, wrapped in a string (for example, ``line_color="0.5"``) to specify grayscale colors. Alternatively, We can specify a function returning a single float value: this will be used to apply a color-loop (for example, ``line_color=lambda x: math.cos(x)``). Note that by setting line_color, it would be applied simultaneously to all the series. Options: - label : str - steps : bool - integers_only : bool :class:`~.SurfaceOver2DRangeSeries` and :class:`~.ParametricSurfaceSeries` support the following: Aesthetics: - surface_color : function which returns a float. Notes ===== How the plotting module works: 1. Whenever a plotting function is called, the provided expressions are processed and a list of instances of the :class:`~sympy.plotting.series.BaseSeries` class is created, containing the necessary information to plot the expressions (e.g. the expression, ranges, series name, ...). Eventually, these objects will generate the numerical data to be plotted. 2. A subclass of :class:`~.Plot` class is instantiaed (referred to as backend, from now on), which stores the list of series and the main attributes of the plot (e.g. axis labels, title, ...). The backend implements the logic to generate the actual figure with some plotting library. 3. When the ``show`` command is executed, series are processed one by one to generate numerical data and add it to the figure. The backend is also going to set the axis labels, title, ..., according to the values stored in the Plot instance. The backend should check if it supports the data series that it is given (e.g. :class:`TextBackend` supports only :class:`~sympy.plotting.series.LineOver1DRangeSeries`). It is the backend responsibility to know how to use the class of data series that it's given. Note that the current implementation of the ``*Series`` classes is "matplotlib-centric": the numerical data returned by the ``get_points`` and ``get_meshes`` methods is meant to be used directly by Matplotlib. Therefore, the new backend will have to pre-process the numerical data to make it compatible with the chosen plotting library. Keep in mind that future SymPy versions may improve the ``*Series`` classes in order to return numerical data "non-matplotlib-centric", hence if you code a new backend you have the responsibility to check if its working on each SymPy release. Please explore the :class:`MatplotlibBackend` source code to understand how a backend should be coded. In order to be used by SymPy plotting functions, a backend must implement the following methods: * show(self): used to loop over the data series, generate the numerical data, plot it and set the axis labels, title, ... * save(self, path): used to save the current plot to the specified file path. * close(self): used to close the current plot backend (note: some plotting library does not support this functionality. In that case, just raise a warning). NautoTlinearFrdefault)titlexlabelylabelzlabel aspect_ratioxlimylim axis_centeraxisxscaleyscalelegend autoscalemarginrrrrbackendsizecs|_|_|_|_|_|_| _| _| _| _ | _ |_ |_ |_ |_|_g_j|jt||||dddddfdd}d_|d|d_|d|d_|d |dS) N)rrrrcStdd|DS)Ncs|] }t|ddVqdS)is_realTNgetattr.0ir r r 2Plot.__init__....alllimr r r zPlot.__init__..cSr8)Ncsr9) is_finiteTNr;r=r r r r@rArBrCrEr r r rGrHcs\|r,|std|||std||t|t|dt|dfdSdS)Nz#All numbers from {}={} must be realz%All numbers from {}={} must be finiter) ValueErrorformatsetattrfloat)t_nametrIr:selfr r check_and_sets  $z$Plot.__init__..check_and_setr-r.r7)r(r)r*r+r,r/r0r1r2r3r4r5 _annotations_markers _rectangles_fill_seriesextendr#r-r.r7)rRr(r)r*r+r,r-r.r/r0r1r2r3r4r5rrrrr6r7rrrSr rQr __init__sB    z Plot.__init__cCs|SNr rRr r r _backendsz Plot._backendcCst|Sr[)typer\r r r r6 sz Plot.backendcCs"ddt|jD}dd|S)NcSs g|] \}}d|t|qS)z[%d]: )str)r>r?sr r r sz Plot.__str__..zPlot object containing:  ) enumeraterXjoin)rR series_strsr r r __str__sz Plot.__str__cCs |j|Sr[rXrRindexr r r __getitem__s zPlot.__getitem__cGs0t|dkrt|dtr||j|<dSdSdS)NrJr)lenrrrX)rRrirr r r __setitem__szPlot.__setitem__cCs |j|=dSr[rgrhr r r __delitem__s zPlot.__delitem__cCs"t|tr |j|dStd)aEAdds an element from a plot's series to an existing plot. Examples ======== Consider two ``Plot`` objects, ``p1`` and ``p2``. To add the second plot's first series object to the first, use the ``append`` method, like so: .. plot:: :format: doctest :include-source: True >>> from sympy import symbols >>> from sympy.plotting import plot >>> x = symbols('x') >>> p1 = plot(x*x, show=False) >>> p2 = plot(x, show=False) >>> p1.append(p2[0]) >>> p1 Plot object containing: [0]: cartesian line: x**2 for x over (-10.0, 10.0) [1]: cartesian line: x for x over (-10.0, 10.0) >>> p1.show() See Also ======== extend z'Must specify element of plot to append.N)rrrXr TypeErrorrRargr r r rs rcCs<t|tr|j|jdSt|r|j|dStd)aAdds all series from another plot. Examples ======== Consider two ``Plot`` objects, ``p1`` and ``p2``. To add the second plot to the first, use the ``extend`` method, like so: .. plot:: :format: doctest :include-source: True >>> from sympy import symbols >>> from sympy.plotting import plot >>> x = symbols('x') >>> p1 = plot(x**2, show=False) >>> p2 = plot(x, -x, show=False) >>> p1.extend(p2) >>> p1 Plot object containing: [0]: cartesian line: x**2 for x over (-10.0, 10.0) [1]: cartesian line: x for x over (-10.0, 10.0) [2]: cartesian line: -x for x over (-10.0, 10.0) >>> p1.show() z(Expecting Plot or sequence of BaseSeriesN)rr$rXrYrrnror r r rYDs rcCtr[NotImplementedErrorr\r r r showfz Plot.showcCrqr[rr)rRpathr r r saveiruz Plot.savecCrqr[rrr\r r r closelruz Plot.closecCtd|jS).. deprecated:: 1.13r)rrUr\r r r rqz Plot.markerscC$td|jt|d||_dS)rzr)rN)rrXrYr#rUrRvr r r rw cCry)rzr)rrTr\r r r r~r{zPlot.annotationscCr|)rzr)rN)rrXrYr#rTr}r r r rrcCry)rzr)rrVr\r r r rr{zPlot.rectanglescCr|)rzr)rN)rrXrYr#rVr}r r r rrcCry)rzr)rrWr\r r r rr{z Plot.fillcCr|)rzr)rN)rrXrYr#rWr}r r r rr)__name__ __module__ __qualname____doc__rZpropertyr]r6rfrjrlrmrrYrtrwrxrsetterrrrr r r r r$1sL  :  %"       r$N) sympy.plotting.seriesrrsympy.utilities.exceptionsrsympy.utilities.iterablesr__doctest_requires__r r rr#r$r r r r s