B
    ddJ                 @   s  d Z ddlmZmZ ddlmZ ddlmZmZm	Z	m
Z
 ddlmZ ddlmZmZ ddlmZ ddlmZmZ ed(d
dZdd Zdd Zdd Zdd Zdd Zdd Zdd Zdd Zdd Zdd Zd d! Z d"d# Z!G d$d% d%Z"eG d&d' d'eZ#d	S ))z@Tools and arithmetics for monomials of distributed polynomials.     )combinations_with_replacementproduct)dedent)MulSTuplesympify)ExactQuotientFailed)PicklableWithSlotsdict_from_expr)public)is_sequenceiterableNc             #   s  t | }t r~t  |kr$tddkr8dg| n@tsJtdn.t |kr^tdtdd D rxtdd}n: }|dk rtd	dkrd}ndk rtd
}d}|r,||krdS | r|dkrtjV  dS t| tjg } tdd | D rg }x|t| |D ]n}t	 }	x| D ]}
d|	|
< q&W x(|D ] }
|
dkr>|	|
  d7  < q>W t
|	 |kr|t|  qW t|E dH  ng }x~t| |dD ]n}t	 }	x| D ]}
d|	|
< qW x(|D ] }
|
dkr|	|
  d7  < qW t
|	 |kr|t|  qW t|E dH  nt fddt|D rRtdg }x>t|  D ].\}}|fddt||d D  qdW xt| D ]}	t|	 V  qW dS )a  
    ``max_degrees`` and ``min_degrees`` are either both integers or both lists.
    Unless otherwise specified, ``min_degrees`` is either ``0`` or
    ``[0, ..., 0]``.

    A generator of all monomials ``monom`` is returned, such that
    either
    ``min_degree <= total_degree(monom) <= max_degree``,
    or
    ``min_degrees[i] <= degree_list(monom)[i] <= max_degrees[i]``,
    for all ``i``.

    Case I. ``max_degrees`` and ``min_degrees`` are both integers
    =============================================================

    Given a set of variables $V$ and a min_degree $N$ and a max_degree $M$
    generate a set of monomials of degree less than or equal to $N$ and greater
    than or equal to $M$. The total number of monomials in commutative
    variables is huge and is given by the following formula if $M = 0$:

        .. math::
            \frac{(\#V + N)!}{\#V! N!}

    For example if we would like to generate a dense polynomial of
    a total degree $N = 50$ and $M = 0$, which is the worst case, in 5
    variables, assuming that exponents and all of coefficients are 32-bit long
    and stored in an array we would need almost 80 GiB of memory! Fortunately
    most polynomials, that we will encounter, are sparse.

    Consider monomials in commutative variables $x$ and $y$
    and non-commutative variables $a$ and $b$::

        >>> from sympy import symbols
        >>> from sympy.polys.monomials import itermonomials
        >>> from sympy.polys.orderings import monomial_key
        >>> from sympy.abc import x, y

        >>> sorted(itermonomials([x, y], 2), key=monomial_key('grlex', [y, x]))
        [1, x, y, x**2, x*y, y**2]

        >>> sorted(itermonomials([x, y], 3), key=monomial_key('grlex', [y, x]))
        [1, x, y, x**2, x*y, y**2, x**3, x**2*y, x*y**2, y**3]

        >>> a, b = symbols('a, b', commutative=False)
        >>> set(itermonomials([a, b, x], 2))
        {1, a, a**2, b, b**2, x, x**2, a*b, b*a, x*a, x*b}

        >>> sorted(itermonomials([x, y], 2, 1), key=monomial_key('grlex', [y, x]))
        [x, y, x**2, x*y, y**2]

    Case II. ``max_degrees`` and ``min_degrees`` are both lists
    ===========================================================

    If ``max_degrees = [d_1, ..., d_n]`` and
    ``min_degrees = [e_1, ..., e_n]``, the number of monomials generated
    is:

    .. math::
        (d_1 - e_1 + 1) (d_2 - e_2 + 1) \cdots (d_n - e_n + 1)

    Let us generate all monomials ``monom`` in variables $x$ and $y$
    such that ``[1, 2][i] <= degree_list(monom)[i] <= [2, 4][i]``,
    ``i = 0, 1`` ::

        >>> from sympy import symbols
        >>> from sympy.polys.monomials import itermonomials
        >>> from sympy.polys.orderings import monomial_key
        >>> from sympy.abc import x, y

        >>> sorted(itermonomials([x, y], [2, 4], [1, 2]), reverse=True, key=monomial_key('lex', [x, y]))
        [x**2*y**4, x**2*y**3, x**2*y**2, x*y**4, x*y**3, x*y**2]
    zArgument sizes do not matchNr   zmin_degrees is not a listc             s   s   | ]}|d k V  qdS )r   N ).0ir   r   b/work/yifan.wang/ringdown/master-ringdown-env/lib/python3.7/site-packages/sympy/polys/monomials.py	<genexpr>b   s    z itermonomials.<locals>.<genexpr>z+min_degrees cannot contain negative numbersFzmax_degrees cannot be negativezmin_degrees cannot be negativeTc             s   s   | ]}|j V  qd S )N)Zis_commutative)r   variabler   r   r   r   x   s       )repeatc             3   s   | ]}|  | kV  qd S )Nr   )r   r   )max_degreesmin_degreesr   r   r      s    z2min_degrees[i] must be <= max_degrees[i] for all ic                s   g | ]} | qS r   r   )r   r   )varr   r   
