UOR Homology

IRI
https://uor.foundation/homology/
Prefix
homology:
Space
bridge
Comment
Simplicial complexes, chain complexes, boundary operators, and homology groups for structural reasoning.

This is a bridge-space namespace in the Resolve stage of the PRISM pipeline. It provides the resolution infrastructure — queries, partitions, observables, proofs, derivations, and traces that transform inputs into certified results.

Learn more: Pipeline Overview · Homological Analysis

Class hierarchy
Class hierarchy for UOR Homology namespace Simplex SimplicialComp FaceMap ChainGroup BoundaryOperat ChainComplex HomologyGroup NerveFunctor ChainFunctor KanComplex HornFiller PostnikovTrunc KInvariant DeformationCom

Imports

Classes

NameSubclass OfDisjoint WithComment
SimplexThingA k-simplex: a finite set of k+1 vertices drawn from constraint objects.
SimplicialComplexThingA simplicial complex: a set of simplices closed under taking faces.
FaceMapThingA face map d_i: removes vertex i from a simplex, producing a face.
ChainGroupThingA free abelian group generated by k-simplices (the k-th chain group C_k).
BoundaryOperatorThingThe boundary operator ∂_k: C_k → C_{k-1}. Satisfies ∂² = 0.
ChainComplexThingA chain complex: a sequence of chain groups connected by boundary operators.
HomologyGroupThingThe k-th homology group H_k = ker(∂_k) / im(∂_{k+1}). Measures k-dimensional holes.
NerveFunctorThingThe nerve functor N: maps a set of constraints to a simplicial complex.
ChainFunctorThingThe chain functor C: maps a simplicial complex to a chain complex.
KanComplexSimplicialComplexA simplicial set satisfying the Kan extension condition. The constraint nerve, when promoted from a SimplicialComplex to a KanComplex, carries a full homotopy type — not just its homology groups.
HornFillerThingA witness that a given horn (an incomplete simplex boundary) can be filled, certifying the Kan condition at a specific dimension and position.
PostnikovTruncationThingThe k-th Postnikov truncation τ≤k of the constraint nerve: a KanComplex whose homotopy groups πj vanish for j > k.
KInvariantThingThe k-invariant κk that classifies the extension from the (k−1)-truncation to the k-truncation of the Postnikov tower. Trivial κk means the truncation splits as a product.
DeformationComplexChainComplexThe deformation complex of a CompleteType T: a chain complex whose H⁰ = automorphisms, H¹ = first-order deformations, H² = obstructions to extending deformations.

Properties

NameKindFunctionalDomainRangeComment
dimensionDatatypetrueSimplexintegerThe dimension k of a simplex (number of vertices minus one).
vertexObjectfalseSimplexConstraintA vertex of this simplex, drawn from the set of constraint objects.
vertexCountDatatypetrueSimplexpositiveIntegerThe number of vertices in this simplex (dimension + 1).
isFaceOfObjectfalseSimplexSimplexIndicates that this simplex is a face of another simplex.
pinIntersectionObjectfalseSimplexSiteIndexA site coordinate in the partition whose intersection pins this simplex.
hasSimplexObjectfalseSimplicialComplexSimplexA simplex belonging to this simplicial complex.
maxDimensionDatatypetrueSimplicialComplexintegerThe maximum dimension of any simplex in this simplicial complex.
eulerCharacteristicDatatypetrueSimplicialComplexintegerThe Euler characteristic of this simplicial complex: the alternating sum of simplex counts by dimension.
simplicialVertexCountDatatypetrueSimplicialComplexnonNegativeIntegerThe total number of vertices (0-simplices) in this simplicial complex.
removesVertexDatatypetrueFaceMapnonNegativeIntegerThe index i of the vertex removed by this face map d_i.
sourceSimplexObjecttrueFaceMapSimplexThe source simplex of this face map.
targetFaceObjecttrueFaceMapSimplexThe target face (result simplex) of this face map.
degreeDatatypetrueChainGroupintegerThe degree k of this chain group (the dimension of its generating simplices).
rankDatatypetruenonNegativeIntegerThe rank of a free abelian group (number of generators).
generatedByObjectfalseChainGroupSimplexA simplex that generates this chain group.
sourceGroupObjecttrueBoundaryOperatorChainGroupThe source chain group C_k of this boundary operator.
targetGroupObjecttrueBoundaryOperatorChainGroupThe target chain group C_{k-1} of this boundary operator.
satisfiesBoundarySquaredZeroDatatypetrueBoundaryOperatorbooleanWhether this boundary operator satisfies the fundamental property ∂² = 0.
hasChainGroupObjectfalseChainComplexChainGroupA chain group belonging to this chain complex.
hasBoundaryObjectfalseChainComplexBoundaryOperatorA boundary operator belonging to this chain complex.
homologyDegreeDatatypetrueHomologyGroupintegerThe degree k of this homology group H_k.
bettiNumberDatatypetrueHomologyGroupnonNegativeIntegerThe Betti number β_k = rank(H_k): the rank of this homology group.
kanWitnessObjectfalseKanComplexHornFillerA horn filler witnessing the Kan condition for this complex.
hornDimensionDatatypetrueHornFillernonNegativeIntegerThe dimension of the horn that this filler completes.
hornPositionDatatypetrueHornFillernonNegativeIntegerThe position (missing face index) of the horn that this filler completes.
truncationLevelDatatypetruePostnikovTruncationnonNegativeIntegerThe truncation level k of this Postnikov truncation τ≤k.
truncationSourceObjecttruePostnikovTruncationKanComplexThe KanComplex from which this Postnikov truncation is derived.
kInvariantObjecttruePostnikovTruncationKInvariantThe k-invariant classifying the extension at this truncation level.
kInvariantTrivialDatatypetrueKInvariantbooleanTrue iff this k-invariant is trivial, meaning the Postnikov truncation splits as a product.
deformationBaseObjecttrueDeformationComplexCompleteTypeThe CompleteType whose deformation complex this is.
tangentDimensionDatatypetrueDeformationComplexnonNegativeIntegerThe dimension of the tangent space H¹(Def(T)): the number of first-order deformations.
obstructionDimensionDatatypetrueDeformationComplexnonNegativeIntegerThe dimension of the obstruction space H²(Def(T)): the number of independent obstructions to extending deformations.
groundedInObjecttrueBettiNumberHomologyGroupThe homology group that grounds this Betti number observable.
laplacianOfObjecttrueSpectralGapChainComplexThe chain complex whose Laplacian determines this spectral gap.
homologicalAnalysisObjecttrueResolutionStateChainComplexThe chain complex used for homological analysis of a resolution state.

Named Individuals

NameTypeComment
boundarySquaredZeroIdentity∂² = 0: the boundary of a boundary is zero.
  • lhs: term_boundarySquaredZero_lhs
  • rhs: term_boundarySquaredZero_rhs
  • forAll: term_boundarySquaredZero_forAll
  • verificationDomain: Topological
nerveFunctorNNerveFunctorThe nerve functor N: constraints → simplicial complex.
chainFunctorCChainFunctorThe chain functor C: simplicial complex → chain complex.
psi_4Identityψ_4: HomologyGroups → BettiNumbers (extraction functor).
  • lhs: term_psi_4_lhs
  • rhs: term_psi_4_rhs
  • forAll: term_psi_4_forAll
  • verificationDomain: Topological
indexBridgeIdentityIndex bridge: connects Euler characteristic to alternating Betti sum.
  • lhs: term_indexBridge_lhs
  • rhs: term_indexBridge_rhs
  • forAll: term_indexBridge_forAll
  • verificationDomain: Topological