Skip to content

topology · SimplicialCollapseSequence

8 accepted declarations. Python and Rust forms, contracts, evidence, failure boundaries, and checked usages are kept together below.

Worked example

The complete checked program Build and verify an isomorphism between two presentations of F_25 uses this API directly.

# SPDX-License-Identifier: MIT
# Copyright (c) 2026 Benjamin Antieau and Deven Manam
"""Build and verify an isomorphism between two presentations of F_25."""

from noether.numthy import FiniteField


def main() -> None:
    source = FiniteField.extension(5, 2)
    target = FiniteField.with_modulus(5, [2, 0, 1])
    isomorphism = source.isomorphism_to(target)
    isomorphism.verify()
    value = source.element_from_coefficients([3, 2])
    assert isomorphism.apply_inverse(isomorphism(value)) == value
    print(f"a maps to {isomorphism.generator_image}")


if __name__ == "__main__":
    main()

Run it with .venv/bin/python examples/09_finite_field_isomorphisms.py.

topology.SimplicialCollapseSequence

A verified sequence of elementary simplicial collapses.

class SimplicialCollapseSequence

noether::topology::SimplicialCollapseSequence · Direct Rust declaration

pub struct SimplicialCollapseSequence { /* private fields */ }
Contract Value
Guarantee checked deterministic result
Determinism deterministic
Availability default CPU build
Domain implementation crates noether, geom-core, m4rst, m4rste
GIL attached / bounded
Semantic ID noether/topology/SimplicialCollapseSequence@1

Executable usage: validation/unit/topology/test_simplicial_complex_facade.py:103 · validation/unit/topology/test_simplicial_complex_facade.py:109 · validation/unit/topology/test_simplicial_complex_facade.py:21

topology.SimplicialCollapseSequence.from_json

Deserialize and revalidate a SimplicialCollapseSequence from typed JSON.

Detailed contract

Deserialize, replay, and verify the complete collapse sequence.

(cls, value: str) -> SimplicialCollapseSequence

noether::topology::SimplicialCollapseSequence::from_json · Direct Rust declaration

pub fn from_json(value: &str) -> Result<Self, NoetherError>
Contract Value
Guarantee checked deterministic result
Determinism deterministic
Availability default CPU build
Domain implementation crates noether, geom-core, m4rst, m4rste
GIL attached / bounded
Semantic ID noether/topology/SimplicialCollapseSequence@1

Executable usage: validation/unit/category/test_category.py:14 · validation/unit/combin/test_acceptance_workload.py:65 · validation/unit/combin/test_acceptance_workload.py:86 · validation/unit/combin/test_graph_facade.py:106 · validation/unit/combin/test_graph_facade.py:25 · validation/unit/combinatorics/test_kashiwara_crystal.py:32

topology.SimplicialCollapseSequence.is_terminal

Test whether this SimplicialCollapseSequence is terminal.

Detailed contract

Whether no further elementary collapse is available at the target.

(self) -> bool

noether::topology::SimplicialCollapseSequence::is_terminal · Direct Rust declaration

pub fn is_terminal(&self) -> bool
Contract Value
Guarantee checked deterministic result
Determinism deterministic
Availability default CPU build
Domain implementation crates noether, geom-core, m4rst, m4rste
GIL attached / bounded
Semantic ID noether/topology/SimplicialCollapseSequence@1

Executable usage: validation/unit/topology/test_simplicial_complex_facade.py:106 · validation/unit/topology/test_simplicial_set_facade.py:99

topology.SimplicialCollapseSequence.source

Return the source recorded by this SimplicialCollapseSequence.

Detailed contract

Source complex before any collapse.

(self) -> SimplicialComplex

noether::topology::SimplicialCollapseSequence::source · Direct Rust declaration

pub fn source(&self) -> &SimplicialComplex
Contract Value
Guarantee checked deterministic result
Determinism deterministic
Availability default CPU build
Domain implementation crates noether, geom-core, m4rst, m4rste
GIL attached / bounded
Semantic ID noether/topology/SimplicialCollapseSequence@1