<listcomp>   s    z!itermonomials.<locals>.<listcomp>)lenr   
ValueErroranyr   ZOnelistallr   dictsumvaluesappendr   setr   rangezip)	variablesr   r   nZtotal_degreeZ
max_degreeZ
min_degreeZmonomials_list_commitemZpowersr   Zmonomials_list_non_commZpower_listsZmin_dZmax_dr   )r   r   r   r   itermonomials   sv    J






(r*   c             C   s(   ddl m} || | ||  || S )aW  
    Computes the number of monomials.

    The number of monomials is given by the following formula:

    .. math::

        \frac{(\#V + N)!}{\#V! N!}

    where `N` is a total degree and `V` is a set of variables.

    Examples
    ========

    >>> from sympy.polys.monomials import itermonomials, monomial_count
    >>> from sympy.polys.orderings import monomial_key
    >>> from sympy.abc import x, y

    >>> monomial_count(2, 2)
    6

    >>> M = list(itermonomials([x, y], 2))

    >>> sorted(M, key=monomial_key('grlex', [y, x]))
    [1, x, y, x**2, x*y, y**2]
    >>> len(M)
    6

    r   )	factorial)Z(sympy.functions.combinatorial.factorialsr+   )VNr+   r   r   r   monomial_count   s    r.   c             C   s   t dd t| |D S )a%  
    Multiplication of tuples representing monomials.

    Examples
    ========

    Lets multiply `x**3*y**4*z` with `x*y**2`::

        >>> from sympy.polys.monomials import monomial_mul

        >>> monomial_mul((3, 4, 1), (1, 2, 0))
        (4, 6, 1)

    which gives `x**4*y**5*z`.

    c             S   s   g | ]\}}|| qS r   r   )r   abr   r   r   r      s    z monomial_mul.<locals>.<listcomp>)tupler&   )ABr   r   r   monomial_mul   s    r4   c             C   s,   t | |}tdd |D r$t|S dS dS )a  
    Division of tuples representing monomials.

    Examples
    ========

    Lets divide `x**3*y**4*z` by `x*y**2`::

        >>> from sympy.polys.monomials import monomial_div

        >>> monomial_div((3, 4, 1), (1, 2, 0))
        (2, 2, 1)

    which gives `x**2*y**2*z`. However::

        >>> monomial_div((3, 4, 1), (1, 2, 2)) is None
        True

    `x*y**2*z**2` does not divide `x**3*y**4*z`.

    c             s   s   | ]}|d kV  qdS )r   Nr   )r   cr   r   r   r      s    zmonomial_div.<locals>.<genexpr>N)monomial_ldivr   r1   )r2   r3   Cr   r   r   monomial_div   s    
