How darpa-criticalmaas/beak-ta3 works
Beak-TA3 is a mineral-predictive-mapping package. Its documented user workflow is to provide evidence and label data, run a SOM or Bayesian neural network (BNN) prediction, and inspect/export prediction products; the StatMaGIC integration modules provide orchestration for both methods. Supporting branches cover evaluation, geospatial data preparation, and first-phase model definitions. Edges reflect the README, excerpts, and SOURCE INDEX references; unsampled implementation details are not expanded.
Main entry points: call_bnn.py BNN runner · call_som.py SOM runner · file_io.py Raster and file I/O · do_nextsomcore_save_results.py SOM result export
Components 22
StatMaGIC integration
- SOM runner
src/beak/integration/statmagic/call_som.py - BNN runner
src/beak/integration/statmagic/call_bnn.py - Integration utilities
src/beak/integration/statmagic/utils.py
SOM prediction
- SOM arguments
src/beak/methods/som/argsSOM.py - SOM training
src/beak/methods/som/nextsomcore/nextsomcore.py - SOM data loading
src/beak/methods/som/nextsomcore/loadfile.py - SOM result export
src/beak/methods/som/do_nextsomcore_save_results.py - SOM label analysis
src/beak/methods/som/label_analysis.py - SOM visualization
src/beak/methods/som/plot_som_results.py - Plot helpers
src/beak/methods/som/plotting_functions.py
BNN prediction
- Bayesian network
src/beak/methods/bnn/fastBNN.py - BNN utilities
src/beak/methods/bnn/utils.py
Geospatial processing
- Raster and file I/O
src/beak/utilities/file_io.py - Vector processing
src/beak/utilities/vector_processing.py - Raster processing
src/beak/utilities/raster_processing.py - Spatial sampling
src/beak/utilities/sampling.py - Data transforms
src/beak/utilities/transform.py - Experimental geospatial tools
src/beak/experimental
Evaluation and models
- Classification metrics
src/beak/evaluation/calculate_metrics.py - Metric definitions
src/beak/evaluation/metrics_definitions.py - Phase-one models
src/beak/models
Other components
- Analyst
Connections 25
- Analyst → SOM runner: runs SOM
README.md - Analyst → BNN runner: runs BNN
README.md - SOM runner → SOM arguments: configures
src/beak/integration/statmagic/call_som.py - SOM runner → SOM training: runs SOM
src/beak/integration/statmagic/call_som.py - SOM runner → SOM result export: exports results
src/beak/integration/statmagic/call_som.py - SOM runner → SOM visualization: plots results
src/beak/integration/statmagic/call_som.py - SOM runner → Integration utilities: uses utilities
src/beak/integration/statmagic/call_som.py - SOM training → SOM data loading: loads data
src/beak/methods/som/nextsomcore/nextsomcore.py - SOM result export → SOM training: saves outputs
src/beak/methods/som/do_nextsomcore_save_results.py - SOM result export → SOM label analysis: analyzes labels
src/beak/methods/som/do_nextsomcore_save_results.py - SOM visualization → SOM label analysis: uses annotations
src/beak/methods/som/plot_som_results.py - SOM visualization → Plot helpers: uses helpers
src/beak/methods/som/plot_som_results.py - BNN runner → Bayesian network: trains and predicts
src/beak/integration/statmagic/call_bnn.py - BNN runner → BNN utilities: uses utilities
src/beak/integration/statmagic/call_bnn.py - BNN runner → Spatial sampling: samples data
src/beak/integration/statmagic/call_bnn.py - BNN runner → Raster processing: processes rasters
src/beak/integration/statmagic/call_bnn.py - BNN runner → Raster and file I/O: loads and saves
src/beak/integration/statmagic/call_bnn.py - BNN runner → Classification metrics: evaluates predictions
src/beak/integration/statmagic/call_bnn.py - Classification metrics → Bayesian network: predicts with
src/beak/evaluation/calculate_metrics.py - Classification metrics → Metric definitions: uses definitions
src/beak/evaluation/calculate_metrics.py - Spatial sampling → Vector processing: uses processing
src/beak/utilities/sampling.py - Raster processing → Raster and file I/O: uses file I/O
src/beak/utilities/raster_processing.py - Vector processing → Raster and file I/O: uses file I/O
src/beak/utilities/vector_processing.py - Data transforms → Raster and file I/O: uses file I/O
src/beak/utilities/transform.py - Experimental geospatial tools → Analyst: supports preparation
README.md