{"id":28031,"library":"passagemath-groups","title":"passagemath-groups","description":"passagemath-groups is a component of the passagemath environment providing group theory and invariant theory functionality, including permutation groups, matrix groups, and algebraic groups. It relies on GAP and libgap. Current version 10.8.4, requiring Python >=3.11 and <3.15. Release cadence follows passagemath releases, typically one or two per year.","status":"active","version":"10.8.4","language":"python","source_language":"en","source_url":"https://github.com/passagemath/passagemath","tags":["group-theory","invariant-theory","sage","gap","passagemath","mathematics"],"install":[{"cmd":"pip install passagemath-groups passagemath-sage","lang":"bash","label":"Install with core dependencies"}],"dependencies":[{"reason":"Provides the SageMath library and interpreter, required for all passagemath modules.","package":"passagemath-sage","optional":false},{"reason":"Provides configuration and build system shared by all passagemath packages.","package":"passagemath-conf","optional":false},{"reason":"GAP system is required for group theory computations.","package":"gap-core","optional":false}],"imports":[{"note":"passagemath does not expose group classes at top-level; import from sage submodules.","wrong":"from passagemath.groups import PermutationGroup","symbol":"PermutationGroup","correct":"from sage.groups.perm_gps.permgroup import PermutationGroup"},{"note":"Named groups live in permgroup_named module.","wrong":"from passagemath.groups.perm_gps import SymmetricGroup","symbol":"SymmetricGroup","correct":"from sage.groups.perm_gps.permgroup_named import SymmetricGroup"}],"quickstart":{"code":"from sage.all import *\nfrom sage.groups.perm_gps.permgroup import PermutationGroup\nG = PermutationGroup([(1,2), (1,3,4)])\nprint(G.order())","lang":"python","description":"Create a permutation group on 4 points and compute its order."},"warnings":[{"fix":"Use Python 3.11, 3.12, or 3.14 (if available).","message":"Python 3.15 not yet supported; passagemath 10.x requires Python 3.11-3.14.","severity":"breaking","affected_versions":"10.x"},{"fix":"Use from sage.groups... import ...","message":"Do not import directly from passagemath.groups; the package is a namespace only. Use sage submodules instead.","severity":"gotcha","affected_versions":"all"},{"fix":"Check sage.groups.perm_gps.permgroup_named for current names.","message":"Some named groups moved or renamed in passagemath 10.x compared to SageMath 9.x.","severity":"deprecated","affected_versions":"10.x"}],"env_vars":null,"last_verified":"2026-05-09T00:00:00.000Z","next_check":"2026-08-07T00:00:00.000Z","problems":[{"fix":"pip install passagemath-sage","cause":"passagemath-sage or sage package not installed.","error":"ModuleNotFoundError: No module named 'sage'"},{"fix":"Use from sage.groups.perm_gps.permgroup import PermutationGroup","cause":"Trying to import directly from sage instead of submodule.","error":"ImportError: cannot import name 'PermutationGroup' from 'sage'"},{"fix":"pip install gap-core","cause":"GAP not installed.","error":"RuntimeError: You must install the GAP package 'gap-core' to use this functionality."}],"ecosystem":"pypi","meta_description":null,"install_score":null,"install_tag":null,"quickstart_score":null,"quickstart_tag":null}