# mattatz/curvo architecture

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

- Interactive diagram: https://gitdiagram.com/mattatz/curvo
- Repository: https://github.com/mattatz/curvo

## Overview

Curvo is a Rust NURBS curve and surface modeling library. A typical workflow creates or interpolates curves, uses them to construct surfaces, then tessellates the geometry for downstream visualization. The library also provides curve/surface analysis and editing, region and boolean operations, and additional modeling tools such as offsetting and filleting. The graph uses README-documented workflows and capabilities; sampled source confirms selected internal relationships, while unsampled implementations are represented only at subsystem level.

Main entry points: [`src/curve/nurbs_curve.rs`](https://github.com/mattatz/curvo/blob/main/src/curve/nurbs_curve.rs) (NURBS Curves), [`src/surface/nurbs_surface.rs`](https://github.com/mattatz/curvo/blob/main/src/surface/nurbs_surface.rs) (NURBS Surfaces), [`src/interpolation/curve.rs`](https://github.com/mattatz/curvo/blob/main/src/interpolation/curve.rs) (Curve Interpolation), [`src/split/mod.rs`](https://github.com/mattatz/curvo/blob/main/src/split/mod.rs) (Curve And Surface Split)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_geometry["Geometry Core"]
  node_curve["NURBS Curves<br/>[nurbs_curve.rs]"]
  node_curve_eval["Curve Evaluation<br/>[curve_evaluator.rs]"]
  node_knots["Knot Vectors<br/>[knot_vector.rs]"]
  node_regions["Regions<br/>[compound_curve.rs]"]
  node_surface["NURBS Surfaces<br/>[nurbs_surface.rs]"]
  node_math["Geometry Utilities<br/>[mod.rs]"]
  node_interpolation["Curve Interpolation<br/>[curve.rs]"]
end

subgraph group_analysis["Geometry Analysis"]
  node_bounds["Bounding Boxes<br/>[mod.rs]"]
  node_closest["Closest Parameters"]
  node_intersections["Curve Intersections"]
  node_discontinuity["Discontinuity Analysis<br/>[curve.rs]"]
end

subgraph group_editing["Editing Operations"]
  node_split["Curve And Surface Split<br/>[mod.rs]"]
  node_trim["Curve Trimming<br/>[mod.rs]"]
  node_boolean["Boolean Operations<br/>[boolean_region.rs]"]
end

subgraph group_modeling["Modeling Tools"]
  node_offset["Curve Offsetting"]
  node_fillet["Curve Filleting"]
  node_morph["Surface Morphing<br/>[curve_morph.rs]"]
end

subgraph group_output["Mesh Output"]
  node_tessellation["Tessellation"]
end

node_engineer(("Library User"))

node_engineer -->|"interpolates points"| node_interpolation
node_engineer -->|"creates curves"| node_curve
node_interpolation -->|"produces curves"| node_curve
node_curve -->|"constructs surfaces"| node_surface
node_surface -->|"tessellates"| node_tessellation
node_engineer -->|"finds closest point"| node_closest
node_engineer -->|"finds intersections"| node_intersections
node_engineer -->|"divides geometry"| node_split
node_engineer -->|"runs booleans"| node_boolean
node_engineer -->|"offsets curves"| node_offset
node_engineer -->|"fillets curves"| node_fillet
node_engineer -->|"morphs geometry"| node_morph
node_engineer -->|"analyzes continuity"| node_discontinuity
node_engineer -->|"queries bounds"| node_bounds
node_curve -->|"evaluates with"| node_curve_eval
node_curve -->|"uses knots"| node_knots
node_curve -->|"uses utilities"| node_math
node_trim -->|"splits curves"| node_split

click node_curve "https://github.com/mattatz/curvo/blob/main/src/curve/nurbs_curve.rs"
click node_curve_eval "https://github.com/mattatz/curvo/blob/main/src/curve/curve_evaluator.rs"
click node_knots "https://github.com/mattatz/curvo/blob/main/src/knot/knot_vector.rs"
click node_regions "https://github.com/mattatz/curvo/blob/main/src/region/compound_curve.rs"
click node_surface "https://github.com/mattatz/curvo/blob/main/src/surface/nurbs_surface.rs"
click node_math "https://github.com/mattatz/curvo/blob/main/src/misc/mod.rs"
click node_interpolation "https://github.com/mattatz/curvo/blob/main/src/interpolation/curve.rs"
click node_bounds "https://github.com/mattatz/curvo/blob/main/src/bounding_box/mod.rs"
click node_closest "https://github.com/mattatz/curvo/blob/main/src/closest_parameter/curve_closest_parameter_newton.rs"
click node_intersections "https://github.com/mattatz/curvo/blob/main/src/intersects/curve_curve/intersection_curve_curve.rs"
click node_discontinuity "https://github.com/mattatz/curvo/blob/main/src/discontinuity/curve.rs"
click node_split "https://github.com/mattatz/curvo/blob/main/src/split/mod.rs"
click node_trim "https://github.com/mattatz/curvo/blob/main/src/trim/mod.rs"
click node_boolean "https://github.com/mattatz/curvo/blob/main/src/boolean/boolean_region.rs"
click node_offset "https://github.com/mattatz/curvo/blob/main/src/offset/offset_nurbs_curve.rs"
click node_fillet "https://github.com/mattatz/curvo/blob/main/src/fillet/fillet_nurbs_curve.rs"
click node_morph "https://github.com/mattatz/curvo/blob/main/src/morph/curve_morph.rs"
click node_tessellation "https://github.com/mattatz/curvo/blob/main/src/tessellation/surface_tessellation.rs"

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_curve,node_curve_eval,node_knots,node_regions,node_surface,node_math,node_interpolation,node_engineer toneBlue
class node_bounds,node_closest,node_intersections,node_discontinuity toneAmber
class node_split,node_trim,node_boolean toneMint
class node_offset,node_fillet,node_morph toneRose
class node_tessellation toneIndigo
```

## Components

### Geometry Core

- [NURBS Curves](https://github.com/mattatz/curvo/blob/main/src/curve/nurbs_curve.rs): `src/curve/nurbs_curve.rs`
- [Curve Evaluation](https://github.com/mattatz/curvo/blob/main/src/curve/curve_evaluator.rs): `src/curve/curve_evaluator.rs`
- [Knot Vectors](https://github.com/mattatz/curvo/blob/main/src/knot/knot_vector.rs): `src/knot/knot_vector.rs`
- [Regions](https://github.com/mattatz/curvo/blob/main/src/region/compound_curve.rs): `src/region/compound_curve.rs`
- [NURBS Surfaces](https://github.com/mattatz/curvo/blob/main/src/surface/nurbs_surface.rs): `src/surface/nurbs_surface.rs`
- [Geometry Utilities](https://github.com/mattatz/curvo/blob/main/src/misc/mod.rs): `src/misc/mod.rs`
- [Curve Interpolation](https://github.com/mattatz/curvo/blob/main/src/interpolation/curve.rs): `src/interpolation/curve.rs`

### Geometry Analysis

- [Bounding Boxes](https://github.com/mattatz/curvo/blob/main/src/bounding_box/mod.rs): `src/bounding_box/mod.rs`
- [Closest Parameters](https://github.com/mattatz/curvo/blob/main/src/closest_parameter/curve_closest_parameter_newton.rs): `src/closest_parameter/curve_closest_parameter_newton.rs`
- [Curve Intersections](https://github.com/mattatz/curvo/blob/main/src/intersects/curve_curve/intersection_curve_curve.rs): `src/intersects/curve_curve/intersection_curve_curve.rs`
- [Discontinuity Analysis](https://github.com/mattatz/curvo/blob/main/src/discontinuity/curve.rs): `src/discontinuity/curve.rs`

### Editing Operations

- [Curve And Surface Split](https://github.com/mattatz/curvo/blob/main/src/split/mod.rs): `src/split/mod.rs`
- [Curve Trimming](https://github.com/mattatz/curvo/blob/main/src/trim/mod.rs): `src/trim/mod.rs`
- [Boolean Operations](https://github.com/mattatz/curvo/blob/main/src/boolean/boolean_region.rs): `src/boolean/boolean_region.rs`

### Modeling Tools

- [Curve Offsetting](https://github.com/mattatz/curvo/blob/main/src/offset/offset_nurbs_curve.rs): `src/offset/offset_nurbs_curve.rs`
- [Curve Filleting](https://github.com/mattatz/curvo/blob/main/src/fillet/fillet_nurbs_curve.rs): `src/fillet/fillet_nurbs_curve.rs`
- [Surface Morphing](https://github.com/mattatz/curvo/blob/main/src/morph/curve_morph.rs): `src/morph/curve_morph.rs`

### Mesh Output

- [Tessellation](https://github.com/mattatz/curvo/blob/main/src/tessellation/surface_tessellation.rs): `src/tessellation/surface_tessellation.rs`

### Other components

- **Library User**

## Connections

- Library User → Curve Interpolation: interpolates points
- Library User → NURBS Curves: creates curves
- Curve Interpolation → NURBS Curves: produces curves
- NURBS Curves → NURBS Surfaces: constructs surfaces
- NURBS Surfaces → Tessellation: tessellates
- Library User → Closest Parameters: finds closest point
- Library User → Curve Intersections: finds intersections
- Library User → Curve And Surface Split: divides geometry
- Library User → Boolean Operations: runs booleans
- Library User → Curve Offsetting: offsets curves
- Library User → Curve Filleting: fillets curves
- Library User → Surface Morphing: morphs geometry
- Library User → Discontinuity Analysis: analyzes continuity
- Library User → Bounding Boxes: queries bounds (evidence: `src/bounding_box/mod.rs`)
- NURBS Curves → Curve Evaluation: evaluates with (evidence: `src/curve/nurbs_curve.rs`)
- NURBS Curves → Knot Vectors: uses knots (evidence: `src/curve/nurbs_curve.rs`)
- NURBS Curves → Geometry Utilities: uses utilities (evidence: `src/curve/nurbs_curve.rs`)
- Curve Trimming → Curve And Surface Split: splits curves (evidence: `src/trim/mod.rs`)
