
    ٔ j O                     ~   d dl Z d dlZd dlZd dlZd dlZd dlZd dlmZ d dl	m
Z
 d dlmZ ddlmZ ddlmZmZmZmZ g dZ e j        ej        d	
          Z	 	 ddddZ ee          	 	 dddd            Z	 	 ddZ ee          	 	 dd            Z	 	 ddZ ee          dd            Zd Zd ZddZdS )    N)	overrides)_array_converter)add_docstring   )numeric)
asanyarraynanndimresult_type)logspacelinspace	geomspacenumpy)module)devicec                
    | |fS N )startstopnumendpointretstepdtypeaxisr   s           mC:\Users\Terasoftware\OneDrive\Desktop\faahhh\fyndo\fyndo\venv\Lib\site-packages\numpy/_core/function_base.py_linspace_dispatcherr          4=    2   TFc                   t          j        |          }|dk     rt          d| d          |r|dz
  n|}t          | |          }	|	                                \  } }|	                    d          }
||
}d}nt          j        |t          j                  }t          j
        || t          |
          	          }t          j        d||
|
                              ddt          |          z  z             }|dk    rnt          j        |          }||z  }|r|dk    n)t          j        |dk                                              }|r||z  }|r||z  }n ||z  }n|r||z  }n||z  }nt$          }||z  }|| z  }|r|dk    r||d<   |dk    rt          j        |d|          }|rt          j        ||           |	                    |                    |d                    }|r||fS |S )a  
    Return evenly spaced numbers over a specified interval.

    Returns `num` evenly spaced samples, calculated over the
    interval [`start`, `stop`].

    The endpoint of the interval can optionally be excluded.

    .. versionchanged:: 1.20.0
        Values are rounded towards ``-inf`` instead of ``0`` when an
        integer ``dtype`` is specified. The old behavior can
        still be obtained with ``np.linspace(start, stop, num).astype(int)``

    Parameters
    ----------
    start : array_like
        The starting value of the sequence.
    stop : array_like
        The end value of the sequence, unless `endpoint` is set to False.
        In that case, the sequence consists of all but the last of ``num + 1``
        evenly spaced samples, so that `stop` is excluded.  Note that the step
        size changes when `endpoint` is False.
    num : int, optional
        Number of samples to generate. Default is 50. Must be non-negative.
    endpoint : bool, optional
        If True, `stop` is the last sample. Otherwise, it is not included.
        Default is True.
    retstep : bool, optional
        If True, return (`samples`, `step`), where `step` is the spacing
        between samples.
    dtype : dtype, optional
        The type of the output array.  If `dtype` is not given, the data type
        is inferred from `start` and `stop`. The inferred dtype will never be
        an integer; `float` is chosen even if the arguments would produce an
        array of integers.
    axis : int, optional
        The axis in the result to store the samples.  Relevant only if start
        or stop are array-like.  By default (0), the samples will be along a
        new axis inserted at the beginning. Use -1 to get an axis at the end.
    device : str, optional
        The device on which to place the created array. Default: None.
        For Array-API interoperability only, so must be ``"cpu"`` if passed.

        .. versionadded:: 2.0.0

    Returns
    -------
    samples : ndarray
        There are `num` equally spaced samples in the closed interval
        ``[start, stop]`` or the half-open interval ``[start, stop)``
        (depending on whether `endpoint` is True or False).
    step : float, optional
        Only returned if `retstep` is True

        Size of spacing between samples.


    See Also
    --------
    arange : Similar to `linspace`, but uses a step size (instead of the
             number of samples).
    geomspace : Similar to `linspace`, but with numbers spaced evenly on a log
                scale (a geometric progression).
    logspace : Similar to `geomspace`, but with the end points specified as
               logarithms.
    :ref:`how-to-partition`

    Examples
    --------
    >>> import numpy as np
    >>> np.linspace(2.0, 3.0, num=5)
    array([2.  , 2.25, 2.5 , 2.75, 3.  ])
    >>> np.linspace(2.0, 3.0, num=5, endpoint=False)
    array([2. ,  2.2,  2.4,  2.6,  2.8])
    >>> np.linspace(2.0, 3.0, num=5, retstep=True)
    (array([2.  ,  2.25,  2.5 ,  2.75,  3.  ]), 0.25)

    Graphical illustration:

    >>> import matplotlib.pyplot as plt
    >>> N = 8
    >>> y = np.zeros(N)
    >>> x1 = np.linspace(0, 10, N, endpoint=True)
    >>> x2 = np.linspace(0, 10, N, endpoint=False)
    >>> plt.plot(x1, y, 'o')
    [<matplotlib.lines.Line2D object at 0x...>]
    >>> plt.plot(x2, y + 0.5, 'o')
    [<matplotlib.lines.Line2D object at 0x...>]
    >>> plt.ylim([-0.5, 1])
    (-0.5, 1)
    >>> plt.show()

    r   zNumber of samples, z, must be non-negative.r   T)ensure_inexactNF)r   )r   r   ))r   )r#   .)outcopy)operatorindex
