passagemath-modules 10.6.31rc3__cp314-cp314-musllinux_1_2_aarch64.whl

sage/groups/abelian_gps/abelian_group_element.py

@@ -0,0 +1,164 @@
+# sage_setup: distribution = sagemath-modules
+"""
+Abelian group elements
+
+AUTHORS:
+
+- David Joyner (2006-02); based on free_abelian_monoid_element.py, written by David Kohel.
+
+- David Joyner (2006-05); bug fix in order
+
+- David Joyner (2006-08); bug fix+new method in pow for negatives+fixed corresponding examples.
+
+- David Joyner (2009-02): Fixed bug in order.
+
+- Volker Braun (2012-11) port to new Parent base. Use tuples for immutables.
+
+EXAMPLES:
+
+Recall an example from abelian groups::
+
+    sage: F = AbelianGroup(5,[4,5,5,7,8],names = list("abcde"))
+    sage: (a,b,c,d,e) = F.gens()
+    sage: x = a*b^2*e*d^20*e^12
+    sage: x
+    a*b^2*d^6*e^5
+    sage: x = a^10*b^12*c^13*d^20*e^12
+    sage: x
+    a^2*b^2*c^3*d^6*e^4
+    sage: y = a^13*b^19*c^23*d^27*e^72
+    sage: y
+    a*b^4*c^3*d^6
+    sage: x*y
+    a^3*b*c*d^5*e^4
+    sage: x.list()
+    [2, 2, 3, 6, 4]
+"""
+
+###########################################################################
+#  Copyright (C) 2006 William Stein <wstein@gmail.com>
+#  Copyright (C) 2006 David Joyner  <wdjoyner@gmail.com>
+#  Copyright (C) 2012 Volker Braun  <vbraun.name@gmail.com>
+#
+#  Distributed under the terms of the GNU General Public License (GPL)
+#                  https://www.gnu.org/licenses/
+###########################################################################
+
+from sage.groups.abelian_gps.element_base import AbelianGroupElementBase
+
+
+def is_AbelianGroupElement(x):
+    """
+    Return ``True`` if ``x`` is an abelian group element, i.e., an element of
+    type :class:`AbelianGroupElement`.
+
+    EXAMPLES: Though the integer 3 is in the integers, and the integers
+    have an abelian group structure, 3 is not an AbelianGroupElement::
+
+        sage: from sage.groups.abelian_gps.abelian_group_element import is_AbelianGroupElement
+        sage: is_AbelianGroupElement(3)
+        doctest:warning...
+        DeprecationWarning: The function is_AbelianGroupElement is deprecated;
+        use 'isinstance(..., AbelianGroupElement)' instead.
+        See https://github.com/sagemath/sage/issues/38184 for details.
+        False
+        sage: F = AbelianGroup(5, [3,4,5,8,7], 'abcde')
+        sage: is_AbelianGroupElement(F.0)
+        True
+    """
+    from sage.misc.superseded import deprecation
+    deprecation(38184,
+                "The function is_AbelianGroupElement is deprecated; "
+                "use 'isinstance(..., AbelianGroupElement)' instead.")
+    return isinstance(x, AbelianGroupElement)
+
+
+class AbelianGroupElement(AbelianGroupElementBase):
+    """
+    Elements of an
+    :class:`~sage.groups.abelian_gps.abelian_group.AbelianGroup`
+
+    INPUT:
+
+    - ``x`` -- list/tuple/iterable of integers (the element vector)
+
+    - ``parent`` -- the parent
+      :class:`~sage.groups.abelian_gps.abelian_group.AbelianGroup`
+
+    EXAMPLES::
+
+        sage: F = AbelianGroup(5, [3,4,5,8,7], 'abcde')
+        sage: a, b, c, d, e = F.gens()
+        sage: a^2 * b^3 * a^2 * b^-4
+        a*b^3
+        sage: b^-11
+        b
+        sage: a^-11
+        a
+        sage: a*b in F
+        True
+    """
+    def as_permutation(self):
+        r"""
+        Return the element of the permutation group ``G`` (isomorphic to the
+        abelian group ``A``) associated to ``a`` in ``A``.
+
+        EXAMPLES::
+
+            sage: G = AbelianGroup(3, [2,3,4], names='abc'); G
+            Multiplicative Abelian group isomorphic to C2 x C3 x C4
+            sage: a,b,c = G.gens()
+            sage: Gp = G.permutation_group(); Gp                                        # needs sage.groups
+            Permutation Group with generators [(1,2), (3,4,5), (6,7,8,9)]
+            sage: a.as_permutation()                                                    # needs sage.libs.gap
+            (1,2)
+            sage: ap = a.as_permutation(); ap                                           # needs sage.libs.gap
+            (1,2)
+            sage: ap in Gp                                                              # needs sage.groups sage.libs.gap
+            True
+        """
+        from sage.libs.gap.libgap import libgap
+        G = self.parent()
+        A = libgap.AbelianGroup(G.gens_orders())
+        phi = libgap.IsomorphismPermGroup(A)
+        gens = libgap.GeneratorsOfGroup(A)
+        L2 = libgap.Product([geni**Li for geni, Li in zip(gens, self.list())])
+        pg = libgap.Image(phi, L2)
+        return G.permutation_group()(pg)
+
+    def word_problem(self, words):
+        """
+        ``G`` and ``H`` are abelian groups, ``g`` in ``G``, ``H`` is a
+        subgroup of ``G`` generated by a list (words) of elements of ``G``. If
+        ``self`` is in ``H``, return the expression for ``self`` as a word in
+        the elements of (words).
+
+        This function does not solve the word problem in Sage. Rather
+        it pushes it over to GAP, which has optimized (non-deterministic)
+        algorithms for the word problem.
+
+        .. WARNING::
+
+            Don't use ``E`` (or other GAP-reserved letters) as a generator
+            name.
+
+        .. TODO::
+
+            This needs a rewrite - see stuff in the ``matrix_grp`` directory.
+
+        EXAMPLES::
+
+            sage: # needs sage.libs.gap
+            sage: G = AbelianGroup(2, [2,3], names='xy')
+            sage: x,y = G.gens()
+            sage: x.word_problem([x,y])
+            [[x, 1]]
+            sage: y.word_problem([x,y])
+            [[y, 1]]
+            sage: v = (y*x).word_problem([x,y]); v  # random
+            [[x, 1], [y, 1]]
+            sage: prod([x^i for x,i in v]) == y*x
+            True
+        """
+        from sage.groups.abelian_gps.abelian_group import word_problem
+        return word_problem(words, self)

