low-index

library1.2.1pypypi✓ verified 80d ago

A Python library for enumerating low index subgroups of finitely presented groups. Version 1.2.1 supports Python >=3.8. Stable release with infrequent updates.

analytics

pip install low-index

github ↗homepage ↗

INSTALL

IMPORT

SIG · LOW-INDEX

low-index

analyticspythonv1.2.1

harness data pending

Install & Compatibility

Where this runs

No compatibility data collected yet for this library.

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

AbstractSimsNode

✓ from low_index import AbstractSimsNode

✗ from low_index import LowIndexSubgroups

SimsTree

✓ from low_index import SimsTree

✗ from low_index import LowIndexSubgroups

parse_word

✓ from low_index import parse_word

✗ from low_index import LowIndexSubgroups

Define a finitely presented group and enumerate its low index subgroups.

from low_index import LowIndexSubgroups, FinitelyPresentedGroup # Define a finitely presented group: <a, b | a^2 = b^3 = 1> fp_group = FinitelyPresentedGroup(['a', 'b'], ['a^2', 'b^3']) # Enumerate subgroups of index up to 6 subgroups = LowIndexSubgroups(fp_group, max_index=6).enumerate() for subgroup in subgroups: print(subgroup.generators())

Debug

Known issues

gotchaThe library's group definition syntax may differ from Sage's; ensure to use the internal FinitelyPresentedGroup class.

fix

Use `from low_index import FinitelyPresentedGroup` rather than importing from Sage.

affects: all

deprecatedThe function `low_index_subgroups` may be removed in a future release; use the class-based API.

fix

Replace calls to `low_index_subgroups(...)` with `LowIndexSubgroups(...).enumerate()`.

affects: >=1.0

gotchaEnumeration can be exponential; setting max_index too large may hang or exhaust memory.

fix

Start with small max_index (e.g., 4) and increase gradually.

affects: all

Upgrade

Version history

1.2.1latest on PyPI · released Jan 13, 2025

Audit

Dependencies

sageoptionalRequired for advanced group theory functionality (optional if only using pure Python core)

gapoptionalRequired for GAP integration (optional if only using pure Python core)

Agent activity

23 hits · last 30 days

node

OpenAI (training)

Resources

githubhttps://github.com/3-manifolds/low_index ↗

homepagehttps://github.com/3-manifolds/low_index ↗