# tricorderproject/openct architecture

> Architecture diagram of the GitHub repository tricorderproject/openct, 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/tricorderproject/openct
- Repository: https://github.com/tricorderproject/openct

## Overview

OpenCT is an early-alpha open-hardware desktop CT scanner intended for academic and educational use. The documented user goal is operating a scanner to perform CT imaging; the repository contains Arduino firmware, an external-comparator PCB design, and mechanical CAD. The README and file tree do not show how these parts connect or how measurements become images, so those relationships are marked unverified rather than inferred as a runtime pipeline.

Main entry points: [`README.md`](https://github.com/tricorderproject/openct/blob/master/README.md) (OpenCT scanner), [`arduino/openct_alpha4/openct_alpha4.ino`](https://github.com/tricorderproject/openct/blob/master/arduino/openct_alpha4/openct_alpha4.ino) (Arduino firmware), [`pcb/external_comparator/type5comparator.sch`](https://github.com/tricorderproject/openct/blob/master/pcb/external_comparator/type5comparator.sch) (External comparator), [`structure`](https://github.com/tricorderproject/openct/tree/master/structure) (Scanner mechanics)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_control["Control electronics"]
  node_firmware["Arduino firmware<br/>[openct_alpha4.ino]"]
end

subgraph group_detection["Detection electronics"]
  node_comparator["External comparator"]
end

subgraph group_mechanics["Mechanical design"]
  node_mechanical["Scanner mechanics"]
end

node_operator(("Scanner operator"))
node_scanner["OpenCT scanner<br/>[README.md]"]

node_operator -->|"uses for CT"| node_scanner
node_scanner -.->|"uses control"| node_firmware
node_scanner -.->|"uses detection"| node_comparator
node_scanner -.->|"uses mechanics"| node_mechanical

click node_scanner "https://github.com/tricorderproject/openct/blob/master/README.md"
click node_firmware "https://github.com/tricorderproject/openct/blob/master/arduino/openct_alpha4/openct_alpha4.ino"
click node_comparator "https://github.com/tricorderproject/openct/blob/master/pcb/external_comparator/type5comparator.sch"
click node_mechanical "https://github.com/tricorderproject/openct/tree/master/structure"

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_firmware toneBlue
class node_comparator toneAmber
class node_mechanical toneMint
class node_operator toneIndigo
class node_scanner toneTeal
```

## Components

### Control electronics

- [Arduino firmware](https://github.com/tricorderproject/openct/blob/master/arduino/openct_alpha4/openct_alpha4.ino): `arduino/openct_alpha4/openct_alpha4.ino`

### Detection electronics

- [External comparator](https://github.com/tricorderproject/openct/blob/master/pcb/external_comparator/type5comparator.sch): `pcb/external_comparator/type5comparator.sch`

### Mechanical design

- [Scanner mechanics](https://github.com/tricorderproject/openct/tree/master/structure): `structure`

### Other components

- **Scanner operator**
- [OpenCT scanner](https://github.com/tricorderproject/openct/blob/master/README.md): `README.md`

## Connections

- Scanner operator → OpenCT scanner: uses for CT (evidence: `README.md`)
- OpenCT scanner → Arduino firmware: uses control
- OpenCT scanner → External comparator: uses detection
- OpenCT scanner → Scanner mechanics: uses mechanics