Executable usage: examples/09_finite_field_isomorphisms.py:11 · examples/09_finite_field_isomorphisms.py:13 · examples/09_finite_field_isomorphisms.py:9 · examples/30_modules_and_resolutions.py:34 · examples/30_modules_and_resolutions.py:37 · validation/unit/category/test_acceptance_workload.py:25

topology.SimplicialCollapseSequence.steps

Return the steps recorded by this SimplicialCollapseSequence.

Detailed contract

Ordered free-face/coface pairs.

(self) -> list[ElementaryCollapse]

noether::topology::SimplicialCollapseSequence::steps · Direct Rust declaration

pub fn steps(&self) -> &[ElementaryCollapse]
Contract Value
Guarantee checked deterministic result
Determinism deterministic
Availability default CPU build
Domain implementation crates noether, geom-core, m4rst, m4rste
GIL attached / bounded
Semantic ID noether/topology/SimplicialCollapseSequence@1

Executable usage: validation/unit/groups/test_acceptance_workload.py:69 · validation/unit/groups/test_acceptance_workload.py:70 · validation/unit/groups/test_acceptance_workload.py:71 · validation/unit/topology/test_simplicial_complex_facade.py:84 · validation/corpus/numthy/padic-newton-cube-root.py:3

topology.SimplicialCollapseSequence.target

Return the target recorded by this SimplicialCollapseSequence.

Detailed contract

Target reconstructed by replaying all steps.

(self) -> SimplicialComplex

noether::topology::SimplicialCollapseSequence::target · Direct Rust declaration

pub fn target(&self) -> &SimplicialComplex
Contract Value
Guarantee checked deterministic result
Determinism deterministic
Availability default CPU build
Domain implementation crates noether, geom-core, m4rst, m4rste
GIL attached / bounded
Semantic ID noether/topology/SimplicialCollapseSequence@1

Executable usage: examples/09_finite_field_isomorphisms.py:10 · examples/09_finite_field_isomorphisms.py:11 · examples/30_modules_and_resolutions.py:33 · examples/30_modules_and_resolutions.py:38 · examples/31_local_fields_and_precision.py:27 · examples/36_affine_normalization.py:16

topology.SimplicialCollapseSequence.to_json

Serialize this SimplicialCollapseSequence to its canonical typed JSON representation.

Detailed contract

Serialize only the source and replayable steps; the target is derived.

(self) -> str

noether::topology::SimplicialCollapseSequence::to_json · Direct Rust declaration

pub fn to_json(&self) -> Result<String, NoetherError>
Contract Value
Guarantee checked deterministic result
Determinism deterministic
Availability default CPU build
Domain implementation crates noether, geom-core, m4rst, m4rste
GIL attached / bounded
Semantic ID noether/topology/SimplicialCollapseSequence@1

Executable usage: validation/unit/category/test_category.py:14 · validation/unit/category/test_category.py:15 · validation/unit/combin/test_acceptance_workload.py:30 · validation/unit/combin/test_acceptance_workload.py:65 · validation/unit/combin/test_acceptance_workload.py:86 · validation/unit/combin/test_graph_facade.py:106

topology.SimplicialCollapseSequence.verify

Replay and verify the mathematical evidence carried by this SimplicialCollapseSequence.

Detailed contract

Recheck every freeness condition and reconstruct the target.

(self) -> None

noether::topology::SimplicialCollapseSequence::verify · Direct Rust declaration

pub fn verify(&self) -> Result<(), TopologyError>
Contract Value
Guarantee checked deterministic result
Determinism deterministic
Availability default CPU build
Domain implementation crates noether, geom-core, m4rst, m4rste
GIL attached / bounded
Semantic ID noether/topology/SimplicialCollapseSequence@1

Executable usage: examples/01_bezout_certificates.py:10 · examples/01_bezout_certificates.py:3 · examples/03_exact_linear_systems.py:13 · examples/03_exact_linear_systems.py:3 · examples/04_smith_normal_form.py:12 · examples/06_shortest_lattice_vectors.py:12