prime-link-knot-10

Provide the prime knot and link catalogue used by the TopLink generator.

Installation

pip install prime-link-knot-10

Usage example

import prime_link_knot_10

catalogue = prime_link_knot_10.load_pd_code()
print(catalogue["K3a1"])
print(prime_link_knot_10.get_all_prime_under10()[:5])
print("K4a1" in prime_link_knot_10.load_amphicheiral())

Algorithm

Package data is loaded once and cached. PD records from knot, link, mirror, and non-mirror tables are merged into one dictionary. Mirror duplicates of amphicheiral objects are omitted. Names are sorted structurally by crossing number, object type, alternating class, table index, and mirror status. A depth-first multiset enumeration supplies all prime-factor combinations up to a crossing bound.

Input conventions

A PD code is represented as a list of four-entry crossings. Arc labels normally occur exactly twice. Public functions validate inputs and return new values rather than mutating caller-owned data unless their API explicitly says otherwise.

External software

No external software is required. All catalogue files are included in the wheel and sdist.

Development

Run examples and package checks before release. Python packages require Python 3.10 or newer. Build PyPI artifacts with:

poetry check
poetry build

License

MIT. See LICENSE.