How kassoulet/karios works
KARIOS is a Python tool and library for assessing geometric shifts between monitored and reference Earth-observation images. The principal workflow accepts images and optional masks or DEMs, loads and checks the rasters, performs feature matching, then computes accuracy statistics and produces graphical and HTML reports. The README also documents optional large-shift detection and altitude-based analysis. The graph follows the CLI/API and module references shown in the supplied excerpts and SOURCE INDEX; unsampled implementation details are represented only where documented.
Main entry points: core.py Processing API · image.py Raster access · klt.py KLT matching · commands.py CLI commands
Components 22
Entry and configuration
- CLI commands
karios/cli/commands.py - Processing API
karios/api/core.py - Runtime settings
karios/api/config.py - Processing settings
karios/core/configuration.py
Raster and matching
- Raster access
karios/core/image.py - Radiometry conversion
karios/core/radiometry.py - Coarse alignment
karios/matcher/global_align.py - KLT matching
karios/matcher/klt.py - Coarse-to-fine matching
karios/matcher/coarse_to_fine.py - Large-shift detection
karios/matcher/large_offset.py - ZNCC scoring
karios/matcher/zncc_service.py - Mutual information
karios/matcher/mutual_info_service.py
Accuracy analysis
- Accuracy statistics
karios/accuracy_analysis/accuracy_statistics.py - Keypoint chips
karios/report/chip_service.py
Reports and products
- HTML report
karios/report/html_report.py - Product generation
karios/report/product_generator.py - Error overview
karios/report/overview_plot.py - Point coverage
karios/report/coverage_plot.py - Displacement plots
karios/report/shift_by_row_col_plot.py - Altitude analysis
karios/report/shift_by_alt_plot.py - Circular error plot
karios/report/circular_error_plot.py
Other components
- Analyst
Connections 34
- Analyst → CLI commands: runs analysis
README.md - CLI commands → Processing API: invokes processing
karios/cli/commands.py - CLI commands → Processing settings: loads settings
karios/cli/commands.py - Processing API → Runtime settings: uses runtime settings
karios/api/core.py - Processing API → Processing settings: uses processing settings
karios/api/core.py - Processing API → Raster access: loads and checks rasters
karios/api/core.py - Processing API → KLT matching: runs matching
karios/api/core.py - Processing API → Large-shift detection: detects large shifts
karios/api/core.py - Processing API → ZNCC scoring: computes match scores
karios/api/core.py - Processing API → Mutual information: computes match scores
karios/api/core.py - Processing API → Accuracy statistics: computes accuracy
karios/api/core.py - Processing API → Keypoint chips: generates keypoint chips
karios/api/core.py - Processing API → HTML report: generates report
karios/api/core.py - Processing API → Product generation: generates products
karios/api/core.py - Processing API → Error overview: creates overview
karios/api/core.py - Processing API → Point coverage: creates coverage plot
karios/api/core.py - Processing API → Circular error plot: creates accuracy plot
karios/api/core.py - Processing API → Displacement plots: creates displacement plots
karios/api/core.py - Processing API → Altitude analysis: creates altitude plot
karios/api/core.py - KLT matching → Coarse-to-fine matching: uses tracker
karios/matcher/klt.py - KLT matching → Radiometry conversion: converts image values
karios/matcher/klt.py - KLT matching → Raster access: reads image data
karios/matcher/klt.py - Coarse alignment → Radiometry conversion: converts image values
karios/matcher/global_align.py - Coarse alignment → Raster access: uses raster images
karios/matcher/global_align.py - Large-shift detection → Raster access: shifts image
karios/matcher/large_offset.py - ZNCC scoring → Raster access: extracts image patches
karios/matcher/zncc_service.py - Mutual information → Raster access: uses raster images
karios/matcher/mutual_info_service.py - Accuracy statistics → Processing settings: uses analysis settings
karios/accuracy_analysis/accuracy_statistics.py - Circular error plot → Accuracy statistics: uses accuracy metrics
karios/report/circular_error_plot.py - Point coverage → Raster access: uses image extent
karios/report/coverage_plot.py - Error overview → Raster access: uses image data
karios/report/overview_plot.py - Displacement plots → Raster access: uses image data
karios/report/shift_by_row_col_plot.py - Altitude analysis → Raster access: uses image data
karios/report/shift_by_alt_plot.py - Analyst → Processing API: calls library directly
README.md