# kubakolecki/xtrel architecture

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

- Interactive diagram: https://gitdiagram.com/kubakolecki/xtrel
- Repository: https://github.com/kubakolecki/xtrel

## Overview

xtrel is a C++ bundle-adjustment solver for photogrammetric data. Its visible workflow is to prepare adjustment inputs, assemble Ceres residuals and parameter blocks, solve the estimation problem, then compute uncertainty and calibration-correlation results; the solver also estimates reverse distortion. The repository includes reporting, calibration-certificate, and ray-check modules, but the excerpts do not show their runtime wiring, so they are represented as capabilities without guessed connections. Several relationships below are supported only by the SOURCE INDEX references; unsampled implementation details are not assumed.

Main entry points: [`xtrel/BundleAdjustment.cpp`](https://github.com/kubakolecki/xtrel/blob/master/xtrel/BundleAdjustment.cpp) (Bundle adjustment), [`xtrel/BundleAdjustmentData.h`](https://github.com/kubakolecki/xtrel/blob/master/xtrel/BundleAdjustmentData.h) (Adjustment data), [`xtrel/DataInserter.cpp`](https://github.com/kubakolecki/xtrel/blob/master/xtrel/DataInserter.cpp) (Residual assembly), [`xtrel/CovarianceComputer.cpp`](https://github.com/kubakolecki/xtrel/blob/master/xtrel/CovarianceComputer.cpp) (Covariance analysis)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_inputs["Adjustment inputs"]
  node_settings["Adjustment settings"]
  node_input_data["Adjustment data"]
  node_image_data["Image and camera data"]
  node_point_data["Image and terrain points"]
  node_survey_data["Angular surveys"]
end

subgraph group_model["Photogrammetry model"]
  node_camera["Camera model<br/>[Camera.cpp]"]
  node_geometry["Projection geometry<br/>[photogrammetry.cpp]"]
  node_residuals["Residual functions"]
end

subgraph group_solve["Solver construction"]
  node_solver["Bundle adjustment"]
  node_inserter["Residual assembly<br/>[DataInserter.cpp]"]
  node_address_book["Parameter address book"]
  node_residual_inserter["Residual insertion"]
end

subgraph group_analysis["Post-solve analysis"]
  node_covariance["Covariance analysis"]
  node_standard_deviation["Standard deviations"]
  node_correlation["Calibration correlations"]
  node_reverse_distortion["Reverse distortion"]
  node_covariance_matrix["Covariance matrices<br/>[CovarianceMatrix.h]"]
end

subgraph group_outputs["Results and checks"]
  node_report["Adjustment report"]
  node_certificate["Calibration certificate"]
  node_ray_check["Ray intersection check"]
end

node_solver -->|"assembles problem"| node_inserter
node_solver -->|"computes covariance"| node_covariance
node_solver -->|"inserts deviations"| node_standard_deviation
node_solver -->|"runs analysis"| node_correlation
node_solver -->|"inserts residuals"| node_residual_inserter
node_solver -->|"estimates distortion"| node_reverse_distortion
node_inserter -->|"registers residual blocks"| node_residuals
node_inserter -->|"records parameters"| node_address_book
node_covariance -.->|"produces matrices"| node_covariance_matrix
node_correlation -.->|"uses covariance"| node_covariance
node_input_data -->|"contains settings"| node_settings
node_input_data -->|"holds image data"| node_image_data
node_input_data -->|"holds point data"| node_point_data
node_input_data -->|"holds surveys"| node_survey_data
node_geometry -.->|"uses camera model"| node_camera

click node_settings "https://github.com/kubakolecki/xtrel/blob/master/xtrel/BundleAdjustmentSettings.cpp"
click node_input_data "https://github.com/kubakolecki/xtrel/blob/master/xtrel/BundleAdjustmentData.h"
click node_image_data "https://github.com/kubakolecki/xtrel/blob/master/xtrel/ImageDataContainer.cpp"
click node_point_data "https://github.com/kubakolecki/xtrel/blob/master/xtrel/ImagePointContainer.cpp"
click node_survey_data "https://github.com/kubakolecki/xtrel/blob/master/xtrel/AngularSurvey3DContainer.cpp"
click node_camera "https://github.com/kubakolecki/xtrel/blob/master/xtrel/Camera.cpp"
click node_geometry "https://github.com/kubakolecki/xtrel/blob/master/xtrel/photogrammetry.cpp"
click node_residuals "https://github.com/kubakolecki/xtrel/blob/master/xtrel/ResidualProjectionObjPt.h"
click node_solver "https://github.com/kubakolecki/xtrel/blob/master/xtrel/BundleAdjustment.cpp"
click node_inserter "https://github.com/kubakolecki/xtrel/blob/master/xtrel/DataInserter.cpp"
click node_address_book "https://github.com/kubakolecki/xtrel/blob/master/xtrel/ParameterAddressBook.cpp"
click node_residual_inserter "https://github.com/kubakolecki/xtrel/blob/master/xtrel/ResidualInserter.cpp"
click node_covariance "https://github.com/kubakolecki/xtrel/blob/master/xtrel/CovarianceComputer.cpp"
click node_standard_deviation "https://github.com/kubakolecki/xtrel/blob/master/xtrel/StandardDeviationInserter.cpp"
click node_correlation "https://github.com/kubakolecki/xtrel/blob/master/xtrel/CameraCalibrationCorrelationAnalyzer.cpp"
click node_reverse_distortion "https://github.com/kubakolecki/xtrel/blob/master/xtrel/ReverseDistortionEstimator.cpp"
click node_report "https://github.com/kubakolecki/xtrel/blob/master/xtrel/BundleAdjustmentReport.cpp"
click node_certificate "https://github.com/kubakolecki/xtrel/blob/master/xtrel/CalibrationCertificate.cpp"
click node_ray_check "https://github.com/kubakolecki/xtrel/blob/master/xtrel/RayIntersectionCheck.cpp"
click node_covariance_matrix "https://github.com/kubakolecki/xtrel/blob/master/xtrel/CovarianceMatrix.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_settings,node_input_data,node_image_data,node_point_data,node_survey_data toneBlue
class node_camera,node_geometry,node_residuals toneAmber
class node_solver,node_inserter,node_address_book,node_residual_inserter toneMint
class node_covariance,node_standard_deviation,node_correlation,node_reverse_distortion,node_covariance_matrix toneRose
class node_report,node_certificate,node_ray_check toneIndigo
```

## Components

### Adjustment inputs

- [Adjustment settings](https://github.com/kubakolecki/xtrel/blob/master/xtrel/BundleAdjustmentSettings.cpp): `xtrel/BundleAdjustmentSettings.cpp`
- [Adjustment data](https://github.com/kubakolecki/xtrel/blob/master/xtrel/BundleAdjustmentData.h): `xtrel/BundleAdjustmentData.h`
- [Image and camera data](https://github.com/kubakolecki/xtrel/blob/master/xtrel/ImageDataContainer.cpp): `xtrel/ImageDataContainer.cpp`
- [Image and terrain points](https://github.com/kubakolecki/xtrel/blob/master/xtrel/ImagePointContainer.cpp): `xtrel/ImagePointContainer.cpp`
- [Angular surveys](https://github.com/kubakolecki/xtrel/blob/master/xtrel/AngularSurvey3DContainer.cpp): `xtrel/AngularSurvey3DContainer.cpp`

### Photogrammetry model

- [Camera model](https://github.com/kubakolecki/xtrel/blob/master/xtrel/Camera.cpp): `xtrel/Camera.cpp`
- [Projection geometry](https://github.com/kubakolecki/xtrel/blob/master/xtrel/photogrammetry.cpp): `xtrel/photogrammetry.cpp`
- [Residual functions](https://github.com/kubakolecki/xtrel/blob/master/xtrel/ResidualProjectionObjPt.h): `xtrel/ResidualProjectionObjPt.h`

### Solver construction

- [Bundle adjustment](https://github.com/kubakolecki/xtrel/blob/master/xtrel/BundleAdjustment.cpp): `xtrel/BundleAdjustment.cpp`
- [Residual assembly](https://github.com/kubakolecki/xtrel/blob/master/xtrel/DataInserter.cpp): `xtrel/DataInserter.cpp`
- [Parameter address book](https://github.com/kubakolecki/xtrel/blob/master/xtrel/ParameterAddressBook.cpp): `xtrel/ParameterAddressBook.cpp`
- [Residual insertion](https://github.com/kubakolecki/xtrel/blob/master/xtrel/ResidualInserter.cpp): `xtrel/ResidualInserter.cpp`

### Post-solve analysis

- [Covariance analysis](https://github.com/kubakolecki/xtrel/blob/master/xtrel/CovarianceComputer.cpp): `xtrel/CovarianceComputer.cpp`
- [Standard deviations](https://github.com/kubakolecki/xtrel/blob/master/xtrel/StandardDeviationInserter.cpp): `xtrel/StandardDeviationInserter.cpp`
- [Calibration correlations](https://github.com/kubakolecki/xtrel/blob/master/xtrel/CameraCalibrationCorrelationAnalyzer.cpp): `xtrel/CameraCalibrationCorrelationAnalyzer.cpp`
- [Reverse distortion](https://github.com/kubakolecki/xtrel/blob/master/xtrel/ReverseDistortionEstimator.cpp): `xtrel/ReverseDistortionEstimator.cpp`
- [Covariance matrices](https://github.com/kubakolecki/xtrel/blob/master/xtrel/CovarianceMatrix.h): `xtrel/CovarianceMatrix.h`

### Results and checks

- [Adjustment report](https://github.com/kubakolecki/xtrel/blob/master/xtrel/BundleAdjustmentReport.cpp): `xtrel/BundleAdjustmentReport.cpp`
- [Calibration certificate](https://github.com/kubakolecki/xtrel/blob/master/xtrel/CalibrationCertificate.cpp): `xtrel/CalibrationCertificate.cpp`
- [Ray intersection check](https://github.com/kubakolecki/xtrel/blob/master/xtrel/RayIntersectionCheck.cpp): `xtrel/RayIntersectionCheck.cpp`

## Connections

- Bundle adjustment → Residual assembly: assembles problem (evidence: `xtrel/BundleAdjustment.cpp`)
- Bundle adjustment → Covariance analysis: computes covariance (evidence: `xtrel/BundleAdjustment.cpp`)
- Bundle adjustment → Standard deviations: inserts deviations (evidence: `xtrel/BundleAdjustment.cpp`)
- Bundle adjustment → Calibration correlations: runs analysis (evidence: `xtrel/BundleAdjustment.cpp`)
- Bundle adjustment → Residual insertion: inserts residuals (evidence: `xtrel/BundleAdjustment.cpp`)
- Bundle adjustment → Reverse distortion: estimates distortion (evidence: `xtrel/BundleAdjustment.cpp`)
- Residual assembly → Residual functions: registers residual blocks (evidence: `xtrel/DataInserter.cpp`)
- Residual assembly → Parameter address book: records parameters (evidence: `xtrel/DataInserter.cpp`)
- Covariance analysis → Covariance matrices: produces matrices
- Calibration correlations → Covariance analysis: uses covariance
- Adjustment data → Adjustment settings: contains settings (evidence: `xtrel/BundleAdjustmentData.h`)
- Adjustment data → Image and camera data: holds image data (evidence: `xtrel/BundleAdjustmentData.h`)
- Adjustment data → Image and terrain points: holds point data (evidence: `xtrel/BundleAdjustmentData.h`)
- Adjustment data → Angular surveys: holds surveys (evidence: `xtrel/BundleAdjustmentData.h`)
- Projection geometry → Camera model: uses camera model