r8   c             C   s   t dd t| |D S )a  
    Division of tuples representing monomials.

    Examples
    ========

    Lets divide `x**3*y**4*z` by `x*y**2`::

        >>> from sympy.polys.monomials import monomial_ldiv

        >>> monomial_ldiv((3, 4, 1), (1, 2, 0))
        (2, 2, 1)

    which gives `x**2*y**2*z`.

        >>> monomial_ldiv((3, 4, 1), (1, 2, 2))
        (2, 2, -1)

    which gives `x**2*y**2*z**-1`.

    c             S   s   g | ]\}}|| qS r   r   )r   r/   r0   r   r   r   r      s    z!monomial_ldiv.<locals>.<listcomp>)r1   r&   )r2   r3   r   r   r   r6      s    r6   c                s   t  fdd| D S )z%Return the n-th pow of the monomial. c                s   g | ]}|  qS r   r   )r   r/   )r(   r   r   r     s    z monomial_pow.<locals>.<listcomp>)r1   )r2   r(   r   )r(   r   monomial_pow  s    r9   c             C   s   t dd t| |D S )a.  
    Greatest common divisor of tuples representing monomials.

    Examples
    ========

    Lets compute GCD of `x*y**4*z` and `x**3*y**2`::

        >>> from sympy.polys.monomials import monomial_gcd

        >>> monomial_gcd((1, 4, 1), (3, 2, 0))
        (1, 2, 0)

    which gives `x*y**2`.

    c             S   s   g | ]\}}t ||qS r   )min)r   r/   r0   r   r   r   r     s    z monomial_gcd.<locals>.<listcomp>)r1   r&   )r2   r3   r   r   r   monomial_gcd  s    r;   c             C   s   t dd t| |D S )a1  
    Least common multiple of tuples representing monomials.

    Examples
    ========

    Lets compute LCM of `x*y**4*z` and `x**3*y**2`::

        >>> from sympy.polys.monomials import monomial_lcm

        >>> monomial_lcm((1, 4, 1), (3, 2, 0))
        (3, 4, 1)

    which gives `x**3*y**4*z`.

    c             S   s   g | ]\}}t ||qS r   )max)r   r/   r0   r   r   r   r   *  s    z monomial_lcm.<locals>.<listcomp>)r1   r&   )r2   r3   r   r   r   monomial_lcm  s    r=   c             C   s   t dd t| |D S )z
    Does there exist a monomial X such that XA == B?

    Examples
    ========

    >>> from sympy.polys.monomials import monomial_divides
    >>> monomial_divides((1, 2), (3, 4))
    True
    >>> monomial_divides((1, 2), (0, 2))
    False
    c             s   s   | ]\}}||kV  qd S )Nr   )r   r/   r0   r   r   r   r   9  s    z#monomial_divides.<locals>.<genexpr>)r   r&   )r2   r3   r   r   r   monomial_divides,  s    r>   c              G   sR   t | d }x<| dd D ],}x&t|D ]\}}t|| |||< q(W qW t|S )a  
    Returns maximal degree for each variable in a set of monomials.

    Examples
    ========

    Consider monomials `x**3*y**4*z**5`, `y**5*z` and `x**6*y**3*z**9`.
    We wish to find out what is the maximal degree for each of `x`, `y`
    and `z` variables::

        >>> from sympy.polys.monomials import monomial_max

        >>> monomial_max((3,4,5), (0,5,1), (6,3,9))
        (6, 5, 9)

    r   r   N)r   	enumerater<   r1   )monomsMr-   r   r(   r   r   r   monomial_max;  s
    rB   c              G   sR   t | d }x<| dd D ],}x&t|D ]\}}t|| |||< q(W qW t|S )a  
    Returns minimal degree for each variable in a set of monomials.

    Examples
    ========

    Consider monomials `x**3*y**4*z**5`, `y**5*z` and `x**6*y**3*z**9`.
    We wish to find out what is the minimal degree for each of `x`, `y`
    and `z` variables::

        >>> from sympy.polys.monomials import monomial_min

        >>> monomial_min((3,4,5), (0,5,1), (6,3,9))
        (0, 3, 1)

    r   r   N)r   r?   r:   r1   )r@   rA   r-   r   r(   r   r   r   monomial_minT  s
    rC   c             C   s   t | S )z
    Returns the total degree of a monomial.

    Examples
    ========

    The total degree of `xy^2` is 3:

    >>> from sympy.polys.monomials import monomial_deg
    >>> monomial_deg((1, 2))
    3
    )r!   )rA   r   r   r   monomial_degm  s    rD   c             C   sf   | \}}|\}}t ||}|jr>|dk	r8||||fS dS n$|dks^|| s^||||fS dS dS )z,Division of two terms in over a ring/field. N)r8   Zis_FieldZquo)r/   r0   domainZa_lmZa_lcZb_lmZb_lcmonomr   r   r   term_div|  s    