ValueErrorr   	as_arraysr   _nx
issubdtypeintegernpsubtracttypearangereshaper
   isscalarr   anyr	   moveaxisfloorwrapastype)r   r   r   r   r   r   r   r   divconvdtinteger_dtypedeltay_mult_inplacestepany_step_zeros                    r   r   r      sZ   @ .

C
Qw 
>#>>>
 
 	
  
(377SCE4((D..""KE4					.	.B ;uck:: Ke488444E
	3b	 	 	gedT%[[(())  Qw U++s{&KDAIICN419,E,E,I,I,K,K 	 
	HA U
I 	IAADAA IJA C!G '
qy %LAt$$ 	!		!((5u(--..A $wr   c                     | ||fS r   r   )r   r   r   r   baser   r   s          r   _logspace_dispatcherrD      s    4r         $@c                    t          |t          t          f          sZt          j        |          rFt          j        | ||          j        fd| ||fD             \  } }}t          j        ||          }t          | ||||          }|t          j	        ||          S t          j	        ||          
                    |d          S )a  
    Return numbers spaced evenly on a log scale.

    In linear space, the sequence starts at ``base ** start``
    (`base` to the power of `start`) and ends with ``base ** stop``
    (see `endpoint` below).

    .. versionchanged:: 1.25.0
        Non-scalar 'base` is now supported

    Parameters
    ----------
    start : array_like
        ``base ** start`` is the starting value of the sequence.
    stop : array_like
        ``base ** stop`` is the final value of the sequence, unless `endpoint`
        is False.  In that case, ``num + 1`` values are spaced over the
        interval in log-space, of which all but the last (a sequence of
        length `num`) are returned.
    num : integer, optional
        Number of samples to generate.  Default is 50.
    endpoint : boolean, optional
        If true, `stop` is the last sample. Otherwise, it is not included.
        Default is True.
    base : array_like, optional
        The base of the log space. The step size between the elements in
        ``ln(samples) / ln(base)`` (or ``log_base(samples)``) is uniform.
        Default is 10.0.
    dtype : dtype
        The type of the output array.  If `dtype` is not given, the data type
        is inferred from `start` and `stop`. The inferred type will never be
        an integer; `float` is chosen even if the arguments would produce an
        array of integers.
    axis : int, optional
        The axis in the result to store the samples.  Relevant only if start,
        stop, or base are array-like.  By default (0), the samples will be
        along a new axis inserted at the beginning. Use -1 to get an axis at
        the end.

    Returns
    -------
    samples : ndarray
        `num` samples, equally spaced on a log scale.

    See Also
    --------
    arange : Similar to linspace, with the step size specified instead of the
             number of samples. Note that, when used with a float endpoint, the
             endpoint may or may not be included.
    linspace : Similar to logspace, but with the samples uniformly distributed
               in linear space, instead of log space.
    geomspace : Similar to logspace, but with endpoints specified directly.
    :ref:`how-to-partition`

    Notes
    -----
    If base is a scalar, logspace is equivalent to the code

    >>> y = np.linspace(start, stop, num=num, endpoint=endpoint)
    ... # doctest: +SKIP
    >>> power(base, y).astype(dtype)
    ... # doctest: +SKIP

    Examples
    --------
    >>> import numpy as np
    >>> np.logspace(2.0, 3.0, num=4)
    array([ 100.        ,  215.443469  ,  464.15888336, 1000.        ])
    >>> np.logspace(2.0, 3.0, num=4, endpoint=False)
    array([100.        ,  177.827941  ,  316.22776602,  562.34132519])
    >>> np.logspace(2.0, 3.0, num=4, base=2.0)
    array([4.        ,  5.0396842 ,  6.34960421,  8.        ])
    >>> np.logspace(2.0, 3.0, num=4, base=[2.0, 3.0], axis=-1)
    array([[ 4.        ,  5.0396842 ,  6.34960421,  8.        ],
           [ 9.        , 12.98024613, 18.72075441, 27.        ]])

    Graphical illustration:

    >>> import matplotlib.pyplot as plt
    >>> N = 10
    >>> x1 = np.logspace(0.1, 1, N, endpoint=True)
    >>> x2 = np.logspace(0.1, 1, N, endpoint=False)
    >>> y = np.zeros(N)
    >>> plt.plot(x1, y, 'o')
    [<matplotlib.lines.Line2D object at 0x...>]
    >>> plt.plot(x2, y + 0.5, 'o')
    [<matplotlib.lines.Line2D object at 0x...>]
    >>> plt.ylim([-0.5, 1])
    (-0.5, 1)
    >>> plt.show()

    c              3   H   K   | ]}t          j        |d d          V  d S )NT)r&   subokndmin)r.   array).0andmaxs     r   	<genexpr>zlogspace.<locals>.<genexpr>'  sJ       
 
 HQTU;;;
 
 
 
 
 
