# kadir1ak/capnoanalyzer architecture

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

- Interactive diagram: https://gitdiagram.com/kadir1ak/capnoanalyzer
- Repository: https://github.com/kadir1ak/capnoanalyzer

## Overview

CapnoAnalyzer is a WPF application for connecting to capnography devices, managing patient records, and calibrating sensor measurements. The principal workflow is to discover and connect a serial device, parse its incoming data into device/plot state, then use calibration views and models to analyze gas and temperature behavior. Patient registration is a separate but integrated workflow that can associate a patient with a device and persist patient records. The graph follows the sampled source and SOURCE INDEX; some UI bindings and unsampled subsystem details are not shown, so their relationships are omitted.

Main entry points: [`ViewModels/PatientViewModels/PatientRegistrationViewModel.cs`](https://github.com/kadir1ak/capnoanalyzer/blob/main/ViewModels/PatientViewModels/PatientRegistrationViewModel.cs) (Patient Registration), [`ViewModels/MainViewModels/MainViewModel.cs`](https://github.com/kadir1ak/capnoanalyzer/blob/main/ViewModels/MainViewModels/MainViewModel.cs) (Application Navigation), [`ViewModels/DeviceViewModels/DevicesViewModel.cs`](https://github.com/kadir1ak/capnoanalyzer/blob/main/ViewModels/DeviceViewModels/DevicesViewModel.cs) (Device Management), [`Models/Device/Device.cs`](https://github.com/kadir1ak/capnoanalyzer/blob/main/Models/Device/Device.cs) (Device)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["Application Shell"]
  node_main["Application Navigation<br/>[MainViewModel.cs]"]
  node_mainwindow["Main Window<br/>[MainWindow.xaml.cs]"]
  node_settings["Settings"]
end

subgraph group_device["Device I/O"]
  node_devicesvm["Device Management"]
  node_serial["Serial Port Manager"]
  node_parser["Device Data Parser"]
  node_device["Device<br/>[Device.cs]"]
  node_communicator["Device Communicator"]
  node_commandbuilder["Patient Command Builder"]
end

subgraph group_calibration["Calibration"]
  node_calibrationvm["Calibration Workflow"]
  node_gastables["Gas Concentration Analysis"]
  node_thermal["Thermal Compensation"]
  node_temperature["Temperature Tests"]
end

subgraph group_patients["Patient Management"]
  node_registration["Patient Registration"]
  node_patientservice["Patient Persistence<br/>[PatientService.cs]"]
  node_patientstore[("Patient File Store<br/>[PatientService.cs]")]
end

subgraph group_models["Domain Models"]
  node_interface["Device Interface State<br/>[DeviceInterface.cs]"]
  node_plots["Sensor Plot Models"]
  node_calculatedplot["Calculated Gas Plot"]
  node_realtimeplot["Realtime Plot"]
  node_patient["Patient Record<br/>[Patient.cs]"]
  node_settingmodel["Application Settings<br/>[Setting.cs]"]
end

node_operator(("Operator"))

node_operator -->|"uses"| node_mainwindow
node_mainwindow -.->|"hosts"| node_main
node_main -->|"creates"| node_devicesvm
node_main -->|"creates"| node_settings
node_main -->|"creates"| node_calibrationvm
node_main -->|"creates"| node_registration
node_settings -->|"uses"| node_settingmodel
node_devicesvm -->|"manages ports"| node_serial
node_devicesvm -->|"parses messages"| node_parser
node_parser -->|"updates device"| node_device
node_device -->|"sends messages"| node_serial
node_device -->|"builds command"| node_commandbuilder
node_device -->|"updates state"| node_interface
node_interface -->|"maintains plots"| node_plots
node_plots -->|"uses model"| node_calculatedplot
node_interface -->|"uses plot"| node_realtimeplot
node_calibrationvm -->|"uses devices"| node_devicesvm
node_calibrationvm -->|"coordinates"| node_gastables
node_gastables -->|"calculates compensation"| node_thermal
node_gastables -->|"uses tests"| node_temperature
node_registration -->|"selects device"| node_devicesvm
node_registration -->|"loads and saves"| node_patientservice
node_registration -->|"communicates"| node_communicator
node_registration -->|"builds device command"| node_commandbuilder
node_patientservice -->|"reads and writes"| node_patientstore
node_patientservice -->|"serializes records"| node_patient
node_registration -->|"edits records"| node_patient

click node_main "https://github.com/kadir1ak/capnoanalyzer/blob/main/ViewModels/MainViewModels/MainViewModel.cs"
click node_mainwindow "https://github.com/kadir1ak/capnoanalyzer/blob/main/Views/MainViews/MainWindow.xaml.cs"
click node_settings "https://github.com/kadir1ak/capnoanalyzer/blob/main/ViewModels/SettingViewModels/SettingViewModel.cs"
click node_devicesvm "https://github.com/kadir1ak/capnoanalyzer/blob/main/ViewModels/DeviceViewModels/DevicesViewModel.cs"
click node_serial "https://github.com/kadir1ak/capnoanalyzer/blob/main/Services/SerialPortsManager.cs"
click node_parser "https://github.com/kadir1ak/capnoanalyzer/blob/main/Services/DeviceDataParser.cs"
click node_device "https://github.com/kadir1ak/capnoanalyzer/blob/main/Models/Device/Device.cs"
click node_communicator "https://github.com/kadir1ak/capnoanalyzer/blob/main/Services/DeviceCommunicator.cs"
click node_commandbuilder "https://github.com/kadir1ak/capnoanalyzer/blob/main/Services/PatientDeviceCommandBuilder.cs"
click node_interface "https://github.com/kadir1ak/capnoanalyzer/blob/main/Models/Device/DeviceInterface.cs"
click node_plots "https://github.com/kadir1ak/capnoanalyzer/blob/main/Models/PlotModels/SensorChartModel.cs"
click node_calculatedplot "https://github.com/kadir1ak/capnoanalyzer/blob/main/Models/PlotModels/CalculatedGasChartModel.cs"
click node_realtimeplot "https://github.com/kadir1ak/capnoanalyzer/blob/main/Models/PlotModels/DualChannelRealTimePlot.cs"
click node_calibrationvm "https://github.com/kadir1ak/capnoanalyzer/blob/main/ViewModels/CalibrationViewModels/CalibrationViewModel.cs"
click node_gastables "https://github.com/kadir1ak/capnoanalyzer/blob/main/ViewModels/CalibrationViewModels/GasConcentrationTablesViewModel.cs"
click node_thermal "https://github.com/kadir1ak/capnoanalyzer/blob/main/Services/ThermalCompensationEngine.cs"
click node_temperature "https://github.com/kadir1ak/capnoanalyzer/blob/main/ViewModels/CalibrationViewModels/TemperatureTestViewModel.cs"
click node_registration "https://github.com/kadir1ak/capnoanalyzer/blob/main/ViewModels/PatientViewModels/PatientRegistrationViewModel.cs"
click node_patientservice "https://github.com/kadir1ak/capnoanalyzer/blob/main/Services/PatientService.cs"
click node_patientstore "https://github.com/kadir1ak/capnoanalyzer/blob/main/Services/PatientService.cs"
click node_patient "https://github.com/kadir1ak/capnoanalyzer/blob/main/Models/Patient/Patient.cs"
click node_settingmodel "https://github.com/kadir1ak/capnoanalyzer/blob/main/Models/Settings/Setting.cs"

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_main,node_mainwindow,node_settings toneBlue
class node_devicesvm,node_serial,node_parser,node_device,node_communicator,node_commandbuilder toneAmber
class node_calibrationvm,node_gastables,node_thermal,node_temperature toneMint
class node_registration,node_patientservice,node_patientstore toneRose
class node_interface,node_plots,node_calculatedplot,node_realtimeplot,node_patient,node_settingmodel,node_operator toneIndigo
```

## Components

### Application Shell

- [Application Navigation](https://github.com/kadir1ak/capnoanalyzer/blob/main/ViewModels/MainViewModels/MainViewModel.cs): `ViewModels/MainViewModels/MainViewModel.cs`
- [Main Window](https://github.com/kadir1ak/capnoanalyzer/blob/main/Views/MainViews/MainWindow.xaml.cs): `Views/MainViews/MainWindow.xaml.cs`
- [Settings](https://github.com/kadir1ak/capnoanalyzer/blob/main/ViewModels/SettingViewModels/SettingViewModel.cs): `ViewModels/SettingViewModels/SettingViewModel.cs`

### Device I/O

- [Device Management](https://github.com/kadir1ak/capnoanalyzer/blob/main/ViewModels/DeviceViewModels/DevicesViewModel.cs): `ViewModels/DeviceViewModels/DevicesViewModel.cs`
- [Serial Port Manager](https://github.com/kadir1ak/capnoanalyzer/blob/main/Services/SerialPortsManager.cs): `Services/SerialPortsManager.cs`
- [Device Data Parser](https://github.com/kadir1ak/capnoanalyzer/blob/main/Services/DeviceDataParser.cs): `Services/DeviceDataParser.cs`
- [Device](https://github.com/kadir1ak/capnoanalyzer/blob/main/Models/Device/Device.cs): `Models/Device/Device.cs`
- [Device Communicator](https://github.com/kadir1ak/capnoanalyzer/blob/main/Services/DeviceCommunicator.cs): `Services/DeviceCommunicator.cs`
- [Patient Command Builder](https://github.com/kadir1ak/capnoanalyzer/blob/main/Services/PatientDeviceCommandBuilder.cs): `Services/PatientDeviceCommandBuilder.cs`

### Calibration

- [Calibration Workflow](https://github.com/kadir1ak/capnoanalyzer/blob/main/ViewModels/CalibrationViewModels/CalibrationViewModel.cs): `ViewModels/CalibrationViewModels/CalibrationViewModel.cs`
- [Gas Concentration Analysis](https://github.com/kadir1ak/capnoanalyzer/blob/main/ViewModels/CalibrationViewModels/GasConcentrationTablesViewModel.cs): `ViewModels/CalibrationViewModels/GasConcentrationTablesViewModel.cs`
- [Thermal Compensation](https://github.com/kadir1ak/capnoanalyzer/blob/main/Services/ThermalCompensationEngine.cs): `Services/ThermalCompensationEngine.cs`
- [Temperature Tests](https://github.com/kadir1ak/capnoanalyzer/blob/main/ViewModels/CalibrationViewModels/TemperatureTestViewModel.cs): `ViewModels/CalibrationViewModels/TemperatureTestViewModel.cs`

### Patient Management

- [Patient Registration](https://github.com/kadir1ak/capnoanalyzer/blob/main/ViewModels/PatientViewModels/PatientRegistrationViewModel.cs): `ViewModels/PatientViewModels/PatientRegistrationViewModel.cs`
- [Patient Persistence](https://github.com/kadir1ak/capnoanalyzer/blob/main/Services/PatientService.cs): `Services/PatientService.cs`
- [Patient File Store](https://github.com/kadir1ak/capnoanalyzer/blob/main/Services/PatientService.cs): `Services/PatientService.cs`

### Domain Models

- [Device Interface State](https://github.com/kadir1ak/capnoanalyzer/blob/main/Models/Device/DeviceInterface.cs): `Models/Device/DeviceInterface.cs`
- [Sensor Plot Models](https://github.com/kadir1ak/capnoanalyzer/blob/main/Models/PlotModels/SensorChartModel.cs): `Models/PlotModels/SensorChartModel.cs`
- [Calculated Gas Plot](https://github.com/kadir1ak/capnoanalyzer/blob/main/Models/PlotModels/CalculatedGasChartModel.cs): `Models/PlotModels/CalculatedGasChartModel.cs`
- [Realtime Plot](https://github.com/kadir1ak/capnoanalyzer/blob/main/Models/PlotModels/DualChannelRealTimePlot.cs): `Models/PlotModels/DualChannelRealTimePlot.cs`
- [Patient Record](https://github.com/kadir1ak/capnoanalyzer/blob/main/Models/Patient/Patient.cs): `Models/Patient/Patient.cs`
- [Application Settings](https://github.com/kadir1ak/capnoanalyzer/blob/main/Models/Settings/Setting.cs): `Models/Settings/Setting.cs`

### Other components

- **Operator**

## Connections

- Operator → Main Window: uses
- Main Window → Application Navigation: hosts
- Application Navigation → Device Management: creates (evidence: `ViewModels/MainViewModels/MainViewModel.cs`)
- Application Navigation → Settings: creates (evidence: `ViewModels/MainViewModels/MainViewModel.cs`)
- Application Navigation → Calibration Workflow: creates (evidence: `ViewModels/MainViewModels/MainViewModel.cs`)
- Application Navigation → Patient Registration: creates (evidence: `ViewModels/MainViewModels/MainViewModel.cs`)
- Settings → Application Settings: uses (evidence: `ViewModels/SettingViewModels/SettingViewModel.cs`)
- Device Management → Serial Port Manager: manages ports (evidence: `ViewModels/DeviceViewModels/DevicesViewModel.cs`)
- Device Management → Device Data Parser: parses messages (evidence: `ViewModels/DeviceViewModels/DevicesViewModel.cs`)
- Device Data Parser → Device: updates device (evidence: `Services/DeviceDataParser.cs`)
- Device → Serial Port Manager: sends messages (evidence: `Models/Device/Device.cs`)
- Device → Patient Command Builder: builds command (evidence: `Models/Device/Device.cs`)
- Device → Device Interface State: updates state (evidence: `Models/Device/Device.cs`)
- Device Interface State → Sensor Plot Models: maintains plots (evidence: `Models/Device/DeviceInterface.cs`)
- Sensor Plot Models → Calculated Gas Plot: uses model (evidence: `Models/PlotModels/SensorChartModel.cs`)
- Device Interface State → Realtime Plot: uses plot (evidence: `Models/Device/DeviceInterface.cs`)
- Calibration Workflow → Device Management: uses devices (evidence: `ViewModels/CalibrationViewModels/CalibrationViewModel.cs`)
- Calibration Workflow → Gas Concentration Analysis: coordinates (evidence: `ViewModels/CalibrationViewModels/CalibrationViewModel.cs`)
- Gas Concentration Analysis → Thermal Compensation: calculates compensation (evidence: `ViewModels/CalibrationViewModels/GasConcentrationTablesViewModel.cs`)
- Gas Concentration Analysis → Temperature Tests: uses tests (evidence: `ViewModels/CalibrationViewModels/GasConcentrationTablesViewModel.cs`)
- Patient Registration → Device Management: selects device (evidence: `ViewModels/PatientViewModels/PatientRegistrationViewModel.cs`)
- Patient Registration → Patient Persistence: loads and saves (evidence: `ViewModels/PatientViewModels/PatientRegistrationViewModel.cs`)
- Patient Registration → Device Communicator: communicates (evidence: `ViewModels/PatientViewModels/PatientRegistrationViewModel.cs`)
- Patient Registration → Patient Command Builder: builds device command (evidence: `ViewModels/PatientViewModels/PatientRegistrationViewModel.cs`)
- Patient Persistence → Patient File Store: reads and writes (evidence: `Services/PatientService.cs`)
- Patient Persistence → Patient Record: serializes records (evidence: `Services/PatientService.cs`)
- Patient Registration → Patient Record: edits records (evidence: `ViewModels/PatientViewModels/PatientRegistrationViewModel.cs`)