rG   c               @   s`   e Zd ZdZdd Zdd Zdd Zdd	 Zd
d Zdd Z	dd Z
dd Zdd Zdd ZdS )MonomialOpsz6Code generator of fast monomial arithmetic functions. c             C   s
   || _ d S )N)ngens)selfrI   r   r   r   __init__  s    zMonomialOps.__init__c             C   s   i }t || || S )N)exec)rJ   codenamensr   r   r   _build  s    
zMonomialOps._buildc                s    fddt | jD S )Nc                s   g | ]}d  |f qS )z%s%sr   )r   r   )rN   r   r   r     s    z%MonomialOps._vars.<locals>.<listcomp>)r%   rI   )rJ   rN   r   )rN   r   _vars  s    zMonomialOps._varsc             C   sf   d}t d}| d}| d}dd t||D }|t|d|d|d|d }| ||S )	Nr4   zs        def %(name)s(A, B):
            (%(A)s,) = A
            (%(B)s,) = B
            return (%(AB)s,)
        r/   r0   c             S   s   g | ]\}}d ||f qS )z%s + %sr   )r   r/   r0   r   r   r   r     s    z#MonomialOps.mul.<locals>.<listcomp>z, )rN   r2   r3   AB)r   rQ   r&   r    joinrP   )rJ   rN   templater2   r3   rR   rM   r   r   r   mul  s    

&zMonomialOps.mulc             C   sN   d}t d}| d}dd |D }|t|d|d|d }| ||S )Nr9   zZ        def %(name)s(A, k):
            (%(A)s,) = A
            return (%(Ak)s,)
        r/   c             S   s   g | ]}d | qS )z%s*kr   )r   r/   r   r   r   r     s    z#MonomialOps.pow.<locals>.<listcomp>z, )rN   r2   Ak)r   rQ   r    rS   rP   )rJ   rN   rT   r2   rV   rM   r   r   r   pow  s    
zMonomialOps.powc             C   sf   d}t d}| d}| d}dd t||D }|t|d|d|d|d }| ||S )	NZmonomial_mulpowzw        def %(name)s(A, B, k):
            (%(A)s,) = A
            (%(B)s,) = B
            return (%(ABk)s,)
        r/   r0   c             S   s   g | ]\}}d ||f qS )z	%s + %s*kr   )r   r/   r0   r   r   r   r     s    z&MonomialOps.mulpow.<locals>.<listcomp>z, )rN   r2   r3   ABk)r   rQ   r&   r    rS   rP   )rJ   rN   rT   r2   r3   rX   rM   r   r   r   mulpow  s    

&zMonomialOps.mulpowc             C   sf   d}t d}| d}| d}dd t||D }|t|d|d|d|d }| ||S )	Nr6   zs        def %(name)s(A, B):
            (%(A)s,) = A
            (%(B)s,) = B
            return (%(AB)s,)
        r/   r0   c             S   s   g | ]\}}d ||f qS )z%s - %sr   )r   r/   r0   r   r   r   r     s    z$MonomialOps.ldiv.<locals>.<listcomp>z, )rN   r2   r3   rR   )r   rQ   r&   r    rS   rP   )rJ   rN   rT   r2   r3   rR   rM   r   r   r   ldiv  s    

&zMonomialOps.ldivc          	   C   sx   d}t d}| d}| d}dd t| jD }| d}|t|d|d|d	|d|d
 }| ||S )Nr8   z        def %(name)s(A, B):
            (%(A)s,) = A
            (%(B)s,) = B
            %(RAB)s
            return (%(R)s,)
        r/   r0   c             S   s   g | ]}d t |d qS )z7r%(i)s = a%(i)s - b%(i)s
    if r%(i)s < 0: return None)r   )r    )r   r   r   r   r   r     s    z#MonomialOps.div.<locals>.<listcomp>rz, z
    )rN   r2   r3   RABR)r   rQ   r%   rI   r    rS   rP   )rJ   rN   rT   r2   r3   r\   r]   rM   r   r   r   div  s    


.zMonomialOps.divc             C   sf   d}t d}| d}| d}dd t||D }|t|d|d|d|d }| ||S )	Nr=   zs        def %(name)s(A, B):
            (%(A)s,) = A
            (%(B)s,) = B
            return (%(AB)s,)
        r/   r0   c             S   s    g | ]\}}d ||||f qS )z%s if %s >= %s else %sr   )r   r/   r0   r   r   r   r     s    z#MonomialOps.lcm.<locals>.<listcomp>z, )rN   r2   r3   rR   )r   rQ   r&   r    rS   rP   )rJ   rN   rT   r2   r3   rR   rM   r   r   r   lcm  s    

&zMonomialOps.lcmc             C   sf   d}t d}| d}| d}dd t||D }|t|d|d|d|d }| ||S )	Nr;   zs        def %(name)s(A, B):
            (%(A)s,) = A
            (%(B)s,) = B
            return (%(AB)s,)
        r/   r0   c             S   s    g | ]\}}d ||||f qS )z%s if %s <= %s else %sr   )r   r/   r0   r   r   r   r     s    z#MonomialOps.gcd.<locals>.<listcomp>z, )rN   r2   r3   rR   )r   rQ   r&   r    rS   rP   )rJ   rN   rT   r2   r3   rR   rM   r   r   r   gcd  s    

&zMonomialOps.gcdN)__name__
__module____qualname____doc__rK   rP   rQ   rU   rW   rY   rZ   r^   r_   r`   r   r   r   r   rH     s   rH   c               @   s   e Zd ZdZdZd"ddZd#ddZdd	 Zd
d Zdd Z	dd Z
dd Zdd Zdd Zdd Zdd Zdd ZeZdd Zdd Zd d! ZdS )$Monomialz9Class representing a monomial, i.e. a product of powers. )	exponentsgensNc             C   sv   t |s\tt||d\}}t|dkrNt| d dkrNt| d }ntd|t	t
t|| _|| _d S )N)rg   r   r   zExpected a monomial got {})r   r   r   r   r   r"   keysr   formatr1   mapintrf   rg   )rJ   rF   rg   repr   r   r   rK     s     zMonomial.__init__c             C   s   |  ||p| jS )N)	__class__rg   )rJ   rf   rg   r   r   r   rebuild  s    zMonomial.rebuildc             C   s
   t | jS )N)r   rf   )rJ   r   r   r   __len__  s    zMonomial.__len__c             C   s
   t | jS )N)iterrf   )rJ   r   r   r   __iter__  s    zMonomial.__iter__c             C   s
   | j | S )N)rf   )rJ   r)   r   r   r   __getitem__  s    zMonomial.__getitem__c             C   s   t | jj| j| jfS )N)hashrm   ra   rf   rg   )rJ   r   r   r   __hash__  s    zMonomial.__hash__c             C   s:   | j r$ddd t| j | jD S d| jj| jf S d S )N*c             S   s   g | ]\}}d ||f qS )z%s**%sr   )r   genexpr   r   r   r      s    z$Monomial.__str__.<locals>.<listcomp>z%s(%s))rg   rS   r&   rf   rm   ra   )rJ   r   r   r   __str__  s    zMonomial.__str__c             G   s4   |p| j }|std|  tdd t|| jD  S )z3Convert a monomial instance to a SymPy expression. z5Cannot convert %s to an expression without generatorsc             S   s   g | ]\}}|| qS r   r   )r   rv   rw   r   r   r   r   ,  s    z$Monomial.as_expr.<locals>.<listcomp>)rg   r   r   r&   rf   )rJ   rg   r   r   r   as_expr$  s
    