r   )r   )r   r   r   NFr%   )
isinstancefloatintr.   r
   	broadcastexpand_dimsr   r+   powerr8   )	r   r   r   r   rC   r   r   r>   rM   s	           @r   r   r      s    ~ dUCL)) /bgdmm / UD$//4
 
 
 
T4(
 
 
tT ~d...#tDDDA "yq!!!9T1$$U$777r   c                 
    | |fS r   r   )r   r   r   r   r   r   s         r   _geomspace_dispatcherrV   2  r   r   c           	         t          |           } t          |          }t          j        | dk              st          j        |dk              rt          d          t	          | |t          |          t          j        d|                    }||}nt          j        |          }|                     |d          } |                    |d          }t          j	        |           }| |z  } ||z  }t          j
        |           }t          j
        |          }	t          ||	||d|          }
|dk    r| |
d<   |d	k    r|r||
d
<   |
|z  }
|dk    rt          j        |
d|          }
|
                    |d          S )a@  
    Return numbers spaced evenly on a log scale (a geometric progression).

    This is similar to `logspace`, but with endpoints specified directly.
    Each output sample is a constant multiple of the previous.

    Parameters
    ----------
    start : array_like
        The starting value of the sequence.
    stop : array_like
        The final value of the sequence, unless `endpoint` is False.
        In that case, ``num + 1`` values are spaced over the
        interval in log-space, of which all but the last (a sequence of
        length `num`) are returned.
    num : integer, optional
        Number of samples to generate.  Default is 50.
    endpoint : boolean, optional
        If true, `stop` is the last sample. Otherwise, it is not included.
        Default is True.
    dtype : dtype
        The type of the output array.  If `dtype` is not given, the data type
        is inferred from `start` and `stop`. The inferred dtype will never be
        an integer; `float` is chosen even if the arguments would produce an
        array of integers.
    axis : int, optional
        The axis in the result to store the samples.  Relevant only if start
        or stop are array-like.  By default (0), the samples will be along a
        new axis inserted at the beginning. Use -1 to get an axis at the end.

    Returns
    -------
    samples : ndarray
        `num` samples, equally spaced on a log scale.

    See Also
    --------
    logspace : Similar to geomspace, but with endpoints specified using log
               and base.
    linspace : Similar to geomspace, but with arithmetic instead of geometric
               progression.
    arange : Similar to linspace, with the step size specified instead of the
             number of samples.
    :ref:`how-to-partition`

    Notes
    -----
    If the inputs or dtype are complex, the output will follow a logarithmic
    spiral in the complex plane.  (There are an infinite number of spirals
    passing through two points; the output will follow the shortest such path.)

    Examples
    --------
    >>> import numpy as np
    >>> np.geomspace(1, 1000, num=4)
    array([    1.,    10.,   100.,  1000.])
    >>> np.geomspace(1, 1000, num=3, endpoint=False)
    array([   1.,   10.,  100.])
    >>> np.geomspace(1, 1000, num=4, endpoint=False)
    array([   1.        ,    5.62341325,   31.6227766 ,  177.827941  ])
    >>> np.geomspace(1, 256, num=9)
    array([   1.,    2.,    4.,    8.,   16.,   32.,   64.,  128.,  256.])

    Note that the above may not produce exact integers:

    >>> np.geomspace(1, 256, num=9, dtype=int)
    array([  1,   2,   4,   7,  16,  32,  63, 127, 256])
    >>> np.around(np.geomspace(1, 256, num=9)).astype(int)
    array([  1,   2,   4,   8,  16,  32,  64, 128, 256])

    Negative, decreasing, and complex inputs are allowed:

    >>> np.geomspace(1000, 1, num=4)
    array([1000.,  100.,   10.,    1.])
    >>> np.geomspace(-1000, -1, num=4)
    array([-1000.,  -100.,   -10.,    -1.])
    >>> np.geomspace(1j, 1000j, num=4)  # Straight line
    array([0.   +1.j, 0.  +10.j, 0. +100.j, 0.+1000.j])
    >>> np.geomspace(-1+0j, 1+0j, num=5)  # Circle
    array([-1.00000000e+00+1.22464680e-16j, -7.07106781e-01+7.07106781e-01j,
            6.12323400e-17+1.00000000e+00j,  7.07106781e-01+7.07106781e-01j,
            1.00000000e+00+0.00000000e+00j])

    Graphical illustration of `endpoint` parameter:

    >>> import matplotlib.pyplot as plt
    >>> N = 10
    >>> y = np.zeros(N)
    >>> plt.semilogx(np.geomspace(1, 1000, N, endpoint=True), y + 1, 'o')
    [<matplotlib.lines.Line2D object at 0x...>]
    >>> plt.semilogx(np.geomspace(1, 1000, N, endpoint=False), y + 2, 'o')
    [<matplotlib.lines.Line2D object at 0x...>]
    >>> plt.axis([0.5, 2000, 0, 3])
    [0.5, 2000, 0, 3]
    >>> plt.grid(True, color='0.7', linestyle='-', which='both', axis='both')
    >>> plt.show()

    r   z&Geometric sequence cannot include zeror   NTr%   rE   )r   r   rC   r   r   r#   F)r   r+   r4   r)   r   rP   zerosr   r8   signlog10r   r5   )r   r   r   r   r   r   r;   out_sign	log_startlog_stopresults              r   r   r   7  s   H uEdD
