# vacationair/geom3py architecture

> Architecture diagram of the GitHub repository vacationair/geom3py, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-04). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/vacationair/geom3py
- Repository: https://github.com/vacationair/geom3py

## Overview

Geom3py is a pure-Python 3D analytical geometry library. Users import its object-oriented API to construct geometric primitives and shapes, then calculate measurements, spatial relationships, intersections, and transformations. Its own vector and numerical helpers support these calculations; OBJ loading and a camera/scene visualization subsystem provide additional capabilities. Relationships reflect the README and supplied source/index references; unsampled modules are represented by their exact paths, with no inferred internal call chains.

Main entry points: [`geom3py/__init__.py`](https://github.com/vacationair/geom3py/blob/main/geom3py/__init__.py) (Package API), [`geom3py/geometry/point.py`](https://github.com/vacationair/geom3py/blob/main/geom3py/geometry/point.py) (Point), [`geom3py/geometry/planar_shape.py`](https://github.com/vacationair/geom3py/blob/main/geom3py/geometry/planar_shape.py) (Planar Shape), [`geom3py/geometry/line.py`](https://github.com/vacationair/geom3py/blob/main/geom3py/geometry/line.py) (Line)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_api["Public API"]
  node_package_api["Package API<br/>[__init__.py]"]
end

subgraph group_geometry["Geometry Model"]
  node_vector["Vector<br/>[vector.py]"]
  node_point["Point<br/>[point.py]"]
  node_line["Line<br/>[line.py]"]
  node_plane["Plane<br/>[plane.py]"]
  node_planar_shape["Planar Shape<br/>[planar_shape.py]"]
  node_face["Face<br/>[face.py]"]
  node_polygon["Polygon<br/>[polygon.py]"]
  node_triangle["Triangle<br/>[triangle.py]"]
  node_box["Box<br/>[box.py]"]
  node_sphere["Sphere<br/>[sphere.py]"]
  node_triangulation["Triangulation<br/>[triangulation.py]"]
  node_obj_loader["OBJ Loader<br/>[obj_loader.py]"]
end

subgraph group_numerics["Numerical Core"]
  node_linal["Linear Algebra<br/>[linal_utils.py]"]
  node_transform["Transform Engine<br/>[transform_utils.py]"]
end

subgraph group_visualization["Visualization"]
  node_camera["Camera<br/>[camera.py]"]
  node_scene["Scene<br/>[scene.py]"]
end

node_user(("Library User"))

node_user -->|"imports"| node_package_api
node_package_api -->|"exports"| node_point
node_package_api -->|"exports"| node_vector
node_package_api -->|"exports"| node_line
node_package_api -->|"exports"| node_plane
node_package_api -->|"exports"| node_face
node_package_api -->|"exports"| node_box
node_package_api -->|"exports"| node_sphere
node_package_api -->|"exports"| node_polygon
node_package_api -->|"exports"| node_obj_loader
node_point -->|"extends"| node_vector
node_line -->|"uses"| node_vector
node_plane -->|"uses"| node_line
node_plane -->|"uses"| node_vector
node_planar_shape -->|"uses"| node_point
node_planar_shape -->|"uses"| node_vector
node_planar_shape -->|"uses"| node_line
node_planar_shape -->|"uses"| node_plane
node_face -->|"extends"| node_planar_shape
node_face -->|"constructs"| node_line
node_polygon -->|"uses"| node_point
node_polygon -->|"calls"| node_triangulation
node_triangle -->|"extends"| node_planar_shape
node_triangulation -->|"uses"| node_triangle
node_triangulation -->|"uses"| node_point
node_box -->|"constructs"| node_face
node_box -->|"uses"| node_point
node_sphere -->|"uses"| node_box
node_sphere -->|"uses"| node_line
node_sphere -->|"uses"| node_plane
node_obj_loader -->|"creates"| node_point
node_obj_loader -->|"creates"| node_polygon
node_vector -->|"delegates to"| node_transform
node_point -->|"uses"| node_linal
node_line -->|"uses"| node_linal
node_plane -->|"uses"| node_linal
node_planar_shape -->|"uses"| node_linal
node_polygon -->|"uses"| node_linal
node_box -->|"uses"| node_linal
node_sphere -->|"uses"| node_linal
node_camera -->|"projects"| node_point
node_camera -->|"redraws"| node_scene
node_scene -->|"uses"| node_camera
node_scene -->|"renders"| node_point
node_scene -->|"renders"| node_vector

click node_package_api "https://github.com/vacationair/geom3py/blob/main/geom3py/__init__.py"
click node_vector "https://github.com/vacationair/geom3py/blob/main/geom3py/geometry/vector.py"
click node_point "https://github.com/vacationair/geom3py/blob/main/geom3py/geometry/point.py"
click node_line "https://github.com/vacationair/geom3py/blob/main/geom3py/geometry/line.py"
click node_plane "https://github.com/vacationair/geom3py/blob/main/geom3py/geometry/plane.py"
click node_planar_shape "https://github.com/vacationair/geom3py/blob/main/geom3py/geometry/planar_shape.py"
click node_face "https://github.com/vacationair/geom3py/blob/main/geom3py/geometry/face.py"
click node_polygon "https://github.com/vacationair/geom3py/blob/main/geom3py/geometry/polygon.py"
click node_triangle "https://github.com/vacationair/geom3py/blob/main/geom3py/geometry/triangle.py"
click node_box "https://github.com/vacationair/geom3py/blob/main/geom3py/geometry/box.py"
click node_sphere "https://github.com/vacationair/geom3py/blob/main/geom3py/geometry/sphere.py"
click node_triangulation "https://github.com/vacationair/geom3py/blob/main/geom3py/geometry/triangulation.py"
click node_obj_loader "https://github.com/vacationair/geom3py/blob/main/geom3py/geometry/obj_loader.py"
click node_linal "https://github.com/vacationair/geom3py/blob/main/geom3py/utils/linal_utils.py"
click node_transform "https://github.com/vacationair/geom3py/blob/main/geom3py/utils/transform_utils.py"
click node_camera "https://github.com/vacationair/geom3py/blob/main/geom3py/visualization/camera.py"
click node_scene "https://github.com/vacationair/geom3py/blob/main/geom3py/visualization/scene.py"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_package_api,node_user toneBlue
class node_vector,node_point,node_line,node_plane,node_planar_shape,node_face,node_polygon,node_triangle,node_box,node_sphere,node_triangulation,node_obj_loader toneAmber
class node_linal,node_transform toneMint
class node_camera,node_scene toneRose
```

## Components

### Public API

- [Package API](https://github.com/vacationair/geom3py/blob/main/geom3py/__init__.py): `geom3py/__init__.py`

### Geometry Model

- [Vector](https://github.com/vacationair/geom3py/blob/main/geom3py/geometry/vector.py): `geom3py/geometry/vector.py`
- [Point](https://github.com/vacationair/geom3py/blob/main/geom3py/geometry/point.py): `geom3py/geometry/point.py`
- [Line](https://github.com/vacationair/geom3py/blob/main/geom3py/geometry/line.py): `geom3py/geometry/line.py`
- [Plane](https://github.com/vacationair/geom3py/blob/main/geom3py/geometry/plane.py): `geom3py/geometry/plane.py`
- [Planar Shape](https://github.com/vacationair/geom3py/blob/main/geom3py/geometry/planar_shape.py): `geom3py/geometry/planar_shape.py`
- [Face](https://github.com/vacationair/geom3py/blob/main/geom3py/geometry/face.py): `geom3py/geometry/face.py`
- [Polygon](https://github.com/vacationair/geom3py/blob/main/geom3py/geometry/polygon.py): `geom3py/geometry/polygon.py`
- [Triangle](https://github.com/vacationair/geom3py/blob/main/geom3py/geometry/triangle.py): `geom3py/geometry/triangle.py`
- [Box](https://github.com/vacationair/geom3py/blob/main/geom3py/geometry/box.py): `geom3py/geometry/box.py`
- [Sphere](https://github.com/vacationair/geom3py/blob/main/geom3py/geometry/sphere.py): `geom3py/geometry/sphere.py`
- [Triangulation](https://github.com/vacationair/geom3py/blob/main/geom3py/geometry/triangulation.py): `geom3py/geometry/triangulation.py`
- [OBJ Loader](https://github.com/vacationair/geom3py/blob/main/geom3py/geometry/obj_loader.py): `geom3py/geometry/obj_loader.py`

### Numerical Core

- [Linear Algebra](https://github.com/vacationair/geom3py/blob/main/geom3py/utils/linal_utils.py): `geom3py/utils/linal_utils.py`
- [Transform Engine](https://github.com/vacationair/geom3py/blob/main/geom3py/utils/transform_utils.py): `geom3py/utils/transform_utils.py`

### Visualization

- [Camera](https://github.com/vacationair/geom3py/blob/main/geom3py/visualization/camera.py): `geom3py/visualization/camera.py`
- [Scene](https://github.com/vacationair/geom3py/blob/main/geom3py/visualization/scene.py): `geom3py/visualization/scene.py`

### Other components

- **Library User**

## Connections

- Library User → Package API: imports (evidence: `README.md`)
- Package API → Point: exports (evidence: `geom3py/__init__.py`)
- Package API → Vector: exports (evidence: `geom3py/__init__.py`)
- Package API → Line: exports (evidence: `geom3py/__init__.py`)
- Package API → Plane: exports (evidence: `geom3py/__init__.py`)
- Package API → Face: exports (evidence: `geom3py/__init__.py`)
- Package API → Box: exports (evidence: `geom3py/__init__.py`)
- Package API → Sphere: exports (evidence: `geom3py/__init__.py`)
- Package API → Polygon: exports (evidence: `geom3py/__init__.py`)
- Package API → OBJ Loader: exports (evidence: `geom3py/__init__.py`)
- Point → Vector: extends (evidence: `geom3py/geometry/point.py`)
- Line → Vector: uses (evidence: `geom3py/geometry/line.py`)
- Plane → Line: uses (evidence: `geom3py/geometry/plane.py`)
- Plane → Vector: uses (evidence: `geom3py/geometry/plane.py`)
- Planar Shape → Point: uses (evidence: `geom3py/geometry/planar_shape.py`)
- Planar Shape → Vector: uses (evidence: `geom3py/geometry/planar_shape.py`)
- Planar Shape → Line: uses (evidence: `geom3py/geometry/planar_shape.py`)
- Planar Shape → Plane: uses (evidence: `geom3py/geometry/planar_shape.py`)
- Face → Planar Shape: extends (evidence: `geom3py/geometry/face.py`)
- Face → Line: constructs (evidence: `geom3py/geometry/face.py`)
- Polygon → Point: uses (evidence: `geom3py/geometry/polygon.py`)
- Polygon → Triangulation: calls (evidence: `geom3py/geometry/polygon.py`)
- Triangle → Planar Shape: extends (evidence: `geom3py/geometry/triangle.py`)
- Triangulation → Triangle: uses (evidence: `geom3py/geometry/triangulation.py`)
- Triangulation → Point: uses (evidence: `geom3py/geometry/triangulation.py`)
- Box → Face: constructs (evidence: `geom3py/geometry/box.py`)
- Box → Point: uses (evidence: `geom3py/geometry/box.py`)
- Sphere → Box: uses (evidence: `geom3py/geometry/sphere.py`)
- Sphere → Line: uses (evidence: `geom3py/geometry/sphere.py`)
- Sphere → Plane: uses (evidence: `geom3py/geometry/sphere.py`)
- OBJ Loader → Point: creates (evidence: `geom3py/geometry/obj_loader.py`)
- OBJ Loader → Polygon: creates (evidence: `geom3py/geometry/obj_loader.py`)
- Vector → Transform Engine: delegates to (evidence: `geom3py/geometry/vector.py`)
- Point → Linear Algebra: uses (evidence: `geom3py/geometry/point.py`)
- Line → Linear Algebra: uses (evidence: `geom3py/geometry/line.py`)
- Plane → Linear Algebra: uses (evidence: `geom3py/geometry/plane.py`)
- Planar Shape → Linear Algebra: uses (evidence: `geom3py/geometry/planar_shape.py`)
- Polygon → Linear Algebra: uses (evidence: `geom3py/geometry/polygon.py`)
- Box → Linear Algebra: uses (evidence: `geom3py/geometry/box.py`)
- Sphere → Linear Algebra: uses (evidence: `geom3py/geometry/sphere.py`)
- Camera → Point: projects (evidence: `geom3py/visualization/camera.py`)
- Camera → Scene: redraws (evidence: `geom3py/visualization/camera.py`)
- Scene → Camera: uses (evidence: `geom3py/visualization/scene.py`)
- Scene → Point: renders (evidence: `geom3py/visualization/scene.py`)
- Scene → Vector: renders (evidence: `geom3py/visualization/scene.py`)