zMonomial.as_exprc             C   s4   t |tr|j}nt |ttfr&|}ndS | j|kS )NF)
isinstancere   rf   r1   r   )rJ   otherrf   r   r   r   __eq__.  s    
zMonomial.__eq__c             C   s
   | |k S )Nr   )rJ   r{   r   r   r   __ne__8  s    zMonomial.__ne__c             C   s<   t |tr|j}nt |ttfr&|}nt| t| j|S )N)rz   re   rf   r1   r   NotImplementedErrorrn   r4   )rJ   r{   rf   r   r   r   __mul__;  s    
zMonomial.__mul__c             C   sZ   t |tr|j}nt |ttfr&|}ntt| j|}|d k	rH| |S t| t|d S )N)	rz   re   rf   r1   r   r~   r8   rn   r	   )rJ   r{   rf   resultr   r   r   __truediv__E  s    

zMonomial.__truediv__c             C   sh   t |}|s | dgt|  S |dkrX| j}xtd|D ]}t|| j}q:W | |S td| d S )Nr   r   z'a non-negative integer expected, got %s)rk   rn   r   rf   r%   r4   r   )rJ   r{   r(   rf   r   r   r   r   __pow__V  s    
zMonomial.__pow__c             C   sD   t |tr|j}n t |ttfr&|}ntd| | t| j|S )z&Greatest common divisor of monomials. z.an instance of Monomial class expected, got %s)rz   re   rf   r1   r   	TypeErrorrn   r;   )rJ   r{   rf   r   r   r   r`   e  s    

zMonomial.gcdc             C   sD   t |tr|j}n t |ttfr&|}ntd| | t| j|S )z$Least common multiple of monomials. z.an instance of Monomial class expected, got %s)rz   re   rf   r1   r   r   rn   r=   )rJ   r{   rf   r   r   r   r_   q  s    

zMonomial.lcm)N)N)ra   rb   rc   rd   	__slots__rK   rn   ro   rq   rr   rt   rx   ry   r|   r}   r   r   __floordiv__r   r`   r_   r   r   r   r   re     s$   




re   )N)$rd   	itertoolsr   r   textwrapr   Z
sympy.corer   r   r   r   Zsympy.polys.polyerrorsr	   Zsympy.polys.polyutilsr
   r   Zsympy.utilitiesr   Zsympy.utilities.iterablesr   r   r*   r.   r4   r8   r6   r9   r;   r=   r>   rB   rC   rD   rG   rH   re   r   r   r   r   <module>   s2    !p