*hE SrSSKJr SSKJr SSKJr SSKJr SSK J r SSK J r J r Jr SS KJr S rSS jrS r\ SSj5rg )z,Computing integral bases for number fields. )Poly)AlgebraicField)ZZ)QQ)public)ModuleEndomorphismModuleHomomorphism PowerBasis) extract_fundamental_discriminantcbURn[XS9nUR5upEUS:Xde[SX!S9nUH upxXg-nM X6-n [U[S9n [U [S9n X-U- U-n [XS9n U nXi4HnUR U5nM X>-nUR 5nUU4$)zn Apply the "Dedekind criterion" to test whether the order needs to be enlarged relative to a given prime *p*. modulusrdomain)genr factor_listrgcddegree)TpxT_barlcflg_barti_bar_h_barghff_barZ_barbU_barms [/home/mande/repo/quber/.venv/lib/python3.13/site-packages/sympy/polys/numberfields/basis.py_apply_Dedekind_criterionr) s A  E    FB 7N7 A !E   NE U2A U2A qA  E E^ !  NE A !8ONc^URnTcUmTU:a TU-mTU:aM [UU4Sj5nURUS9$)a Compute the nilradical mod *p* for a given order *H*, and prime *p*. Explanation =========== This is the ideal $I$ in $H/pH$ consisting of all elements some positive power of which is zero in this quotient ring, i.e. is a multiple of *p*. Parameters ========== H : :py:class:`~.Submodule` The given order. p : int The rational prime. q : int, optional If known, the smallest power of *p* that is $>=$ the dimension of *H*. If not provided, we compute it here. Returns ======= :py:class:`~.Module` representing the nilradical mod *p* in *H*. References ========== .. [1] Cohen, H. *A Course in Computational Algebraic Number Theory*. (See Lemma 6.1.6.) c>UT-$N)rqs r("nilradical_mod_p..Ks !Q$r*r)nr kernel)Hrr/r2phis ` r(nilradical_mod_pr6%sOB Ay !e FA!e Q /C ::a:  r*c^ [XUS9nURRURUR-URS9nXAU--nUR 5m [ UT U 4Sj5nURUS9nURRURUR-URU-S9nX-n X4$)z< Perform the second enlargement in the Round Two algorithm. )r/)denomc&>TRU5$r-)inner_endomorphism)rEs r(r0%_second_enlargement..WsQ-A-A!-Dr*r)r6parentsubmodule_from_matrixmatrixr8endomorphism_ringr r3) r4rr/IpBCr5gammaGH1r;s @r(_second_enlargementrGOs !! $B &&qxx"))';177&KA aCA A Q#D EC JJqJ !E &&qxx%,,'>aggPQk&RA B 6Mr*c&Sn[U[5(aXRR5pUR(a+UR (aUR [[4;a [S5eUR5upUR5nUR5n[R"[U55n[U5up7[!U=(d U5nUR#5n Sn U(aUR%5up['X 5upUS:XaM.UR)[+U [S95nU R-X-U -US9n X::aMgU nUU:a UU -nUU:aM [/XU5unn UU :waUn [/XU5unn UU :waMU(aMU b[U[05(aXW 'U nSUlSUlUUR6R95S--UR:SU---nUU4$)a Zassenhaus's "Round 2" algorithm. Explanation =========== Carry out Zassenhaus's "Round 2" algorithm on an irreducible polynomial *T* over :ref:`ZZ` or :ref:`QQ`. This computes an integral basis and the discriminant for the field $K = \mathbb{Q}[x]/(T(x))$. Alternatively, you may pass an :py:class:`~.AlgebraicField` instance, in place of the polynomial *T*, in which case the algorithm is applied to the minimal polynomial for the field's primitive element. Ordinarily this function need not be called directly, as one can instead access the :py:meth:`~.AlgebraicField.maximal_order`, :py:meth:`~.AlgebraicField.integral_basis`, and :py:meth:`~.AlgebraicField.discriminant` methods of an :py:class:`~.AlgebraicField`. Examples ======== Working through an AlgebraicField: >>> from sympy import Poly, QQ >>> from sympy.abc import x >>> T = Poly(x ** 3 + x ** 2 - 2 * x + 8) >>> K = QQ.alg_field_from_poly(T, "theta") >>> print(K.maximal_order()) Submodule[[2, 0, 0], [0, 2, 0], [0, 1, 1]]/2 >>> print(K.discriminant()) -503 >>> print(K.integral_basis(fmt='sympy')) [1, theta, theta/2 + theta**2/2] Calling directly: >>> from sympy import Poly >>> from sympy.abc import x >>> from sympy.polys.numberfields.basis import round_two >>> T = Poly(x ** 3 + x ** 2 - 2 * x + 8) >>> print(round_two(T)) (Submodule[[2, 0, 0], [0, 2, 0], [0, 1, 1]]/2, -503) The nilradicals mod $p$ that are sometimes computed during the Round Two algorithm may be useful in further calculations. Pass a dictionary under `radicals` to receive these: >>> T = Poly(x**3 + 3*x**2 + 5) >>> rad = {} >>> ZK, dK = round_two(T, radicals=rad) >>> print(rad) {3: Submodule[[-1, 1, 0], [-1, 0, 1]]} Parameters ========== T : :py:class:`~.Poly`, :py:class:`~.AlgebraicField` Either (1) the irreducible polynomial over :ref:`ZZ` or :ref:`QQ` defining the number field, or (2) an :py:class:`~.AlgebraicField` representing the number field itself. radicals : dict, optional This is a way for any $p$-radicals (if computed) to be returned by reference. If desired, pass an empty dictionary. If the algorithm reaches the point where it computes the nilradical mod $p$ of the ring of integers $Z_K$, then an $\mathbb{F}_p$-basis for this ideal will be stored in this dictionary under the key ``p``. This can be useful for other algorithms, such as prime decomposition. Returns ======= Pair ``(ZK, dK)``, where: ``ZK`` is a :py:class:`~sympy.polys.numberfields.modules.Submodule` representing the maximal order. ``dK`` is the discriminant of the field $K = \mathbb{Q}[x]/(T(x))$. See Also ======== .AlgebraicField.maximal_order .AlgebraicField.integral_basis .AlgebraicField.discriminant References ========== .. [1] Cohen, H. *A Course in Computational Algebraic Number Theory.* NzDRound 2 requires an irreducible univariate polynomial over ZZ or QQ.rr) hnf_modulusT) isinstancerextminpoly_of_element is_univariateis_irreduciblerrr ValueError)make_monic_over_integers_by_scaling_rootsr discriminant from_sympyabsr r whole_submodulepopitemr)element_from_polyraddrGdict_starts_with_unity_is_sq_maxrank_HNFr?detr8)rradicalsKrr2D D_modulusFZthetar4nilradrer&r'Ur/rFZKdKs r( round_tworh^s@ A!^$$%%**,1 88B8 #_`` 6 6 8DA  A A c!f%I ,A .DA Q F A F yy{,Q2 6   $ $T%%; < EE!&1*)E 4 6  !e FA!e(q1 FAgA,Q15JBAg- !@j488 B B B biimmo" "rxxAE': :B r6Mr*r-)__doc__sympy.polys.polytoolsr"sympy.polys.domains.algebraicfieldrsympy.polys.domains.integerringr!sympy.polys.domains.rationalfieldrsympy.utilities.decoratorrmodulesr r r utilitiesr r)r6rGrhr.r*r(rqsF2&=.0,GG72'!T WWr*