# opensynap/10-x-eeg-reference-head architecture

> Architecture diagram of the GitHub repository opensynap/10-x-eeg-reference-head, 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/opensynap/10-x-eeg-reference-head
- Repository: https://github.com/opensynap/10-x-eeg-reference-head

## Overview

This repository is a static EEG reference resource, not a runtime application. Its main workflow is for users to obtain canonical electrode coordinates, visual reference renders, or downloadable 3D head models for the 10-20, 10-10, and 10-5 systems. The README identifies CSVs as canonical and renders as visualization assets, not coordinate-generation inputs. Model packages are distributed through GitHub Releases; their files are not present in the supplied tree. Relationships shown are documented in the README.

Main entry points: [`coordinates/10-20.csv`](https://github.com/opensynap/10-x-eeg-reference-head/blob/main/coordinates/10-20.csv) (10-20 coordinates), [`coordinates/10-10.csv`](https://github.com/opensynap/10-x-eeg-reference-head/blob/main/coordinates/10-10.csv) (10-10 coordinates), [`coordinates/10-5.csv`](https://github.com/opensynap/10-x-eeg-reference-head/blob/main/coordinates/10-5.csv) (10-5 coordinates), [`renders/10-5`](https://github.com/opensynap/10-x-eeg-reference-head/tree/main/renders/10-5) (10-20 renders)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_coordinates["Canonical coordinates"]
  node_coord20["10-20 coordinates<br/>[10-20.csv]"]
  node_coord10["10-10 coordinates<br/>[10-10.csv]"]
  node_coord5["10-5 coordinates<br/>[10-5.csv]"]
end

subgraph group_visuals["Visual references"]
  node_render20["10-20 renders"]
  node_render10["10-10 renders"]
  node_render5["10-5 renders"]
end

subgraph group_models["3D model downloads"]
  node_releases["GitHub Releases"]
  node_model20["10-20 model"]
  node_model10["10-10 model"]
  node_model5["10-5 model"]
  node_bare["Bare head model"]
end

node_user(("Resource user"))

node_user -->|"obtains coordinates"| node_coord20
node_user -->|"obtains coordinates"| node_coord10
node_user -->|"obtains coordinates"| node_coord5
node_user -->|"views references"| node_render20
node_user -->|"views references"| node_render10
node_user -->|"views references"| node_render5
node_user -->|"downloads models"| node_releases
node_releases -->|"offers package"| node_model20
node_releases -->|"offers package"| node_model10
node_releases -->|"offers package"| node_model5
node_releases -->|"offers package"| node_bare

click node_coord20 "https://github.com/opensynap/10-x-eeg-reference-head/blob/main/coordinates/10-20.csv"
click node_coord10 "https://github.com/opensynap/10-x-eeg-reference-head/blob/main/coordinates/10-10.csv"
click node_coord5 "https://github.com/opensynap/10-x-eeg-reference-head/blob/main/coordinates/10-5.csv"
click node_render20 "https://github.com/opensynap/10-x-eeg-reference-head/tree/main/renders/10-5"
click node_render10 "https://github.com/opensynap/10-x-eeg-reference-head/tree/main/renders/10-10"
click node_render5 "https://github.com/opensynap/10-x-eeg-reference-head/tree/main/renders/10-20"

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_coord20,node_coord10,node_coord5,node_user toneBlue
class node_render20,node_render10,node_render5 toneAmber
class node_releases,node_model20,node_model10,node_model5,node_bare toneMint
```

## Components

### Canonical coordinates

- [10-20 coordinates](https://github.com/opensynap/10-x-eeg-reference-head/blob/main/coordinates/10-20.csv): `coordinates/10-20.csv`
- [10-10 coordinates](https://github.com/opensynap/10-x-eeg-reference-head/blob/main/coordinates/10-10.csv): `coordinates/10-10.csv`
- [10-5 coordinates](https://github.com/opensynap/10-x-eeg-reference-head/blob/main/coordinates/10-5.csv): `coordinates/10-5.csv`

### Visual references

- [10-20 renders](https://github.com/opensynap/10-x-eeg-reference-head/tree/main/renders/10-5): `renders/10-5`
- [10-10 renders](https://github.com/opensynap/10-x-eeg-reference-head/tree/main/renders/10-10): `renders/10-10`
- [10-5 renders](https://github.com/opensynap/10-x-eeg-reference-head/tree/main/renders/10-20): `renders/10-20`

### 3D model downloads

- **GitHub Releases**
- **10-20 model**
- **10-10 model**
- **10-5 model**
- **Bare head model**

### Other components

- **Resource user**

## Connections

- Resource user → 10-20 coordinates: obtains coordinates (evidence: `README.md`)
- Resource user → 10-10 coordinates: obtains coordinates (evidence: `README.md`)
- Resource user → 10-5 coordinates: obtains coordinates (evidence: `README.md`)
- Resource user → 10-20 renders: views references (evidence: `README.md`)
- Resource user → 10-10 renders: views references (evidence: `README.md`)
- Resource user → 10-5 renders: views references (evidence: `README.md`)
- Resource user → GitHub Releases: downloads models (evidence: `README.md`)
- GitHub Releases → 10-20 model: offers package (evidence: `README.md`)
- GitHub Releases → 10-10 model: offers package (evidence: `README.md`)
- GitHub Releases → 10-5 model: offers package (evidence: `README.md`)
- GitHub Releases → Bare head model: offers package (evidence: `README.md`)
