a khH@sdZddlmZmZddlmZddlmZddlm Z m Z m Z m Z ddl mZddlmZmZddlmZdd lmZmZed)d d Zd dZddZddZddZddZddZddZddZddZ dd Z!d!d"Z"d#d$Z#Gd%d&d&Z$eGd'd(d(eZ%d S)*z@Tools and arithmetics for monomials of distributed polynomials. )combinations_with_replacementproduct)dedent)cacheit)MulSTuplesympify)ExactQuotientFailed)PicklableWithSlotsdict_from_expr)public) is_sequenceiterableNc#strt|}t|kr$tddur8dg|n@tsJtdn.t|kr^tdtddDrxtdtfddt|Drtd g}t|D],\}}|fd d t||d Dqt|D]}t|Vqn}|dkr td durd} ndkr.td} | |kr@dS|rP|dkr\t j VdSt |t j g}t dd|Drt ||} n t||d} t} || } | D]F} d}| D](}|d kr|d 7}| |krqq| t| q| EdHdS)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] zArgument sizes do not matchNrzmin_degrees is not a listcss|]}|dkVqdSrN.0irrC/var/www/auris/lib/python3.9/site-packages/sympy/polys/monomials.py cz itermonomials..z+min_degrees cannot contain negative numbersc3s|]}||kVqdSNrr) max_degrees min_degreesrrrerz2min_degrees[i] must be <= max_degrees[i] for all icsg|] }|qSrrr)varrr irz!itermonomials..zmax_degrees cannot be negativezmin_degrees cannot be negativecss|] }|jVqdSr)Zis_commutative)rvariablerrrr}r)repeat)rlen ValueErroranyrangezipappendrrrZOnelistallrsetadd) variablesrrnZ power_listsZmin_dZmax_dZpowersZ max_degreeZ min_degreeitZ monomials_setditemcountrr)rrrr itermonomialss^J    $          r0cCs(ddlm}|||||||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.factorialsr1)VNr1rrrmonomial_counts r4cCstddt||DS)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`. cSsg|]\}}||qSrrrabrrrrrz monomial_mul..tupler$ABrrr monomial_mulsr=cCs,t||}tdd|Dr$t|SdSdS)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`. css|]}|dkVqdSrr)rcrrrrrzmonomial_div..N) monomial_ldivr'r9)r;r<Crrr monomial_divs rAcCstddt||DS)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`. cSsg|]\}}||qSrrr5rrrrrz!monomial_ldiv..r8r:rrrr?sr?cstfdd|DS)z%Return the n-th pow of the monomial. csg|] }|qSrrrr6r+rrrrz monomial_pow..)r9)r;r+rrCr monomial_powsrDcCstddt||DS)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`. cSsg|]\}}t||qSr)minr5rrrr rz monomial_gcd..r8r:rrr monomial_gcdsrFcCstddt||DS)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`. cSsg|]\}}t||qSr)maxr5rrrrrz monomial_lcm..r8r:rrr monomial_lcmsrHcCstddt||DS)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 css|]\}}||kVqdSrrr5rrrr.rz#monomial_divides..)r'r$r:rrrmonomial_divides!s rIcGsJt|d}|ddD](}t|D]\}}t|||||<q$qt|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) rrN)r& enumeraterGr9ZmonomsMr3rr+rrr monomial_max0s  rMcGsJt|d}|ddD](}t|D]\}}t|||||<q$qt|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) rrN)r&rJrEr9rKrrr monomial_minIs  rNcCst|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 )sum)rLrrr monomial_degbs rPcCsf|\}}|\}}t||}|jr>|dur8||||fSdSn$|dus^||s^||||fSdSdS)z,Division of two terms in over a ring/field. N)rAZis_FieldZquo)r6r7domainZa_lmZa_lcZb_lmZb_lcmonomrrrterm_divqs rScseZdZdZefddZddZddZdd Zed d Z ed d Z eddZ eddZ eddZ eddZeddZZS) MonomialOpsz6Code generator of fast monomial arithmetic functions. cst|}||_|Sr)super__new__ngens)clsrWobj __class__rrrVs zMonomialOps.__new__cCs|jfSr)rWselfrrr__getnewargs__szMonomialOps.__getnewargs__cCsi}t||||Sr)exec)r]codenamensrrr_builds zMonomialOps._buildcsfddt|jDS)Ncsg|]}d|fqS)z%s%srrrarrrrz%MonomialOps._vars..)r#rW)r]rarrdr_varsszMonomialOps._varscCsdd}td}|d}|d}ddt||D}||d|d|d|d}|||S) Nr=s def %(name)s(A, B): (%(A)s,) = A (%(B)s,) = B return (%(AB)s,) r6r7cSsg|]\}}d||fqS)z%s + %srr5rrrrrz#MonomialOps.mul.., rar;r<ABrrer$joinrcr]ratemplater;r<rir`rrrmuls  $zMonomialOps.mulcCsLd}td}|d}dd|D}||d|d|d}|||S)NrDzZ def %(name)s(A, k): (%(A)s,) = A return (%(Ak)s,) r6cSsg|] }d|qS)z%s*krrBrrrrrz#MonomialOps.pow..rg)rar;Ak)rrerkrc)r]rarmr;ror`rrrpows  zMonomialOps.powcCsdd}td}|d}|d}ddt||D}||d|d|d|d}|||S) NZmonomial_mulpowzw def %(name)s(A, B, k): (%(A)s,) = A (%(B)s,) = B return (%(ABk)s,) r6r7cSsg|]\}}d||fqS)z %s + %s*krr5rrrrrz&MonomialOps.mulpow..rg)rar;r<ABkrj)r]rarmr;r<rqr`rrrmulpows  $zMonomialOps.mulpowcCsdd}td}|d}|d}ddt||D}||d|d|d|d}|||S) Nr?rfr6r7cSsg|]\}}d||fqS)z%s - %srr5rrrrrz$MonomialOps.ldiv..rgrhrjrlrrrldivs  $zMonomialOps.ldivcCsvd}td}|d}|d}ddt|jD}|d}||d|d|d |d|d }|||S) NrAz def %(name)s(A, B): (%(A)s,) = A (%(B)s,) = B %(RAB)s return (%(R)s,) r6r7cSsg|]}dd|iqS)z7r%(i)s = a%(i)s - b%(i)s if r%(i)s < 0: return Nonerrrrrrrrz#MonomialOps.div..rrgz )rar;r<RABR)rrer#rWrkrc)r]rarmr;r<rurvr`rrrdivs   ,zMonomialOps.divcCsdd}td}|d}|d}ddt||D}||d|d|d|d}|||S) NrHrfr6r7cSs g|]\}}d||||fqS)z%s if %s >= %s else %srr5rrrrrz#MonomialOps.lcm..rgrhrjrlrrrlcms  $zMonomialOps.lcmcCsdd}td}|d}|d}ddt||D}||d|d|d|d}|||S) NrFrfr6r7cSs g|]\}}d||||fqS)z%s if %s <= %s else %srr5rrrrrz#MonomialOps.gcd..rgrhrjrlrrrgcds  $zMonomialOps.gcd)__name__ __module__ __qualname____doc__rrVr^rcrernrprrrsrwrxry __classcell__rrrZrrTs(      rTc@seZdZdZdZd"ddZd#ddZdd Zd d Zd d Z ddZ ddZ ddZ ddZ ddZddZddZeZddZddZd d!ZdS)$Monomialz9Class representing a monomial, i.e. a product of powers. ) exponentsgensNcCsvt|s\tt||d\}}t|dkrNt|ddkrNt|d}ntd|t t t ||_ ||_ dS)N)rrrzExpected a monomial got {})rr r r r&valueskeysr!formatr9mapintrr)r]rRrreprrr__init__s zMonomial.__init__cCs|||p|jSr)r[r)r]rrrrrrebuildszMonomial.rebuildcCs t|jSr)r rr\rrr__len__szMonomial.__len__cCs t|jSr)iterrr\rrr__iter__szMonomial.__iter__cCs |j|Sr)r)r]r.rrr __getitem__szMonomial.__getitem__cCst|jj|j|jfSr)hashr[rzrrr\rrr__hash__szMonomial.__hash__cCs:|jr$dddt|j|jDSd|jj|jfSdS)N*cSsg|]\}}d||fqS)z%s**%srrgenexprrrr"rz$Monomial.__str__..z%s(%s))rrkr$rr[rzr\rrr__str__ szMonomial.__str__cGs4|p|j}|std|tddt||jDS)z3Convert a monomial instance to a SymPy expression. z5Cannot convert %s to an expression without generatorscSsg|]\}}||qSrrrrrrr.rz$Monomial.as_expr..)rr!rr$r)r]rrrras_expr&s  zMonomial.as_exprcCs4t|tr|j}nt|ttfr&|}ndS|j|kS)NF) isinstancerrr9rr]otherrrrr__eq__0s  zMonomial.__eq__cCs ||k Srr)r]rrrr__ne__:szMonomial.__ne__cCs<t|tr|j}nt|ttfr&|}nt|t|j|Sr)rrrr9rNotImplementedErrorrr=rrrr__mul__=s  zMonomial.__mul__cCsZt|tr|j}nt|ttfr&|}ntt|j|}|durH||St|t|dSr) rrrr9rrrArr )r]rrresultrrr __truediv__Gs   zMonomial.__truediv__cCs.t|}|dkrtd||t|j|S)Nrz'a non-negative integer expected, got %s)rr!rrDr)r]rr+rrr__pow__Xs zMonomial.__pow__cCsDt|tr|j}n t|ttfr&|}n td||t|j|S)z&Greatest common divisor of monomials. .an instance of Monomial class expected, got %s)rrrr9r TypeErrorrrFrrrrry^s z Monomial.gcdcCsDt|tr|j}n t|ttfr&|}n td||t|j|S)z$Least common multiple of monomials. r)rrrr9rrrrHrrrrrxjs z Monomial.lcm)N)N)rzr{r|r} __slots__rrrrrrrrrrrr __floordiv__rryrxrrrrrs$     r)N)&r} itertoolsrrtextwraprZsympy.core.cacherZ sympy.corerrrr Zsympy.polys.polyerrorsr Zsympy.polys.polyutilsr r Zsympy.utilitiesr Zsympy.utilities.iterablesrrr0r4r=rAr?rDrFrHrIrMrNrPrSrTrrrrrs2     !}