# hkatsura/amorphousdiskmark architecture

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

## Overview

AmorphousDiskMark is a macOS storage benchmark. Users select a volume, choose benchmark settings, run sequential or random reads and writes, then view or copy formatted results. The README describes AppDelegate as the UI controller and test orchestrator, DiskMark as the threaded I/O engine, and DiskUtil as the volume utility. The graph preserves documented display, unit, and export capabilities; source excerpts are headers only, so several implementation-level links remain unverified.

Main entry points: [`AmorphousDiskMark/AmorphousDiskMark/AppDelegate.m`](https://github.com/hkatsura/amorphousdiskmark/blob/main/AmorphousDiskMark/AmorphousDiskMark/AppDelegate.m) (App controller), [`AmorphousDiskMark/AmorphousDiskMark/DiskMark.m`](https://github.com/hkatsura/amorphousdiskmark/blob/main/AmorphousDiskMark/AmorphousDiskMark/DiskMark.m) (Benchmark engine), [`AmorphousDiskMark/AmorphousDiskMark/DiskUtil.m`](https://github.com/hkatsura/amorphousdiskmark/blob/main/AmorphousDiskMark/AmorphousDiskMark/DiskUtil.m) (Volume utilities), [`AmorphousDiskMark/AmorphousDiskMark/DMButton.m`](https://github.com/hkatsura/amorphousdiskmark/blob/main/AmorphousDiskMark/AmorphousDiskMark/DMButton.m) (Benchmark controls)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_workflow["Benchmark workflow"]
  node_app["App controller<br/>[AppDelegate.m]"]
  node_settings["Test settings<br/>[AppDelegate.m]"]
  node_engine["Benchmark engine<br/>[DiskMark.m]"]
  node_testfile["Temporary test file<br/>[DiskUtil.m]"]
end

subgraph group_volume["Volume services"]
  node_volume_picker["Volume selection<br/>[AppDelegate.m]"]
  node_volume_util["Volume utilities<br/>[DiskUtil.m]"]
end

subgraph group_presentation["Results and interface"]
  node_results["Measurements<br/>[DiskMark.m]"]
  node_result_view["Result display<br/>[DMTextView.m]"]
  node_text_export["Text results<br/>[AppDelegate.m]"]
end

subgraph group_ui_helpers["UI components"]
  node_controls["Benchmark controls<br/>[DMButton.m]"]
  node_button_cell["Button styling<br/>[DMButtonCell.m]"]
  node_media_icon["Media icons<br/>[DMMediaIcon.m]"]
  node_link_field["Link field<br/>[LinkTextField.m]"]
end

node_user(("User"))
node_diskarb["DiskArbitration"]

node_user -->|"operates"| node_app
node_app -->|"selects volume"| node_volume_picker
node_app -->|"configures tests"| node_settings
node_app -->|"orchestrates"| node_engine
node_engine -->|"benchmarks with"| node_testfile
node_app -->|"enumerates volumes"| node_volume_util
node_volume_util -->|"uses"| node_diskarb
node_engine -->|"measures"| node_results
node_results -.->|"displays"| node_result_view
node_user -->|"copies results"| node_text_export
node_controls -.->|"uses cell"| node_button_cell

click node_app "https://github.com/hkatsura/amorphousdiskmark/blob/main/AmorphousDiskMark/AmorphousDiskMark/AppDelegate.m"
click node_settings "https://github.com/hkatsura/amorphousdiskmark/blob/main/AmorphousDiskMark/AmorphousDiskMark/AppDelegate.m"
click node_engine "https://github.com/hkatsura/amorphousdiskmark/blob/main/AmorphousDiskMark/AmorphousDiskMark/DiskMark.m"
click node_testfile "https://github.com/hkatsura/amorphousdiskmark/blob/main/AmorphousDiskMark/AmorphousDiskMark/DiskUtil.m"
click node_volume_picker "https://github.com/hkatsura/amorphousdiskmark/blob/main/AmorphousDiskMark/AmorphousDiskMark/AppDelegate.m"
click node_volume_util "https://github.com/hkatsura/amorphousdiskmark/blob/main/AmorphousDiskMark/AmorphousDiskMark/DiskUtil.m"
click node_results "https://github.com/hkatsura/amorphousdiskmark/blob/main/AmorphousDiskMark/AmorphousDiskMark/DiskMark.m"
click node_result_view "https://github.com/hkatsura/amorphousdiskmark/blob/main/AmorphousDiskMark/AmorphousDiskMark/DMTextView.m"
click node_text_export "https://github.com/hkatsura/amorphousdiskmark/blob/main/AmorphousDiskMark/AmorphousDiskMark/AppDelegate.m"
click node_controls "https://github.com/hkatsura/amorphousdiskmark/blob/main/AmorphousDiskMark/AmorphousDiskMark/DMButton.m"
click node_button_cell "https://github.com/hkatsura/amorphousdiskmark/blob/main/AmorphousDiskMark/AmorphousDiskMark/DMButtonCell.m"
click node_media_icon "https://github.com/hkatsura/amorphousdiskmark/blob/main/AmorphousDiskMark/AmorphousDiskMark/DMMediaIcon.m"
click node_link_field "https://github.com/hkatsura/amorphousdiskmark/blob/main/AmorphousDiskMark/AmorphousDiskMark/LinkTextField.m"

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_app,node_settings,node_engine,node_testfile,node_user toneBlue
class node_volume_picker,node_volume_util toneAmber
class node_results,node_result_view,node_text_export toneMint
class node_controls,node_button_cell,node_media_icon,node_link_field toneRose
class node_diskarb toneIndigo
```

## Components

### Benchmark workflow

- [App controller](https://github.com/hkatsura/amorphousdiskmark/blob/main/AmorphousDiskMark/AmorphousDiskMark/AppDelegate.m): `AmorphousDiskMark/AmorphousDiskMark/AppDelegate.m`
- [Test settings](https://github.com/hkatsura/amorphousdiskmark/blob/main/AmorphousDiskMark/AmorphousDiskMark/AppDelegate.m): `AmorphousDiskMark/AmorphousDiskMark/AppDelegate.m`
- [Benchmark engine](https://github.com/hkatsura/amorphousdiskmark/blob/main/AmorphousDiskMark/AmorphousDiskMark/DiskMark.m): `AmorphousDiskMark/AmorphousDiskMark/DiskMark.m`
- [Temporary test file](https://github.com/hkatsura/amorphousdiskmark/blob/main/AmorphousDiskMark/AmorphousDiskMark/DiskUtil.m): `AmorphousDiskMark/AmorphousDiskMark/DiskUtil.m`

### Volume services

- [Volume selection](https://github.com/hkatsura/amorphousdiskmark/blob/main/AmorphousDiskMark/AmorphousDiskMark/AppDelegate.m): `AmorphousDiskMark/AmorphousDiskMark/AppDelegate.m`
- [Volume utilities](https://github.com/hkatsura/amorphousdiskmark/blob/main/AmorphousDiskMark/AmorphousDiskMark/DiskUtil.m): `AmorphousDiskMark/AmorphousDiskMark/DiskUtil.m`

### Results and interface

- [Measurements](https://github.com/hkatsura/amorphousdiskmark/blob/main/AmorphousDiskMark/AmorphousDiskMark/DiskMark.m): `AmorphousDiskMark/AmorphousDiskMark/DiskMark.m`
- [Result display](https://github.com/hkatsura/amorphousdiskmark/blob/main/AmorphousDiskMark/AmorphousDiskMark/DMTextView.m): `AmorphousDiskMark/AmorphousDiskMark/DMTextView.m`
- [Text results](https://github.com/hkatsura/amorphousdiskmark/blob/main/AmorphousDiskMark/AmorphousDiskMark/AppDelegate.m): `AmorphousDiskMark/AmorphousDiskMark/AppDelegate.m`

### UI components

- [Benchmark controls](https://github.com/hkatsura/amorphousdiskmark/blob/main/AmorphousDiskMark/AmorphousDiskMark/DMButton.m): `AmorphousDiskMark/AmorphousDiskMark/DMButton.m`
- [Button styling](https://github.com/hkatsura/amorphousdiskmark/blob/main/AmorphousDiskMark/AmorphousDiskMark/DMButtonCell.m): `AmorphousDiskMark/AmorphousDiskMark/DMButtonCell.m`
- [Media icons](https://github.com/hkatsura/amorphousdiskmark/blob/main/AmorphousDiskMark/AmorphousDiskMark/DMMediaIcon.m): `AmorphousDiskMark/AmorphousDiskMark/DMMediaIcon.m`
- [Link field](https://github.com/hkatsura/amorphousdiskmark/blob/main/AmorphousDiskMark/AmorphousDiskMark/LinkTextField.m): `AmorphousDiskMark/AmorphousDiskMark/LinkTextField.m`

### Other components

- **User**
- **DiskArbitration**

## Connections

- User → App controller: operates (evidence: `README.md`)
- App controller → Volume selection: selects volume (evidence: `README.md`)
- App controller → Test settings: configures tests (evidence: `README.md`)
- App controller → Benchmark engine: orchestrates (evidence: `README.md`)
- Benchmark engine → Temporary test file: benchmarks with (evidence: `README.md`)
- App controller → Volume utilities: enumerates volumes (evidence: `README.md`)
- Volume utilities → DiskArbitration: uses (evidence: `README.md`)
- Benchmark engine → Measurements: measures (evidence: `README.md`)
- Measurements → Result display: displays
- User → Text results: copies results (evidence: `README.md`)
- Benchmark controls → Button styling: uses cell
