# danieljohnwest/gstt-nir-computing architecture

> Architecture diagram of the GitHub repository danieljohnwest/gstt-nir-computing, 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/danieljohnwest/gstt-nir-computing
- Repository: https://github.com/danieljohnwest/gstt-nir-computing

## Overview

GSTT NIR Computing is a collection of reusable medical-imaging functions and project-specific workflows, rather than one application. Users select a project: Relaxometry QA produces maps and ROI statistics; Tarquin Analysis watches for spectroscopy DICOMs, processes matched pairs, archives a rendered result and sends it to PACS; Brainlab DTI Analysis guides diffusion preprocessing and tract work. The graph emphasizes these workflows and shared imaging capabilities. Relationships for unsampled modules are omitted; the source index supports some project-to-module references, but does not establish their runtime call order.

Main entry points: [`projects/Tarquin_Analysis/proc.py`](https://github.com/danieljohnwest/gstt-nir-computing/blob/main/projects/Tarquin_Analysis/proc.py) (Tarquin Analysis), [`projects/Brainlab-DTI-Analysis/main.py`](https://github.com/danieljohnwest/gstt-nir-computing/blob/main/projects/Brainlab-DTI-Analysis/main.py) (DTI workflow), [`projects/Relaxometry_QA/main.py`](https://github.com/danieljohnwest/gstt-nir-computing/blob/main/projects/Relaxometry_QA/main.py) (Relaxometry QA), [`functions/tarquin/run_tarquin.py`](https://github.com/danieljohnwest/gstt-nir-computing/blob/main/functions/tarquin/run_tarquin.py) (Tarquin runner)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_projects["Imaging workflows"]
  node_relax_app["Relaxometry QA<br/>[main.py]"]
  node_tarquin_app["Tarquin Analysis<br/>[proc.py]"]
end

subgraph group_relax["Relaxometry"]
  node_relax_maps["T1 / T2 maps<br/>[generate_T1_map.py]"]
  node_roi_detect["ROI detection<br/>[find_rois.py]"]
  node_roi_manual["Manual ROI selection"]
  node_roi_stats["ROI statistics"]
  node_relax_prompt["Input prompts<br/>[prompt_input.py]"]
end

subgraph group_spectro["Spectroscopy pipeline"]
  node_dicom_watch["DICOM watcher<br/>[proc.py]"]
  node_series_classify["Series classification"]
  node_pair_match["Pair matching"]
  node_spectro_check["Spectroscopy validation"]
  node_tarquin_runner["Tarquin runner<br/>[run_tarquin.py]"]
  node_tarquin_command["Command builder"]
  node_path_escape["Path escaping<br/>[escape_filepath.py]"]
  node_secondary_capture["Secondary Capture"]
  node_spectro_dataset["Spectroscopy dataset"]
end

subgraph group_shared["Shared imaging tools"]
  node_pdf_render["PDF rendering<br/>[pdf_to_png.py]"]
  node_pacs_push["PACS transfer"]
  node_anonymise["DICOM anonymisation<br/>[anonymise_dicom.py]"]
  node_file_list["File listing"]
  node_rf_logs["RF log parsing"]
end

subgraph group_dti["DTI analysis"]
  node_dti_app["DTI workflow<br/>[main.py]"]
  node_dti_utils["DTI utilities<br/>[dti_utils.py]"]
  node_registration["Image registration<br/>[register.py]"]
  node_tract_generation["Tract generation<br/>[generate_tracts.py]"]
  node_tract_review["Tract review<br/>[tract_check.py]"]
  node_dti_dicom["Final DICOM<br/>[final_dcm.py]"]
  node_tract_roi["Tract ROI table<br/>[tract_roi_match.py]"]
end

node_user(("Imaging user"))
node_pacs[("PACS")]

node_user -->|"selects task"| node_relax_app
node_relax_app -->|"prompts"| node_relax_prompt
node_relax_app -->|"generates maps"| node_relax_maps
node_relax_app -->|"detects ROIs"| node_roi_detect
node_relax_app -->|"selects ROIs"| node_roi_manual
node_relax_app -->|"calculates statistics"| node_roi_stats
node_user -.->|"provides DICOMs"| node_tarquin_app
node_tarquin_app -->|"starts watcher"| node_dicom_watch
node_dicom_watch -->|"validates series"| node_spectro_check
node_dicom_watch -->|"classifies series"| node_series_classify
node_dicom_watch -->|"finds partner"| node_pair_match
node_tarquin_app -->|"escapes paths"| node_path_escape
node_tarquin_app -->|"runs analysis"| node_tarquin_runner
node_tarquin_runner -->|"builds command"| node_tarquin_command
node_tarquin_app -->|"renders PDF"| node_pdf_render
node_tarquin_app -->|"builds DICOM"| node_secondary_capture
node_tarquin_app -->|"sends result"| node_pacs_push
node_pacs_push -->|"C-STORE"| node_pacs
node_user -->|"runs workflow"| node_dti_app
node_dti_app -->|"uses utilities"| node_dti_utils
node_dti_app -->|"registers images"| node_registration
node_dti_app -->|"generates tracts"| node_tract_generation
node_dti_app -->|"checks tracts"| node_tract_review
node_dti_app -->|"creates DICOM"| node_dti_dicom
node_dti_app -->|"shows ROI table"| node_tract_roi
node_tract_generation -->|"uses runner"| node_dti_utils

click node_relax_app "https://github.com/danieljohnwest/gstt-nir-computing/blob/main/projects/Relaxometry_QA/main.py"
click node_relax_maps "https://github.com/danieljohnwest/gstt-nir-computing/blob/main/functions/relaxometry/generate_T1_map.py"
click node_roi_detect "https://github.com/danieljohnwest/gstt-nir-computing/blob/main/functions/relaxometry/find_rois.py"
click node_roi_manual "https://github.com/danieljohnwest/gstt-nir-computing/blob/main/functions/relaxometry/manual_roi_selection.py"
click node_roi_stats "https://github.com/danieljohnwest/gstt-nir-computing/blob/main/functions/relaxometry/calculate_roi_statistics.py"
click node_relax_prompt "https://github.com/danieljohnwest/gstt-nir-computing/blob/main/functions/relaxometry/prompt_input.py"
click node_tarquin_app "https://github.com/danieljohnwest/gstt-nir-computing/blob/main/projects/Tarquin_Analysis/proc.py"
click node_dicom_watch "https://github.com/danieljohnwest/gstt-nir-computing/blob/main/projects/Tarquin_Analysis/proc.py"
click node_series_classify "https://github.com/danieljohnwest/gstt-nir-computing/blob/main/functions/spectroscopy/classify_spectroscopy_series.py"
click node_pair_match "https://github.com/danieljohnwest/gstt-nir-computing/blob/main/functions/spectroscopy/find_matching_pair.py"
click node_spectro_check "https://github.com/danieljohnwest/gstt-nir-computing/blob/main/functions/spectroscopy/is_evelina_spectroscopy.py"
click node_tarquin_runner "https://github.com/danieljohnwest/gstt-nir-computing/blob/main/functions/tarquin/run_tarquin.py"
click node_tarquin_command "https://github.com/danieljohnwest/gstt-nir-computing/blob/main/functions/tarquin/build_tarquin_command.py"
click node_path_escape "https://github.com/danieljohnwest/gstt-nir-computing/blob/main/functions/tarquin/escape_filepath.py"
click node_pdf_render "https://github.com/danieljohnwest/gstt-nir-computing/blob/main/functions/pdf_manipulations/pdf_to_png.py"
click node_secondary_capture "https://github.com/danieljohnwest/gstt-nir-computing/blob/main/functions/spectroscopy/build_secondary_capture_dataset.py"
click node_pacs_push "https://github.com/danieljohnwest/gstt-nir-computing/blob/main/functions/pacs/push_dicom_to_pacs.py"
click node_dti_app "https://github.com/danieljohnwest/gstt-nir-computing/blob/main/projects/Brainlab-DTI-Analysis/main.py"
click node_dti_utils "https://github.com/danieljohnwest/gstt-nir-computing/blob/main/projects/Brainlab-DTI-Analysis/dti_utils.py"
click node_registration "https://github.com/danieljohnwest/gstt-nir-computing/blob/main/projects/Brainlab-DTI-Analysis/register.py"
click node_tract_generation "https://github.com/danieljohnwest/gstt-nir-computing/blob/main/projects/Brainlab-DTI-Analysis/generate_tracts.py"
click node_tract_review "https://github.com/danieljohnwest/gstt-nir-computing/blob/main/projects/Brainlab-DTI-Analysis/tract_check.py"
click node_dti_dicom "https://github.com/danieljohnwest/gstt-nir-computing/blob/main/projects/Brainlab-DTI-Analysis/final_dcm.py"
click node_tract_roi "https://github.com/danieljohnwest/gstt-nir-computing/blob/main/projects/Brainlab-DTI-Analysis/tract_roi_match.py"
click node_anonymise "https://github.com/danieljohnwest/gstt-nir-computing/blob/main/functions/dicoms/anonymise_dicom.py"
click node_file_list "https://github.com/danieljohnwest/gstt-nir-computing/blob/main/functions/filepaths/get_files_as_list.py"
click node_rf_logs "https://github.com/danieljohnwest/gstt-nir-computing/blob/main/functions/rf_logs/extract_protocol_times.py"
click node_spectro_dataset "https://github.com/danieljohnwest/gstt-nir-computing/blob/main/functions/spectroscopy/build_secondary_capture_dataset.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_relax_app,node_tarquin_app,node_user toneBlue
class node_relax_maps,node_roi_detect,node_roi_manual,node_roi_stats,node_relax_prompt,node_pacs toneAmber
class node_dicom_watch,node_series_classify,node_pair_match,node_spectro_check,node_tarquin_runner,node_tarquin_command,node_path_escape,node_secondary_capture,node_spectro_dataset toneMint
class node_pdf_render,node_pacs_push,node_anonymise,node_file_list,node_rf_logs toneRose
class node_dti_app,node_dti_utils,node_registration,node_tract_generation,node_tract_review,node_dti_dicom,node_tract_roi toneIndigo
```

## Components

### Imaging workflows

- [Relaxometry QA](https://github.com/danieljohnwest/gstt-nir-computing/blob/main/projects/Relaxometry_QA/main.py): `projects/Relaxometry_QA/main.py`
- [Tarquin Analysis](https://github.com/danieljohnwest/gstt-nir-computing/blob/main/projects/Tarquin_Analysis/proc.py): `projects/Tarquin_Analysis/proc.py`

### Relaxometry

- [T1 / T2 maps](https://github.com/danieljohnwest/gstt-nir-computing/blob/main/functions/relaxometry/generate_T1_map.py): `functions/relaxometry/generate_T1_map.py`
- [ROI detection](https://github.com/danieljohnwest/gstt-nir-computing/blob/main/functions/relaxometry/find_rois.py): `functions/relaxometry/find_rois.py`
- [Manual ROI selection](https://github.com/danieljohnwest/gstt-nir-computing/blob/main/functions/relaxometry/manual_roi_selection.py): `functions/relaxometry/manual_roi_selection.py`
- [ROI statistics](https://github.com/danieljohnwest/gstt-nir-computing/blob/main/functions/relaxometry/calculate_roi_statistics.py): `functions/relaxometry/calculate_roi_statistics.py`
- [Input prompts](https://github.com/danieljohnwest/gstt-nir-computing/blob/main/functions/relaxometry/prompt_input.py): `functions/relaxometry/prompt_input.py`

### Spectroscopy pipeline

- [DICOM watcher](https://github.com/danieljohnwest/gstt-nir-computing/blob/main/projects/Tarquin_Analysis/proc.py): `projects/Tarquin_Analysis/proc.py`
- [Series classification](https://github.com/danieljohnwest/gstt-nir-computing/blob/main/functions/spectroscopy/classify_spectroscopy_series.py): `functions/spectroscopy/classify_spectroscopy_series.py`
- [Pair matching](https://github.com/danieljohnwest/gstt-nir-computing/blob/main/functions/spectroscopy/find_matching_pair.py): `functions/spectroscopy/find_matching_pair.py`
- [Spectroscopy validation](https://github.com/danieljohnwest/gstt-nir-computing/blob/main/functions/spectroscopy/is_evelina_spectroscopy.py): `functions/spectroscopy/is_evelina_spectroscopy.py`
- [Tarquin runner](https://github.com/danieljohnwest/gstt-nir-computing/blob/main/functions/tarquin/run_tarquin.py): `functions/tarquin/run_tarquin.py`
- [Command builder](https://github.com/danieljohnwest/gstt-nir-computing/blob/main/functions/tarquin/build_tarquin_command.py): `functions/tarquin/build_tarquin_command.py`
- [Path escaping](https://github.com/danieljohnwest/gstt-nir-computing/blob/main/functions/tarquin/escape_filepath.py): `functions/tarquin/escape_filepath.py`
- [Secondary Capture](https://github.com/danieljohnwest/gstt-nir-computing/blob/main/functions/spectroscopy/build_secondary_capture_dataset.py): `functions/spectroscopy/build_secondary_capture_dataset.py`
- [Spectroscopy dataset](https://github.com/danieljohnwest/gstt-nir-computing/blob/main/functions/spectroscopy/build_secondary_capture_dataset.py): `functions/spectroscopy/build_secondary_capture_dataset.py`

### Shared imaging tools

- [PDF rendering](https://github.com/danieljohnwest/gstt-nir-computing/blob/main/functions/pdf_manipulations/pdf_to_png.py): `functions/pdf_manipulations/pdf_to_png.py`
- [PACS transfer](https://github.com/danieljohnwest/gstt-nir-computing/blob/main/functions/pacs/push_dicom_to_pacs.py): `functions/pacs/push_dicom_to_pacs.py`
- [DICOM anonymisation](https://github.com/danieljohnwest/gstt-nir-computing/blob/main/functions/dicoms/anonymise_dicom.py): `functions/dicoms/anonymise_dicom.py`
- [File listing](https://github.com/danieljohnwest/gstt-nir-computing/blob/main/functions/filepaths/get_files_as_list.py): `functions/filepaths/get_files_as_list.py`
- [RF log parsing](https://github.com/danieljohnwest/gstt-nir-computing/blob/main/functions/rf_logs/extract_protocol_times.py): `functions/rf_logs/extract_protocol_times.py`

### DTI analysis

- [DTI workflow](https://github.com/danieljohnwest/gstt-nir-computing/blob/main/projects/Brainlab-DTI-Analysis/main.py): `projects/Brainlab-DTI-Analysis/main.py`
- [DTI utilities](https://github.com/danieljohnwest/gstt-nir-computing/blob/main/projects/Brainlab-DTI-Analysis/dti_utils.py): `projects/Brainlab-DTI-Analysis/dti_utils.py`
- [Image registration](https://github.com/danieljohnwest/gstt-nir-computing/blob/main/projects/Brainlab-DTI-Analysis/register.py): `projects/Brainlab-DTI-Analysis/register.py`
- [Tract generation](https://github.com/danieljohnwest/gstt-nir-computing/blob/main/projects/Brainlab-DTI-Analysis/generate_tracts.py): `projects/Brainlab-DTI-Analysis/generate_tracts.py`
- [Tract review](https://github.com/danieljohnwest/gstt-nir-computing/blob/main/projects/Brainlab-DTI-Analysis/tract_check.py): `projects/Brainlab-DTI-Analysis/tract_check.py`
- [Final DICOM](https://github.com/danieljohnwest/gstt-nir-computing/blob/main/projects/Brainlab-DTI-Analysis/final_dcm.py): `projects/Brainlab-DTI-Analysis/final_dcm.py`
- [Tract ROI table](https://github.com/danieljohnwest/gstt-nir-computing/blob/main/projects/Brainlab-DTI-Analysis/tract_roi_match.py): `projects/Brainlab-DTI-Analysis/tract_roi_match.py`

### Other components

- **Imaging user**
- **PACS**

## Connections

- Imaging user → Relaxometry QA: selects task (evidence: `projects/Relaxometry_QA/main.py`)
- Relaxometry QA → Input prompts: prompts (evidence: `projects/Relaxometry_QA/main.py`)
- Relaxometry QA → T1 / T2 maps: generates maps (evidence: `projects/Relaxometry_QA/main.py`)
- Relaxometry QA → ROI detection: detects ROIs (evidence: `projects/Relaxometry_QA/main.py`)
- Relaxometry QA → Manual ROI selection: selects ROIs (evidence: `projects/Relaxometry_QA/main.py`)
- Relaxometry QA → ROI statistics: calculates statistics (evidence: `projects/Relaxometry_QA/main.py`)
- Imaging user → Tarquin Analysis: provides DICOMs
- Tarquin Analysis → DICOM watcher: starts watcher (evidence: `projects/Tarquin_Analysis/proc.py`)
- DICOM watcher → Spectroscopy validation: validates series (evidence: `projects/Tarquin_Analysis/proc.py`)
- DICOM watcher → Series classification: classifies series (evidence: `projects/Tarquin_Analysis/proc.py`)
- DICOM watcher → Pair matching: finds partner (evidence: `projects/Tarquin_Analysis/proc.py`)
- Tarquin Analysis → Path escaping: escapes paths (evidence: `projects/Tarquin_Analysis/proc.py`)
- Tarquin Analysis → Tarquin runner: runs analysis (evidence: `projects/Tarquin_Analysis/proc.py`)
- Tarquin runner → Command builder: builds command (evidence: `functions/tarquin/run_tarquin.py`)
- Tarquin Analysis → PDF rendering: renders PDF (evidence: `projects/Tarquin_Analysis/proc.py`)
- Tarquin Analysis → Secondary Capture: builds DICOM (evidence: `projects/Tarquin_Analysis/proc.py`)
- Tarquin Analysis → PACS transfer: sends result (evidence: `projects/Tarquin_Analysis/proc.py`)
- PACS transfer → PACS: C-STORE (evidence: `functions/pacs/push_dicom_to_pacs.py`)
- Imaging user → DTI workflow: runs workflow (evidence: `projects/Brainlab-DTI-Analysis/main.py`)
- DTI workflow → DTI utilities: uses utilities (evidence: `projects/Brainlab-DTI-Analysis/main.py`)
- DTI workflow → Image registration: registers images (evidence: `projects/Brainlab-DTI-Analysis/main.py`)
- DTI workflow → Tract generation: generates tracts (evidence: `projects/Brainlab-DTI-Analysis/main.py`)
- DTI workflow → Tract review: checks tracts (evidence: `projects/Brainlab-DTI-Analysis/main.py`)
- DTI workflow → Final DICOM: creates DICOM (evidence: `projects/Brainlab-DTI-Analysis/main.py`)
- DTI workflow → Tract ROI table: shows ROI table (evidence: `projects/Brainlab-DTI-Analysis/main.py`)
- Tract generation → DTI utilities: uses runner (evidence: `projects/Brainlab-DTI-Analysis/generate_tracts.py`)
