# ansys/pyansys-geometry architecture

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

- Interactive diagram: https://gitdiagram.com/ansys/pyansys-geometry
- Repository: https://github.com/ansys/pyansys-geometry

## Overview

PyAnsys Geometry is a Python client for Ansys Geometry and related CAD products. Users construct geometry locally with math and sketch primitives, connect to a Geometry service, create and edit designs, then inspect or export the result. The repository also exposes selection, preparation, repair, measurement, and plotting capabilities. The README documents the main sketch-to-design workflow; sampled source and the SOURCE INDEX establish selected service, modeler, face, and plotting relationships. Other unsampled subsystem links are omitted rather than inferred.

Main entry points: [`src/ansys/geometry/core/modeler.py`](https://github.com/ansys/pyansys-geometry/blob/main/src/ansys/geometry/core/modeler.py) (Modeler session), [`src/ansys/geometry/core/designer/design.py`](https://github.com/ansys/pyansys-geometry/blob/main/src/ansys/geometry/core/designer/design.py) (Design operations), [`src/ansys/geometry/core/connection/client.py`](https://github.com/ansys/pyansys-geometry/blob/main/src/ansys/geometry/core/connection/client.py) (Service client), [`src/ansys/geometry/core/_grpc/_services/_service.py`](https://github.com/ansys/pyansys-geometry/blob/main/src/ansys/geometry/core/_grpc/_services/_service.py) (gRPC services)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_geometry["Geometry primitives"]
  node_math["Math types<br/>[point.py]"]
  node_sketch["Sketch authoring<br/>[sketch.py]"]
end

subgraph group_session["Session and transport"]
  node_modeler["Modeler session<br/>[modeler.py]"]
  node_client["Service client<br/>[client.py]"]
  node_grpc["gRPC services<br/>[_service.py]"]
end

subgraph group_model["Design modeling"]
  node_design["Design operations<br/>[design.py]"]
  node_commands["Geometry commands"]
  node_body["Bodies<br/>[body.py]"]
  node_component["Components<br/>[component.py]"]
  node_face["Faces<br/>[face.py]"]
  node_selection["Selection builders"]
end

subgraph group_tools["Model tools"]
  node_measure["Measurement tools"]
  node_prepare["Preparation tools<br/>[prepare_tools.py]"]
  node_repair["Repair tools<br/>[repair_tools.py]"]
  node_rayfire["Rayfire tools<br/>[rayfire_tools.py]"]
end

subgraph group_results["Output and inspection"]
  node_plot["Plotting<br/>[plotter.py]"]
  node_export["Design export<br/>[design.py]"]
  node_usd["USD export<br/>[usd_export.py]"]
end

node_user(("Python user"))
node_backend{{"Geometry backend"}}

node_user -->|"defines geometry"| node_math
node_user -->|"creates sketch"| node_sketch
node_user -->|"launches session"| node_modeler
node_math -->|"sets sketch plane"| node_sketch
node_modeler -->|"creates client"| node_client
node_client -->|"uses services"| node_grpc
node_grpc -.->|"sends requests"| node_backend
node_modeler -->|"creates design"| node_design
node_design -->|"executes operations"| node_commands
node_design -->|"uses client"| node_client
node_design -->|"creates bodies"| node_body
node_body -->|"constructs faces"| node_face
node_face -->|"requests surface data"| node_grpc
node_design -->|"manages components"| node_component
node_modeler -->|"provides builders"| node_selection
node_modeler -->|"provides tools"| node_measure
node_modeler -->|"provides tools"| node_prepare
node_modeler -->|"provides tools"| node_repair
node_modeler -->|"provides tools"| node_rayfire
node_design -->|"plots design"| node_plot
node_user -->|"exports design"| node_export
node_design -->|"exports files"| node_export
node_plot -.->|"exports scene"| node_usd

click node_math "https://github.com/ansys/pyansys-geometry/blob/main/src/ansys/geometry/core/math/point.py"
click node_sketch "https://github.com/ansys/pyansys-geometry/blob/main/src/ansys/geometry/core/sketch/sketch.py"
click node_modeler "https://github.com/ansys/pyansys-geometry/blob/main/src/ansys/geometry/core/modeler.py"
click node_client "https://github.com/ansys/pyansys-geometry/blob/main/src/ansys/geometry/core/connection/client.py"
click node_grpc "https://github.com/ansys/pyansys-geometry/blob/main/src/ansys/geometry/core/_grpc/_services/_service.py"
click node_design "https://github.com/ansys/pyansys-geometry/blob/main/src/ansys/geometry/core/designer/design.py"
click node_commands "https://github.com/ansys/pyansys-geometry/blob/main/src/ansys/geometry/core/designer/geometry_commands.py"
click node_body "https://github.com/ansys/pyansys-geometry/blob/main/src/ansys/geometry/core/designer/body.py"
click node_component "https://github.com/ansys/pyansys-geometry/blob/main/src/ansys/geometry/core/designer/component.py"
click node_face "https://github.com/ansys/pyansys-geometry/blob/main/src/ansys/geometry/core/designer/face.py"
click node_selection "https://github.com/ansys/pyansys-geometry/blob/main/src/ansys/geometry/core/selection_builder/selection_builder.py"
click node_measure "https://github.com/ansys/pyansys-geometry/blob/main/src/ansys/geometry/core/tools/measurement_tools.py"
click node_prepare "https://github.com/ansys/pyansys-geometry/blob/main/src/ansys/geometry/core/tools/prepare_tools.py"
click node_repair "https://github.com/ansys/pyansys-geometry/blob/main/src/ansys/geometry/core/tools/repair_tools.py"
click node_rayfire "https://github.com/ansys/pyansys-geometry/blob/main/src/ansys/geometry/core/tools/rayfire_tools.py"
click node_plot "https://github.com/ansys/pyansys-geometry/blob/main/src/ansys/geometry/core/plotting/plotter.py"
click node_export "https://github.com/ansys/pyansys-geometry/blob/main/src/ansys/geometry/core/designer/design.py"
click node_usd "https://github.com/ansys/pyansys-geometry/blob/main/src/ansys/geometry/core/plotting/usd_export.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_math,node_sketch,node_user toneBlue
class node_modeler,node_client,node_grpc toneAmber
class node_design,node_commands,node_body,node_component,node_face,node_selection toneMint
class node_measure,node_prepare,node_repair,node_rayfire toneRose
class node_plot,node_export,node_usd,node_backend toneIndigo
```

## Components

### Geometry primitives

- [Math types](https://github.com/ansys/pyansys-geometry/blob/main/src/ansys/geometry/core/math/point.py): `src/ansys/geometry/core/math/point.py`
- [Sketch authoring](https://github.com/ansys/pyansys-geometry/blob/main/src/ansys/geometry/core/sketch/sketch.py): `src/ansys/geometry/core/sketch/sketch.py`

### Session and transport

- [Modeler session](https://github.com/ansys/pyansys-geometry/blob/main/src/ansys/geometry/core/modeler.py): `src/ansys/geometry/core/modeler.py`
- [Service client](https://github.com/ansys/pyansys-geometry/blob/main/src/ansys/geometry/core/connection/client.py): `src/ansys/geometry/core/connection/client.py`
- [gRPC services](https://github.com/ansys/pyansys-geometry/blob/main/src/ansys/geometry/core/_grpc/_services/_service.py): `src/ansys/geometry/core/_grpc/_services/_service.py`

### Design modeling

- [Design operations](https://github.com/ansys/pyansys-geometry/blob/main/src/ansys/geometry/core/designer/design.py): `src/ansys/geometry/core/designer/design.py`
- [Geometry commands](https://github.com/ansys/pyansys-geometry/blob/main/src/ansys/geometry/core/designer/geometry_commands.py): `src/ansys/geometry/core/designer/geometry_commands.py`
- [Bodies](https://github.com/ansys/pyansys-geometry/blob/main/src/ansys/geometry/core/designer/body.py): `src/ansys/geometry/core/designer/body.py`
- [Components](https://github.com/ansys/pyansys-geometry/blob/main/src/ansys/geometry/core/designer/component.py): `src/ansys/geometry/core/designer/component.py`
- [Faces](https://github.com/ansys/pyansys-geometry/blob/main/src/ansys/geometry/core/designer/face.py): `src/ansys/geometry/core/designer/face.py`
- [Selection builders](https://github.com/ansys/pyansys-geometry/blob/main/src/ansys/geometry/core/selection_builder/selection_builder.py): `src/ansys/geometry/core/selection_builder/selection_builder.py`

### Model tools

- [Measurement tools](https://github.com/ansys/pyansys-geometry/blob/main/src/ansys/geometry/core/tools/measurement_tools.py): `src/ansys/geometry/core/tools/measurement_tools.py`
- [Preparation tools](https://github.com/ansys/pyansys-geometry/blob/main/src/ansys/geometry/core/tools/prepare_tools.py): `src/ansys/geometry/core/tools/prepare_tools.py`
- [Repair tools](https://github.com/ansys/pyansys-geometry/blob/main/src/ansys/geometry/core/tools/repair_tools.py): `src/ansys/geometry/core/tools/repair_tools.py`
- [Rayfire tools](https://github.com/ansys/pyansys-geometry/blob/main/src/ansys/geometry/core/tools/rayfire_tools.py): `src/ansys/geometry/core/tools/rayfire_tools.py`

### Output and inspection

- [Plotting](https://github.com/ansys/pyansys-geometry/blob/main/src/ansys/geometry/core/plotting/plotter.py): `src/ansys/geometry/core/plotting/plotter.py`
- [Design export](https://github.com/ansys/pyansys-geometry/blob/main/src/ansys/geometry/core/designer/design.py): `src/ansys/geometry/core/designer/design.py`
- [USD export](https://github.com/ansys/pyansys-geometry/blob/main/src/ansys/geometry/core/plotting/usd_export.py): `src/ansys/geometry/core/plotting/usd_export.py`

### Other components

- **Python user**
- **Geometry backend**

## Connections

- Python user → Math types: defines geometry
- Python user → Sketch authoring: creates sketch
- Python user → Modeler session: launches session
- Math types → Sketch authoring: sets sketch plane (evidence: `src/ansys/geometry/core/sketch/sketch.py`)
- Modeler session → Service client: creates client (evidence: `src/ansys/geometry/core/modeler.py`)
- Service client → gRPC services: uses services (evidence: `src/ansys/geometry/core/connection/client.py`)
- gRPC services → Geometry backend: sends requests
- Modeler session → Design operations: creates design (evidence: `src/ansys/geometry/core/modeler.py`)
- Design operations → Geometry commands: executes operations (evidence: `src/ansys/geometry/core/designer/geometry_commands.py`)
- Design operations → Service client: uses client (evidence: `src/ansys/geometry/core/modeler.py`)
- Design operations → Bodies: creates bodies (evidence: `src/ansys/geometry/core/misc/auxiliary.py`)
- Bodies → Faces: constructs faces (evidence: `src/ansys/geometry/core/designer/body.py`)
- Faces → gRPC services: requests surface data (evidence: `src/ansys/geometry/core/designer/face.py`)
- Design operations → Components: manages components (evidence: `src/ansys/geometry/core/designer/component.py`)
- Modeler session → Selection builders: provides builders (evidence: `src/ansys/geometry/core/modeler.py`)
- Modeler session → Measurement tools: provides tools (evidence: `src/ansys/geometry/core/modeler.py`)
- Modeler session → Preparation tools: provides tools (evidence: `src/ansys/geometry/core/modeler.py`)
- Modeler session → Repair tools: provides tools (evidence: `src/ansys/geometry/core/modeler.py`)
- Modeler session → Rayfire tools: provides tools (evidence: `src/ansys/geometry/core/modeler.py`)
- Design operations → Plotting: plots design (evidence: `src/ansys/geometry/core/plotting/plotter.py`)
- Python user → Design export: exports design
- Design operations → Design export: exports files (evidence: `src/ansys/geometry/core/designer/design.py`)
- Plotting → USD export: exports scene
