Foundations / Spatial

Source:

Purpose

ometeotl_foundations/spatial/ is the first-order spatial specialization of ometeotl_core. It provides concrete geometry types, coordinate value types, structural protocols, and generic containers — all in pure Python with no library dependency. A Shapely-backed adapter (ometeotl_adapters/spatial_shapely/) will implement the same protocols for production use.

Layer role in the three-tier architecture

ometeotl_core          — abstract model (Space, SpaceRelationGraph, …)
ometeotl_foundations   — first-order specialization (this layer)
ometeotl_adapters      — library-backed implementations (Shapely, NetworkX, …)

Public surface

FileExports
coordinates.pyCoordinate2D, Coordinate3D, GeoCoordinate, GridCell
coordinate_system.pyCoordinateKind, CoordinateSystem, CARTESIAN_2D, CARTESIAN_3D, WGS84, GRID
geometry.pyGeometry (Protocol)
bounding_box.pyBoundingBox
spatial_index.pySpatialIndex (Protocol)
spatial_backend.pySpatialBackend (Protocol)
geometric_space.pyGeometricSpace[G]
spatial_extent.pySpatialExtent[G]
spatial_map.pySpatialMap[G]
relation_derivation.pyderive_space_relations()

Pages in this section

Ometeotl

A Python library to build complex multi-agent simulations, wargames, and AI-driven strategies


Class reference for ometeotl_foundations/spatial — pure-Python spatial specialization layer