geometor.polyhedra.pyramid

Exact symbolic geometry of the Great Pyramid, Kepler triangle, and circle quadrature.

Provides 100% exact algebraic models over Q, Q(phi), Q(sqrt(phi)), and Q(pi) for:

  • The Great Pyramid architectural profiles (Kepler Golden, Pi-Quadrature, Seked 14:11, and Half-Octahedron).

  • Certified exact algebraic identities connecting the Kepler Pyramid, Herodotus’s area law, phi harmonics, and the regular icosahedron.

  • 3D Solid3D manifold builders (Kepler Pyramid, Seked Pyramid, and Golden Square Bipyramid).

  • 2D geometor.model constructions (Kepler Right Triangle and Squaring the Circle Cosmogram).

Attributes

SQRT_PHI

Classes

PyramidModelProfile

Exact symbolic specification of a Great Pyramid architectural or geometric model.

Functions

get_great_pyramid_profiles() → dict[str, PyramidModelProfile]

Returns mapping of canonical Great Pyramid model profiles.

get_great_pyramid_profile(slug) → PyramidModelProfile

Retrieves a single Great Pyramid model profile by slug.

verify_kepler_pyramid_identities() → dict[str, tuple[sympy.Expr, sympy.Expr]]

Certifies the eleven foundational exact identities of the Great Pyramid models.

build_kepler_pyramid_solid(*[, center_origin]) → geometor.polyhedra.model3d.primitives.Solid3D

Constructs the exact 3D Solid3D model of the Kepler Golden Pyramid over Q(sqrt(phi)).

build_seked_pyramid_solid(*[, royal_cubits, center_origin]) → geometor.polyhedra.model3d.primitives.Solid3D

Constructs the exact 3D Solid3D model of the Seked 14:11 Khufu Pyramid.

build_kepler_bipyramid_solid() → geometor.polyhedra.model3d.primitives.Solid3D

Constructs the exact 3D Golden Square Bipyramid over Q(sqrt(phi)).

build_kepler_triangle_model() → tuple[geometor.model.Model, dict[str, sympy.Expr]]

Constructs the exact 2D Kepler Right Triangle model over Q(sqrt(phi)).

build_pyramid_squaring_circle_model() → tuple[geometor.model.Model, dict[str, sympy.Expr]]

Constructs the Great Pyramid Squaring the Circle & Earth-Moon Cosmogram in 2D.

Module Contents

geometor.polyhedra.pyramid.SQRT_PHI: sympy.Expr
class geometor.polyhedra.pyramid.PyramidModelProfile

Exact symbolic specification of a Great Pyramid architectural or geometric model.

Variables:
  • slug – Unique identifier (‘kepler_golden’, ‘pi_quadrature’, ‘seked_14_11’, ‘half_octahedron’).

  • title – Descriptive human-readable title.

  • historical_source – Primary source or historical citation.

  • half_base – Exact half-base length (unit baseline = 1).

  • height – Exact vertical apex height h above base.

  • apothem – Exact face altitude (slant height) s = sqrt(half_base^2 + height^2).

  • lateral_edge – Exact edge length from base corner to apex.

  • base_perimeter – Exact perimeter of square base (8 * half_base).

  • apex_circle_circumference – Exact circumference 2 * pi * height.

  • base_area – Exact base area (4 * half_base^2).

  • face_area – Exact area of one triangular lateral face (half_base * apothem).

  • lateral_area – Exact total lateral area of the four triangular faces (4 * face_area).

  • total_area – Exact total surface area (base_area + lateral_area).

  • volume – Exact solid volume (1/3 * base_area * height).

  • slope_spread – Exact Rational Trigonometry face slope spread sin^2(alpha) = h^2 / s^2.

  • adjacent_dihedral_spread – Exact spread between normals of adjacent lateral faces.

  • opposite_apex_spread – Exact spread between opposite meridian apothems.

slug: str
title: str
historical_source: str
half_base: sympy.Expr
height: sympy.Expr
apothem: sympy.Expr
lateral_edge: sympy.Expr
base_perimeter: sympy.Expr
apex_circle_circumference: sympy.Expr
base_area: sympy.Expr
face_area: sympy.Expr
lateral_area: sympy.Expr
total_area: sympy.Expr
volume: sympy.Expr
slope_spread: sympy.Expr
adjacent_dihedral_spread: sympy.Expr | None
opposite_apex_spread: sympy.Expr
__post_init__() → None

Validates that all symbolic parameters contain no floats or sp.Float atoms.

geometor.polyhedra.pyramid.get_great_pyramid_profiles() → dict[str, PyramidModelProfile]

Returns mapping of canonical Great Pyramid model profiles.

Returns:

Mapping of slug identifiers to PyramidModelProfile specifications.

geometor.polyhedra.pyramid.get_great_pyramid_profile(slug: str) → PyramidModelProfile

Retrieves a single Great Pyramid model profile by slug.

Parameters:

slug – Unique identifier (‘kepler_golden’, ‘pi_quadrature’, ‘seked_14_11’, ‘half_octahedron’).

Returns:

Corresponding PyramidModelProfile.

Raises:

KeyError – If slug is not recognized.

geometor.polyhedra.pyramid.verify_kepler_pyramid_identities() → dict[str, tuple[sympy.Expr, sympy.Expr]]

Certifies the eleven foundational exact identities of the Great Pyramid models.

Certifies Herodotus’s area law, Kepler’s right triangle geometric progression, golden ratio area ratios, the icosahedron circumquadrance bridge, Rational Trigonometry slope and dihedral spreads, and Rhind Papyrus Seked 14:11 relations.

Returns:

Mapping of identity names to exact (lhs, rhs) pairs where sp.simplify(lhs - rhs) == 0.

geometor.polyhedra.pyramid.build_kepler_pyramid_solid(*, center_origin: bool = False) → geometor.polyhedra.model3d.primitives.Solid3D

Constructs the exact 3D Solid3D model of the Kepler Golden Pyramid over Q(sqrt(phi)).

When center_origin is False (default), the square base rests on z = 0 with corners (±1, ±1, 0) and apex at (0, 0, sqrt(phi)). When center_origin is True, the Z coordinates are shifted downward by h/4 = sqrt(phi)/4 so that the centroid is at (0, 0, 0), placing the origin strictly inside the solid. This guarantees is_outward_oriented(), vacuate(), and polar_dual() behave as valid 3D manifolds.

Parameters:

center_origin – If True, shifts vertices along Z by -h/4 to center the solid.

Returns:

Exact symbolic Solid3D instance.

geometor.polyhedra.pyramid.build_seked_pyramid_solid(*, royal_cubits: bool = False, center_origin: bool = False) → geometor.polyhedra.model3d.primitives.Solid3D

Constructs the exact 3D Solid3D model of the Seked 14:11 Khufu Pyramid.

When royal_cubits is True, half-base is 220 and height is 280 (base 440 x 440 cubits, height 280 cubits). When royal_cubits is False (default), unit half-base 1 and height 14/11 are used. When center_origin is True, vertices are shifted along Z by -h/4 so the origin is at the solid’s interior centroid.

Parameters:
  • royal_cubits – If True, uses historical Khufu dimensions (220, 280 cubits).

  • center_origin – If True, shifts vertices along Z by -h/4 to center the solid.

Returns:

Exact symbolic Solid3D instance.

geometor.polyhedra.pyramid.build_kepler_bipyramid_solid() → geometor.polyhedra.model3d.primitives.Solid3D

Constructs the exact 3D Golden Square Bipyramid over Q(sqrt(phi)).

Formed by reflecting the Kepler Golden Pyramid across its square base z = 0, producing an 8-faced convex polyhedron with 6 vertices: (±1, ±1, 0), (0, 0, sqrt(phi)), and (0, 0, -sqrt(phi)).

Returns:

Exact symbolic Solid3D instance centered at (0, 0, 0).

geometor.polyhedra.pyramid.build_kepler_triangle_model() → tuple[geometor.model.Model, dict[str, sympy.Expr]]

Constructs the exact 2D Kepler Right Triangle model over Q(sqrt(phi)).

Constructs unit base O(0, 0), A(1, 0), W(-1, 0), midpoint E(1/2, 0), north point N(0, 1), golden section point P(phi, 0), midpoint K((phi - 1)/2, 0), Thales circle cutting positive Y-axis at B(0, sqrt(phi)), Kepler Right Triangle OAB, and altitude foot H dividing hypotenuse AB into golden major BH = 1 and minor HA = phi - 1 = 1/phi.

Returns:

Tuple of (Model, metrics_dict) with certified exact SymPy quadrances.

geometor.polyhedra.pyramid.build_pyramid_squaring_circle_model() → tuple[geometor.model.Model, dict[str, sympy.Expr]]

Constructs the Great Pyramid Squaring the Circle & Earth-Moon Cosmogram in 2D.

Constructs:

  • Base square corners SW(-1, -1), SE(1, -1), NE(1, 1), NW(-1, 1) of side 2, perimeter 8, and area 4.

  • Meridian pyramid triangle on base W(-1, 0) to E(1, 0) with apex S(0, sqrt(phi)).

  • Apex circle centered at O(0, 0) passing through S(0, sqrt(phi)) with radius R = sqrt(phi) and circumference 2 * pi * sqrt(phi) ≈ 8.

  • Inscribed Earth circle centered at O(0, 0) passing through T(0, 1) and E(1, 0) tangent to the square of side 2 (radius 1).

  • Tangent Moon circle centered at apex S(0, sqrt(phi)) tangent to the Earth circle at T(0, 1) with radius sqrt(phi) - 1 ≈ 3/11.

Returns:

Tuple of (Model, metrics_dict) certifying exact symbolic circle-squaring metrics.