sage/groups/abelian_gps/all__sagemath_modules.py

@@ -0,0 +1,5 @@
+# sage_setup: distribution = sagemath-modules
+
+# from dual_abelian_group import DualAbelianGroup
+from sage.groups.abelian_gps.abelian_group import AbelianGroup, word_problem
+from sage.groups.abelian_gps.values import AbelianGroupWithValues

sage/groups/abelian_gps/dual_abelian_group.py

@@ -0,0 +1,421 @@
+# sage_setup: distribution = sagemath-modules
+# sage.doctest: needs sage.rings.number_field
+r"""
+Dual groups of Finite Multiplicative Abelian Groups
+
+The basic idea is very simple. Let G be an abelian group and `G^*` its
+dual (i.e., the group of homomorphisms from G to `\CC^\times`). Let
+`g_j`, `j=1,..,n`, denote generators of `G` - say `g_j` is of order
+`m_j>1`. There are generators `X_j`, `j=1,..,n`, of `G^*` for which
+`X_j(g_j)=\exp(2\pi i/m_j)` and `X_i(g_j)=1` if `i\not= j`. These are
+used to construct `G^*`.
+
+Sage supports multiplicative abelian groups on any prescribed finite
+number `n > 0` of generators. Use
+:func:`~sage.groups.abelian_gps.abelian_group.AbelianGroup` function
+to create an abelian group, the
+:meth:`~sage.groups.abelian_gps.abelian_group.AbelianGroup_class.dual_group`
+method to create its dual, and then the :meth:`gen` and :meth:`gens`
+methods to obtain the corresponding generators. You can print the
+generators as arbitrary strings using the optional ``names`` argument
+to the
+:meth:`~sage.groups.abelian_gps.abelian_group.AbelianGroup_class.dual_group`
+method.
+
+EXAMPLES::
+
+    sage: F = AbelianGroup(5, [2,5,7,8,9], names='abcde')
+    sage: (a, b, c, d, e) = F.gens()
+
+    sage: Fd = F.dual_group(names='ABCDE')
+    sage: Fd.base_ring()
+    Cyclotomic Field of order 2520 and degree 576
+    sage: A,B,C,D,E = Fd.gens()
+    sage: A(a)
+    -1
+    sage: A(b), A(c), A(d), A(e)
+    (1, 1, 1, 1)
+
+    sage: # needs sage.rings.real_mpfr
+    sage: Fd = F.dual_group(names='ABCDE', base_ring=CC)
+    sage: Fd.category()
+    Category of commutative groups
+    sage: A,B,C,D,E = Fd.gens()
+    sage: A(a)    # abs tol 1e-8
+    -1.00000000000000 + 0.00000000000000*I
+    sage: A(b); A(c); A(d); A(e)
+    1.00000000000000
+    1.00000000000000
+    1.00000000000000
+    1.00000000000000
+
+AUTHORS:
+
+- David Joyner (2006-08) (based on abelian_groups)
+
+- David Joyner (2006-10) modifications suggested by William Stein
+
+- Volker Braun (2012-11) port to new Parent base. Use tuples for immutables.
+  Default to cyclotomic base ring.
+"""
+
+###########################################################################
+#  Copyright (C) 2006 William Stein <wstein@gmail.com>
+#  Copyright (C) 2006 David Joyner  <wdjoyner@gmail.com>
+#  Copyright (C) 2012 Volker Braun  <vbraun.name@gmail.com>
+#
+#  Distributed under the terms of the GNU General Public License (GPL)
+#                  http://www.gnu.org/licenses/
+###########################################################################
+from sage.categories.groups import Groups
+from sage.structure.category_object import normalize_names
+from sage.structure.unique_representation import UniqueRepresentation
+from sage.groups.abelian_gps.dual_abelian_group_element import (
+    DualAbelianGroupElement, is_DualAbelianGroupElement)
+from sage.misc.mrange import mrange
+from sage.misc.cachefunc import cached_method
+from sage.groups.group import AbelianGroup as AbelianGroupBase
+
+
+def is_DualAbelianGroup(x):
+    """
+    Return ``True`` if `x` is the dual group of an abelian group.
+
+    EXAMPLES::
+
+        sage: from sage.groups.abelian_gps.dual_abelian_group import is_DualAbelianGroup
+        sage: F = AbelianGroup(5,[3,5,7,8,9], names=list("abcde"))
+        sage: Fd = F.dual_group()
+        sage: is_DualAbelianGroup(Fd)
+        doctest:warning...
+        DeprecationWarning: the function is_DualAbelianGroup is deprecated;
+        use 'isinstance(..., DualAbelianGroup_class)' instead
+        See https://github.com/sagemath/sage/issues/37898 for details.
+        True
+        sage: F = AbelianGroup(3,[1,2,3], names='a')
+        sage: Fd = F.dual_group()
+        sage: Fd.gens()
+        (1, X1, X2)
+        sage: F.gens()
+        (1, a1, a2)
+    """
+    from sage.misc.superseded import deprecation
+    deprecation(37898, "the function is_DualAbelianGroup is deprecated; use 'isinstance(..., DualAbelianGroup_class)' instead")
+    return isinstance(x, DualAbelianGroup_class)
+
+
+class DualAbelianGroup_class(UniqueRepresentation, AbelianGroupBase):
+    """
+    Dual of abelian group.
+
+    EXAMPLES::
+
+        sage: F = AbelianGroup(5,[3,5,7,8,9], names='abcde')
+        sage: F.dual_group()
+        Dual of Abelian Group isomorphic to Z/3Z x Z/5Z x Z/7Z x Z/8Z x Z/9Z
+        over Cyclotomic Field of order 2520 and degree 576
+
+        sage: F = AbelianGroup(4,[15,7,8,9], names='abcd')
+        sage: F.dual_group(base_ring=CC)                                                # needs sage.rings.real_mpfr
+        Dual of Abelian Group isomorphic to Z/15Z x Z/7Z x Z/8Z x Z/9Z
+        over Complex Field with 53 bits of precision
+    """
+    Element = DualAbelianGroupElement
+
+    def __init__(self, G, names, base_ring):
+        """
+        The Python constructor.
+
+        EXAMPLES::
+
+            sage: F = AbelianGroup(5,[3,5,7,8,9], names='abcde')
+            sage: F.dual_group()
+            Dual of Abelian Group isomorphic to Z/3Z x Z/5Z x Z/7Z x Z/8Z x Z/9Z
+            over Cyclotomic Field of order 2520 and degree 576
+        """
+        self._base_ring = base_ring
+        self._group = G
+        names = normalize_names(G.ngens(), names)
+        self._assign_names(names)
+        AbelianGroupBase.__init__(self, category=Groups().Commutative())
+
+    def group(self):
+        """
+        Return the group that ``self`` is the dual of.
+
+        EXAMPLES::
+
+            sage: F = AbelianGroup(3,[5,64,729], names=list("abc"))
+            sage: Fd = F.dual_group(base_ring=CC)
+            sage: Fd.group() is F
+            True
+        """
+        return self._group
+
+    def base_ring(self):
+        """
+        Return the scalars over which the group is dualized.
+
+        EXAMPLES::
+
+            sage: F = AbelianGroup(3,[5,64,729], names=list("abc"))
+            sage: Fd = F.dual_group(base_ring=CC)
+            sage: Fd.base_ring()
+            Complex Field with 53 bits of precision
+        """
+        return self._base_ring
+
+    def __str__(self):
+        """
+        Print method.
+
+        EXAMPLES::
+
+            sage: F = AbelianGroup(3,[5,64,729], names=list("abc"))
+            sage: Fd = F.dual_group(base_ring=CC)
+            sage: print(Fd)
+            DualAbelianGroup( AbelianGroup ( 3, (5, 64, 729) ) )
+        """
+        s = "DualAbelianGroup( AbelianGroup ( %s, %s ) )" % (self.ngens(), self.gens_orders())
+        return s
+
+    def _repr_(self):
+        """
+        Return a string representation.
+
+        EXAMPLES::
+
+            sage: F = AbelianGroup(5, [2,5,7,8,9], names='abcde')
+            sage: Fd = F.dual_group(names='ABCDE',
+            ....:                   base_ring=CyclotomicField(2*5*7*8*9))
+            sage: Fd   # indirect doctest
+            Dual of Abelian Group isomorphic to Z/2Z x Z/5Z x Z/7Z x Z/8Z x Z/9Z
+            over Cyclotomic Field of order 5040 and degree 1152
+            sage: Fd = F.dual_group(names='ABCDE', base_ring=CC)                        # needs sage.rings.real_mpfr
+            sage: Fd                                                                    # needs sage.rings.real_mpfr
+            Dual of Abelian Group isomorphic to Z/2Z x Z/5Z x Z/7Z x Z/8Z x Z/9Z
+            over Complex Field with 53 bits of precision
+        """
+        G = self.group()
+        eldv = G.gens_orders()
+        gp = ""
+        for x in eldv:
+            if x != 0:
+                gp = gp + "Z/%sZ x " % x
+            if x == 0:
+                gp = gp + "Z x "
+        gp = gp[:-2].strip()
+        s = 'Dual of Abelian Group isomorphic to ' + gp + ' over ' + str(self.base_ring())
+        return s
+
+    def _latex_(self):
+        r"""
+        Return latex representation of this group.
+
+        EXAMPLES::
+
+            sage: F = AbelianGroup(3, [2]*3)
+            sage: Fd = F.dual_group()
+            sage: Fd._latex_()
+            '$\\mathrm{DualAbelianGroup}( AbelianGroup ( 3, (2, 2, 2) ) )$'
+        """
+        return r"$\mathrm{DualAbelianGroup}( AbelianGroup ( %s, %s ) )$" % (self.ngens(), self.gens_orders())
+
+    def random_element(self):
+        """
+        Return a random element of this dual group.
+
+        EXAMPLES::
+
+            sage: G = AbelianGroup([2,3,9])
+            sage: Gd = G.dual_group(base_ring=CC)                                       # needs sage.rings.real_mpfr
+            sage: Gd.random_element().parent() is Gd                                    # needs sage.rings.real_mpfr
+            True
+
+            sage: # needs sage.rings.real_mpfr
+            sage: N = 43^2 - 1
+            sage: G = AbelianGroup([N], names='a')
+            sage: Gd = G.dual_group(names='A', base_ring=CC)
+            sage: a, = G.gens()
+            sage: A, = Gd.gens()
+            sage: x = a^(N/4); y = a^(N/3); z = a^(N/14)
+            sage: found = [False]*4
+            sage: while not all(found):
+            ....:     X = A*Gd.random_element()
+            ....:     found[len([b for b in [x,y,z] if abs(X(b)-1)>10^(-8)])] = True
+        """
+        from sage.misc.prandom import randint
+        result = self.one()
+        for g in self.gens():
+            order = g.order()
+            result *= g**(randint(0, order))
+        return result
+
+    def gen(self, i=0):
+        """
+        The `i`-th generator of the abelian group.
+
+        EXAMPLES::
+
+            sage: F = AbelianGroup(3, [1,2,3], names='a')
+            sage: Fd = F.dual_group(names='A')
+            sage: Fd.0
+            1
+            sage: Fd.1
+            A1
+            sage: Fd.gens_orders()
+            (1, 2, 3)
+        """
+        n = self.group().ngens()
+        if i < 0 or i >= n:
+            raise IndexError("Argument i (= %s) must be between 0 and %s." % (i, n - 1))
+        x = [0] * n
+        if self.gens_orders()[i] != 1:
+            x[i] = 1
+        return self.element_class(self, x)
+
+    def gens(self) -> tuple:
+        """
+        Return the generators for the group.
+
+        OUTPUT: tuple of group elements generating the group
+
+        EXAMPLES::
+
+            sage: F = AbelianGroup([7,11]).dual_group()
+            sage: F.gens()
+            (X0, X1)
+        """
+        n = self.group().ngens()
+        return tuple(self.gen(i) for i in range(n))
+
+    def ngens(self):
+        """
+        The number of generators of the dual group.
+
+        EXAMPLES::
+
+            sage: F = AbelianGroup([7]*100)
+            sage: Fd = F.dual_group()
+            sage: Fd.ngens()
+            100
+        """
+        return self.group().ngens()
+
+    def gens_orders(self):
+        """
+        The orders of the generators of the dual group.
+
+        OUTPUT: tuple of integers
+
+        EXAMPLES::
+
+            sage: F = AbelianGroup([5]*1000)
+            sage: Fd = F.dual_group()
+            sage: invs = Fd.gens_orders(); len(invs)
+            1000
+        """
+        return self.group().gens_orders()
+
+    def invariants(self):
+        """
+        The invariants of the dual group.
+
+        You should use :meth:`gens_orders` instead.
+
+        EXAMPLES::
+
+            sage: F = AbelianGroup([5]*1000)
+            sage: Fd = F.dual_group()
+            sage: invs = Fd.gens_orders(); len(invs)
+            1000
+        """
+        # TODO: deprecate
+        return self.group().gens_orders()
+
+    def __contains__(self, X):
+        """
+        Implement "in".
+
+        EXAMPLES::
+
+            sage: F = AbelianGroup(5,[2, 3, 5, 7, 8], names='abcde')
+            sage: a,b,c,d,e = F.gens()
+            sage: Fd = F.dual_group(names='ABCDE')
+            sage: A,B,C,D,E = Fd.gens()
+            sage: A*B^2*D^7 in Fd
+            True
+        """
+        return X.parent() == self and isinstance(X, DualAbelianGroupElement)
+
+    def order(self):
+        """
+        Return the order of this group.
+
+        EXAMPLES::
+
+            sage: G = AbelianGroup([2,3,9])
+            sage: Gd = G.dual_group()
+            sage: Gd.order()
+            54
+        """
+        G = self.group()
+        return G.order()
+
+    def is_commutative(self):
+        """
+        Return ``True`` since this group is commutative.
+
+        EXAMPLES::
+
+            sage: G = AbelianGroup([2,3,9])
+            sage: Gd = G.dual_group()
+            sage: Gd.is_commutative()
+            True
+            sage: Gd.is_abelian()
+            True
+        """
+        return True
+
+    @cached_method
+    def list(self):
+        """
+        Return a tuple of all elements of this group.
+
+        EXAMPLES::
+
+            sage: G = AbelianGroup([2,3], names='ab')
+            sage: Gd = G.dual_group(names='AB')
+            sage: Gd.list()
+            (1, B, B^2, A, A*B, A*B^2)
+        """
+        if not self.is_finite():
+            raise NotImplementedError("the group must be finite")
+        invs = self.gens_orders()
+        return tuple(self(t) for t in mrange(invs))
+
+    def __iter__(self):
+        """
+        Return an iterator over the elements of this group.
+
+        EXAMPLES::
+
+            sage: G = AbelianGroup([2,3], names='ab')
+            sage: Gd = G.dual_group(names='AB')
+            sage: [X for X in Gd]
+            [1, B, B^2, A, A*B, A*B^2]
+
+            sage: # needs sage.rings.real_mpfr
+            sage: N = 43^2 - 1
+            sage: G = AbelianGroup([N], names='a')
+            sage: Gd = G.dual_group(names='A', base_ring=CC)
+            sage: a, = G.gens()
+            sage: A, = Gd.gens()
+            sage: x = a^(N/4)
+            sage: y = a^(N/3)
+            sage: z = a^(N/14)
+            sage: len([X for X in Gd
+            ....:      if abs(X(x)-1)>0.01 and abs(X(y)-1)>0.01 and abs(X(z)-1)>0.01])
+            880
+        """
+        yield from self.list()