wuz Ccgdai00 CABBB	UD%**ciE.B.B	C	CB ! 	%  
 LL$L''E;;r;%%D
 xH	XE(?D	%  IyHis'd"> > >F
 Qw q	7 	x 	F2J
hFqy /fa..==U=+++r   c                     d}t          | t          j        t          j        t          f          rdS t          | t
                    r| j        |z  rdS dS )z
    Returns true if the only way to set the docstring of `obj` from python is
    via add_docstring.

    This function errs on the side of being overly conservative.
    i   FT)rO   typesFunctionType
MethodTypepropertyr0   	__flags__)objPy_TPFLAGS_HEAPTYPEs     r   _needs_add_docstringrg     sY     !#*E,<hGHH u#t 1D!D u4r   c                     |r/t          |           s t          j        d|  dt          d           t	          j        |          }	 t          | |           d S # t          $ r Y d S w xY w)Nz,add_newdoc was used on a pure-python object z-. Prefer to attach it directly to the source.   )
stacklevel)rg   warningswarnUserWarninginspectcleandocr   	Exception)re   docwarn_on_pythons      r   _add_docstringrs     s     2377 :3 : : :		 	 	 	 
3

Cc3   s   A 
A'&A'c                    t          t          | t                      i |g          |          }t          |t                    r,d|v rt          j        ||          }t          |||           dS t          |t                    r&|\  }}t          t          ||          ||           dS t          |t                    r'|D ]&\  }}t          t          ||          ||           %dS dS )a"  
    Add documentation to an existing object, typically one defined in C

    The purpose is to allow easier editing of the docstrings without requiring
    a re-compile. This exists primarily for internal use within numpy itself.

    Parameters
    ----------
    place : str
        The absolute name of the module to import from
    obj : str | None
        The name of the object to add documentation to, typically a class or
        function name.
    doc : str | tuple[str, str] | list[tuple[str, str]]
        If a string, the documentation to apply to `obj`

        If a tuple, then the first element is interpreted as an attribute
        of `obj` and the second as the docstring to apply -
        ``(method, docstring)``

        If a list, then each element of the list should be a tuple of length
        two - ``[(method1, docstring1), (method2, docstring2), ...]``
    warn_on_python : bool
        If True, the default, emit `UserWarning` if this is used to attach
        documentation to a pure-python object.

    Notes
    -----
    This routine never raises an error if the docstring can't be written, but
    will raise an error if the object being documented does not exist.

    This routine cannot modify read-only docstrings, as appear
    in new-style classes or built-in functions. Because this
    routine never raises an error the caller must check manually
    that the docstrings were changed.

    Since this function grabs the ``char *`` from a c-level str object and puts
    it into the ``tp_doc`` slot of the type of `obj`, it violates a number of
    C-API best-practices, by:

    - modifying a `PyTypeObject` after calling `PyType_Ready`
    - calling `Py_INCREF` on the str and losing the reference, so the str
      will never be released

    If possible it should be avoided.
    z${ARRAY_FUNCTION_LIKE}N)
getattr
__import__globalsrO   strr   get_array_function_like_docrs   tuplelist)placere   rq   rr   newattr	docstrings          r   
add_newdocr     s   ^ *UGIIrC5993
?
?C#s 	J#s* 	B7SAACsC00000	C		 JiwsD))9nEEEEE	C		 J" 	J 	JOD)73--y.IIIIJ J	J 	Jr   )NNNNN)r    TFNr   )r    TrE   Nr   )NNNN)r    TNr   )T) 	functoolsrn   r'   r`   rk   r   r.   numpy._corer   numpy._core._multiarray_umathr   numpy._core.multiarrayr    r   r+   r   r	   r
   r   __all__partialarray_function_dispatchr   r   rD   r   rV   r   rg   rs   r   r   r   r   <module>r      s6               ! ! ! ! ! ! : : : : : : 0 0 0 0 0 0       7 7 7 7 7 7 7 7 7 7 7 7
/
/
/ ,)+%g7 7 7  HL*.:>    
 -..FJ`#` ` ` ` /.`F EI*.   
 -..BFj8 j8 j8 /.j8Z GK#   
 .//M, M, M, 0/M,`  $   9J 9J 9J 9J 9J 9Jr   