Documentation

LeanPool.ClassificationOfSurfaces.CellComplex

Finite surface cell complexes #

This file owns the shared combinatorial API between the topological triangulation route and the Gallier-Xu normal-form route. The definitions are still intentionally light, but the public names and theorem boundaries match the Moise/PL blueprint.

The raw finite incidence data underlying a Gallier-Xu surface cell complex.

Validity and connectedness are derived from this data by IsSurfaceValid and IsConnected, rather than stored as unconstrained propositions. Its faithful polygonal realization is constructed separately from the boundary occurrences.

  • Face : Type

    The type of faces in the cell complex.

  • Dart : Type

    The type of oriented darts in the cell complex.

  • Vertex : Type

    The type of vertices in the cell complex.

  • faceFintype : Fintype self.Face
  • dartFintype : Fintype self.Dart
  • vertexFintype : Fintype self.Vertex
  • inv : self.Dart self.Dart

    Reversal of an oriented dart.

  • source : self.Dartself.Vertex

    The source vertex of an oriented dart.

  • target : self.Dartself.Vertex

    The target vertex of an oriented dart.

  • boundary : self.FaceList self.Dart

    The cyclic boundary word of each face.

  • inv_involutive (d : self.Dart) : self.inv (self.inv d) = d
  • inv_source (d : self.Dart) : self.source (self.inv d) = self.target d
  • inv_target (d : self.Dart) : self.target (self.inv d) = self.source d
Instances For

    The number of faces in a finite surface cell complex.

    Equations
    Instances For

      The number of oriented darts in a finite surface cell complex.

      Equations
      Instances For

        The number of vertices in a finite surface cell complex.

        Equations
        Instances For
          @[reducible, inline]

          The length of a face boundary word.

          Equations
          Instances For
            @[reducible, inline]

            A position in one of the stored, positively oriented face boundaries.

            Equations
            Instances For

              The dart stored at a boundary occurrence.

              Equations
              Instances For

                Two darts name the same unoriented edge.

                Equations
                Instances For

                  A boundary position belongs to the unoriented edge named by d.

                  Equations
                  Instances For

                    The unoriented edge named by d occurs at exactly one boundary position.

                    Equations
                    Instances For

                      The unoriented edge named by d occurs at exactly two boundary positions.

                      Equations
                      Instances For

                        Boundary status derived from incidence: the edge orbit of d occurs exactly once.

                        Equations
                        Instances For

                          Incidence validity for the stored face-boundary system.

                          There is at least one face, different faces have different cyclic boundary words, inverse darts are distinct, and every unoriented edge occurs either once (a boundary edge) or twice (an inner edge). Boundary status and occurrence counts are derived from explicit boundary positions, so repeated darts such as the projective-plane word a a are retained. The stored vertex endpoints are an enrichment of Gallier--Xu's boundary-word data and are deliberately not part of this predicate.

                          Equations
                          • One or more equations did not get rendered due to their size.
                          Instances For
                            @[simp]

                            Inverting the chosen representative does not change its unoriented edge.

                            @[simp]

                            Inverting the chosen representative does not change which boundary positions it occupies.

                            @[simp]

                            Boundary status is invariant under reversing the representative dart.

                            Inverse darts in a valid incidence system are distinct.

                            Two faces are adjacent when their boundaries use the same unoriented edge.

                            Equations
                            Instances For

                              Gallier-Xu connectivity of the face-edge incidence system.

                              Equations
                              Instances For

                                A signed occurrence of a named edge in a polygonal boundary word.

                                Instances For
                                  Equations
                                  • One or more equations did not get rendered due to their size.
                                  Instances For
                                    Equations
                                    • One or more equations did not get rendered due to their size.
                                    Instances For
                                      @[instance_reducible]
                                      Equations
                                      • One or more equations did not get rendered due to their size.

                                      Orientation reversal as an equivalence.

                                      Equations
                                      • One or more equations did not get rendered due to their size.
                                      Instances For
                                        @[reducible, inline]

                                        A single-face polygonal presentation with all edge names based at one vertex.

                                        This constructor is intentionally simple. It is useful for normal-form examples and for the Gallier-Xu boundary-word API.

                                        Equations
                                        • One or more equations did not get rendered due to their size.
                                        Instances For

                                          Every one-face presentation is connected in the face-edge incidence sense.

                                          Convert an oriented triangulation edge occurrence to a cell-complex signed dart.

                                          Equations
                                          • One or more equations did not get rendered due to their size.
                                          Instances For

                                            The sphere presented as two monogons with oppositely oriented copies of one edge.

                                            The nonempty boundary presentation is equivalent to Gallier--Xu's empty-word sphere and is directly compatible with the polygonal occurrence adapter.

                                            Equations
                                            • One or more equations did not get rendered due to their size.
                                            Instances For

                                              The two-monogon presentation of the sphere has valid incidence data.

                                              The two faces of the sphere presentation are connected through their common edge.

                                              @[reducible, inline]

                                              Raw compatibility bridge from the ledgered triangulation record to stored cell-presentation data.

                                              This conversion does not prove IsSurfaceValid or IsConnected; in particular, those properties do not follow from FiniteSurfaceTriangulation.Valid. New geometric work should start from GeometricTriangulation, and downstream cellulation work must separately certify the incidence predicates.

                                              Equations
                                              • One or more equations did not get rendered due to their size.
                                              Instances For