# thenurii/opencl_wstep_pod_praktyki architecture

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

- Interactive diagram: https://gitdiagram.com/thenurii/opencl_wstep_pod_praktyki
- Repository: https://github.com/thenurii/opencl_wstep_pod_praktyki

## Overview

This is a C++ image/video-processing library with a host program that compares reference and test YUV sequences using CPU and OpenCL quality metrics. Its main workflow discovers an OpenCL device, reads frames, processes them, and reports statistics. The tree also contains standalone sepia-processing implementations. Relationships below follow the sampled host code, excerpts, and SOURCE INDEX references; some frame-processing calls and unsampled subsystem wiring are not shown, so uncertain links are omitted.

Main entry points: [`GPULibQMIV/PP.cpp`](https://github.com/thenurii/opencl_wstep_pod_praktyki/blob/main/GPULibQMIV/PP.cpp) (Comparison app), [`GPULibQMIV/Metrics/PSNR/xPSNR_OpenCL.cpp`](https://github.com/thenurii/opencl_wstep_pod_praktyki/blob/main/GPULibQMIV/Metrics/PSNR/xPSNR_OpenCL.cpp) (OpenCL PSNR), [`GPULibQMIV/Metrics/PSNR/xPSNR.cpp`](https://github.com/thenurii/opencl_wstep_pod_praktyki/blob/main/GPULibQMIV/Metrics/PSNR/xPSNR.cpp) (CPU PSNR), [`GPULibQMIV/xPic.cpp`](https://github.com/thenurii/opencl_wstep_pod_praktyki/blob/main/GPULibQMIV/xPic.cpp) (Picture buffers)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_host["Host workflow"]
  node_host_program["Comparison app<br/>[PP.cpp]"]
  node_device_discovery["OpenCL discovery"]
  node_statistics["Result statistics<br/>[xPrintStats.cpp]"]
end

subgraph group_media["Media handling"]
  node_reference_sequence["Reference sequence<br/>[xSeq.cpp]"]
  node_test_sequence["Test sequence<br/>[xSeq.cpp]"]
  node_file_io["Binary file I/O<br/>[xFile.h]"]
  node_picture_data["Picture buffers<br/>[xPic.cpp]"]
end

subgraph group_metrics["Quality metrics"]
  node_iv_preprocessing["IV preprocessing"]
  node_cpu_psnr["CPU PSNR<br/>[xPSNR.cpp]"]
  node_gpu_psnr["OpenCL PSNR<br/>[xPSNR_OpenCL.cpp]"]
  node_cpu_ssim["CPU SSIM<br/>[xSSIM.cpp]"]
  node_gpu_ssim["OpenCL SSIM<br/>[xSSIM_OpenCL.cpp]"]
end

subgraph group_support["Processing and support"]
  node_pixel_ops["Pixel operations<br/>[xPixelOpsSTD.cpp]"]
  node_vector_types["Pixel vector types<br/>[xVec4.h]"]
  node_sepia_cpu["CPU sepia<br/>[xSepia.cpp]"]
  node_sepia_opencl["OpenCL sepia<br/>[xSepia_OpenCL.cpp]"]
  node_formatting["Formatting library"]
  node_common_defs["Common definitions<br/>[CommonDef.h]"]
end

node_engineer(("User"))

node_engineer -.->|"runs"| node_host_program
node_host_program -->|"queries device"| node_device_discovery
node_host_program -->|"opens input"| node_reference_sequence
node_host_program -->|"opens input"| node_test_sequence
node_reference_sequence -->|"uses file I/O"| node_file_io
node_test_sequence -->|"uses file I/O"| node_file_io
node_host_program -->|"creates frames"| node_picture_data
node_host_program -->|"configures metric"| node_iv_preprocessing
node_host_program -->|"configures metric"| node_cpu_psnr
node_host_program -->|"configures metric"| node_gpu_psnr
node_host_program -->|"selects metric"| node_cpu_ssim
node_host_program -->|"selects metric"| node_gpu_ssim
node_host_program -->|"prints results"| node_statistics
node_gpu_psnr -->|"extends"| node_cpu_psnr
node_gpu_ssim -->|"uses metric API"| node_cpu_ssim
node_cpu_psnr -->|"uses operations"| node_pixel_ops
node_cpu_ssim -->|"uses operations"| node_pixel_ops
node_iv_preprocessing -->|"uses vectors"| node_vector_types
node_gpu_psnr -->|"reads frames"| node_picture_data
node_gpu_psnr -->|"loads kernels"| node_file_io
node_host_program -->|"formats output"| node_formatting
node_cpu_psnr -->|"formats output"| node_formatting
node_statistics -->|"formats tables"| node_formatting
node_sepia_cpu -.->|"transforms images"| node_picture_data
node_sepia_opencl -.->|"transforms images"| node_picture_data

click node_host_program "https://github.com/thenurii/opencl_wstep_pod_praktyki/blob/main/GPULibQMIV/PP.cpp"
click node_device_discovery "https://github.com/thenurii/opencl_wstep_pod_praktyki/blob/main/GPULibQMIV/xOpenCL_Enumerator.cpp"
click node_reference_sequence "https://github.com/thenurii/opencl_wstep_pod_praktyki/blob/main/GPULibQMIV/xSeq.cpp"
click node_test_sequence "https://github.com/thenurii/opencl_wstep_pod_praktyki/blob/main/GPULibQMIV/xSeq.cpp"
click node_file_io "https://github.com/thenurii/opencl_wstep_pod_praktyki/blob/main/GPULibQMIV/xFile.h"
click node_picture_data "https://github.com/thenurii/opencl_wstep_pod_praktyki/blob/main/GPULibQMIV/xPic.cpp"
click node_pixel_ops "https://github.com/thenurii/opencl_wstep_pod_praktyki/blob/main/GPULibQMIV/xPixelOpsSTD.cpp"
click node_vector_types "https://github.com/thenurii/opencl_wstep_pod_praktyki/blob/main/GPULibQMIV/xVec4.h"
click node_iv_preprocessing "https://github.com/thenurii/opencl_wstep_pod_praktyki/blob/main/GPULibQMIV/Metrics/IVPreProcessing/xIVPreProcessing.cpp"
click node_cpu_psnr "https://github.com/thenurii/opencl_wstep_pod_praktyki/blob/main/GPULibQMIV/Metrics/PSNR/xPSNR.cpp"
click node_gpu_psnr "https://github.com/thenurii/opencl_wstep_pod_praktyki/blob/main/GPULibQMIV/Metrics/PSNR/xPSNR_OpenCL.cpp"
click node_cpu_ssim "https://github.com/thenurii/opencl_wstep_pod_praktyki/blob/main/GPULibQMIV/Metrics/SSIM/xSSIM.cpp"
click node_gpu_ssim "https://github.com/thenurii/opencl_wstep_pod_praktyki/blob/main/GPULibQMIV/Metrics/SSIM/xSSIM_OpenCL.cpp"
click node_sepia_cpu "https://github.com/thenurii/opencl_wstep_pod_praktyki/blob/main/GPULibQMIV/Metrics/SepiaFiles/xSepia.cpp"
click node_sepia_opencl "https://github.com/thenurii/opencl_wstep_pod_praktyki/blob/main/GPULibQMIV/Metrics/SepiaFiles/xSepia_OpenCL.cpp"
click node_statistics "https://github.com/thenurii/opencl_wstep_pod_praktyki/blob/main/GPULibQMIV/xPrintStats.cpp"
click node_formatting "https://github.com/thenurii/opencl_wstep_pod_praktyki/tree/main/GPULibQMIV/lib_fmt"
click node_common_defs "https://github.com/thenurii/opencl_wstep_pod_praktyki/blob/main/GPULibQMIV/CommonDef.h"

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_host_program,node_device_discovery,node_statistics,node_engineer toneBlue
class node_reference_sequence,node_test_sequence,node_file_io,node_picture_data toneAmber
class node_iv_preprocessing,node_cpu_psnr,node_gpu_psnr,node_cpu_ssim,node_gpu_ssim toneMint
class node_pixel_ops,node_vector_types,node_sepia_cpu,node_sepia_opencl,node_formatting,node_common_defs toneRose
```

## Components

### Host workflow

- [Comparison app](https://github.com/thenurii/opencl_wstep_pod_praktyki/blob/main/GPULibQMIV/PP.cpp): `GPULibQMIV/PP.cpp`
- [OpenCL discovery](https://github.com/thenurii/opencl_wstep_pod_praktyki/blob/main/GPULibQMIV/xOpenCL_Enumerator.cpp): `GPULibQMIV/xOpenCL_Enumerator.cpp`
- [Result statistics](https://github.com/thenurii/opencl_wstep_pod_praktyki/blob/main/GPULibQMIV/xPrintStats.cpp): `GPULibQMIV/xPrintStats.cpp`

### Media handling

- [Reference sequence](https://github.com/thenurii/opencl_wstep_pod_praktyki/blob/main/GPULibQMIV/xSeq.cpp): `GPULibQMIV/xSeq.cpp`
- [Test sequence](https://github.com/thenurii/opencl_wstep_pod_praktyki/blob/main/GPULibQMIV/xSeq.cpp): `GPULibQMIV/xSeq.cpp`
- [Binary file I/O](https://github.com/thenurii/opencl_wstep_pod_praktyki/blob/main/GPULibQMIV/xFile.h): `GPULibQMIV/xFile.h`
- [Picture buffers](https://github.com/thenurii/opencl_wstep_pod_praktyki/blob/main/GPULibQMIV/xPic.cpp): `GPULibQMIV/xPic.cpp`

### Quality metrics

- [IV preprocessing](https://github.com/thenurii/opencl_wstep_pod_praktyki/blob/main/GPULibQMIV/Metrics/IVPreProcessing/xIVPreProcessing.cpp): `GPULibQMIV/Metrics/IVPreProcessing/xIVPreProcessing.cpp`
- [CPU PSNR](https://github.com/thenurii/opencl_wstep_pod_praktyki/blob/main/GPULibQMIV/Metrics/PSNR/xPSNR.cpp): `GPULibQMIV/Metrics/PSNR/xPSNR.cpp`
- [OpenCL PSNR](https://github.com/thenurii/opencl_wstep_pod_praktyki/blob/main/GPULibQMIV/Metrics/PSNR/xPSNR_OpenCL.cpp): `GPULibQMIV/Metrics/PSNR/xPSNR_OpenCL.cpp`
- [CPU SSIM](https://github.com/thenurii/opencl_wstep_pod_praktyki/blob/main/GPULibQMIV/Metrics/SSIM/xSSIM.cpp): `GPULibQMIV/Metrics/SSIM/xSSIM.cpp`
- [OpenCL SSIM](https://github.com/thenurii/opencl_wstep_pod_praktyki/blob/main/GPULibQMIV/Metrics/SSIM/xSSIM_OpenCL.cpp): `GPULibQMIV/Metrics/SSIM/xSSIM_OpenCL.cpp`

### Processing and support

- [Pixel operations](https://github.com/thenurii/opencl_wstep_pod_praktyki/blob/main/GPULibQMIV/xPixelOpsSTD.cpp): `GPULibQMIV/xPixelOpsSTD.cpp`
- [Pixel vector types](https://github.com/thenurii/opencl_wstep_pod_praktyki/blob/main/GPULibQMIV/xVec4.h): `GPULibQMIV/xVec4.h`
- [CPU sepia](https://github.com/thenurii/opencl_wstep_pod_praktyki/blob/main/GPULibQMIV/Metrics/SepiaFiles/xSepia.cpp): `GPULibQMIV/Metrics/SepiaFiles/xSepia.cpp`
- [OpenCL sepia](https://github.com/thenurii/opencl_wstep_pod_praktyki/blob/main/GPULibQMIV/Metrics/SepiaFiles/xSepia_OpenCL.cpp): `GPULibQMIV/Metrics/SepiaFiles/xSepia_OpenCL.cpp`
- [Formatting library](https://github.com/thenurii/opencl_wstep_pod_praktyki/tree/main/GPULibQMIV/lib_fmt): `GPULibQMIV/lib_fmt`
- [Common definitions](https://github.com/thenurii/opencl_wstep_pod_praktyki/blob/main/GPULibQMIV/CommonDef.h): `GPULibQMIV/CommonDef.h`

### Other components

- **User**

## Connections

- User → Comparison app: runs
- Comparison app → OpenCL discovery: queries device (evidence: `GPULibQMIV/PP.cpp`)
- Comparison app → Reference sequence: opens input (evidence: `GPULibQMIV/PP.cpp`)
- Comparison app → Test sequence: opens input (evidence: `GPULibQMIV/PP.cpp`)
- Reference sequence → Binary file I/O: uses file I/O (evidence: `GPULibQMIV/xSeq.cpp`)
- Test sequence → Binary file I/O: uses file I/O (evidence: `GPULibQMIV/xSeq.cpp`)
- Comparison app → Picture buffers: creates frames (evidence: `GPULibQMIV/PP.cpp`)
- Comparison app → IV preprocessing: configures metric (evidence: `GPULibQMIV/PP.cpp`)
- Comparison app → CPU PSNR: configures metric (evidence: `GPULibQMIV/PP.cpp`)
- Comparison app → OpenCL PSNR: configures metric (evidence: `GPULibQMIV/PP.cpp`)
- Comparison app → CPU SSIM: selects metric (evidence: `GPULibQMIV/PP.cpp`)
- Comparison app → OpenCL SSIM: selects metric (evidence: `GPULibQMIV/PP.cpp`)
- Comparison app → Result statistics: prints results (evidence: `GPULibQMIV/PP.cpp`)
- OpenCL PSNR → CPU PSNR: extends
- OpenCL SSIM → CPU SSIM: uses metric API
- CPU PSNR → Pixel operations: uses operations (evidence: `GPULibQMIV/Metrics/PSNR/xPSNR.cpp`)
- CPU SSIM → Pixel operations: uses operations
- IV preprocessing → Pixel vector types: uses vectors (evidence: `GPULibQMIV/Metrics/IVPreProcessing/xIVPreProcessing.cpp`)
- OpenCL PSNR → Picture buffers: reads frames (evidence: `GPULibQMIV/Metrics/PSNR/xPSNR_OpenCL.cpp`)
- OpenCL PSNR → Binary file I/O: loads kernels (evidence: `GPULibQMIV/Metrics/PSNR/xPSNR_OpenCL.cpp`)
- Comparison app → Formatting library: formats output (evidence: `GPULibQMIV/PP.cpp`)
- CPU PSNR → Formatting library: formats output (evidence: `GPULibQMIV/Metrics/PSNR/xPSNR.cpp`)
- Result statistics → Formatting library: formats tables
- CPU sepia → Picture buffers: transforms images
- OpenCL sepia → Picture buffers: transforms images
