How hitesh-na/hera-radiation-profiles works
This repository is a research workflow for preparing balloon-flight measurements, evaluating XGBoost count-rate models, and assessing whether altitude profiles support a Pfotzer-peak estimate. The main path is verified raw data → preprocessing → grouped model evaluation → profile and peak analysis; prediction and final refitting are additional documented capabilities. The exploratory HERA run is a separate path for explicitly unverified observations. Sampled source excerpts establish several internal calls; other workflow links below are documented by the README, while unsampled implementation details are not inferred.
Main entry points: experiments.py Grouped model evaluation · preprocessing.py Raw preprocessing · __main__.py Workflow commands · profiles.py Altitude profiles
Components 17
Data preparation
- Flight measurements
data/raw - Raw preprocessing
pfotzer_xgb/preprocessing.py - Time alignment
pfotzer_xgb/time_alignment.py - Integrity and I/O
pfotzer_xgb/io.py - Combined flight data
data/processed
Modeling
- Workflow commands
pfotzer_xgb/__main__.py - Quality screening
pfotzer_xgb/quality.py - Feature engineering
pfotzer_xgb/features.py - Grouped model evaluation
pfotzer_xgb/experiments.py - Evaluation artifacts
results
Profile analysis
- Altitude profiles
pfotzer_xgb/profiles.py - Peak screening
pfotzer_xgb/peaks.py - Scientific plots
pfotzer_xgb/plotting.py
HERA workflows
- Exploratory HERA training
HERA_Exploratory_Training_2026-11-06/train_exploratory.py - Final model refit
HERA_Final_XGBoost_2026-11-19/refit.py - Final prediction
HERA_Final_XGBoost_2026-11-19/predict.py
Other components
- Researcher
Connections 20
- Researcher → Workflow commands: runs workflow
README.md - Flight measurements → Raw preprocessing: supplies recordings
pfotzer_xgb/preprocessing.py - Raw preprocessing → Time alignment: unwraps timer
pfotzer_xgb/preprocessing.py - Raw preprocessing → Integrity and I/O: writes provenance
pfotzer_xgb/preprocessing.py - Raw preprocessing → Combined flight data: writes combined data
pfotzer_xgb/preprocessing.py - Workflow commands → Raw preprocessing: dispatches preparation
pfotzer_xgb/__main__.py - Workflow commands → Grouped model evaluation: dispatches evaluation
pfotzer_xgb/__main__.py - Combined flight data → Grouped model evaluation: provides training data
README.md - Grouped model evaluation → Quality screening: audits rows
pfotzer_xgb/experiments.py - Grouped model evaluation → Feature engineering: engineers inputs
pfotzer_xgb/experiments.py - Grouped model evaluation → Altitude profiles: builds profiles
pfotzer_xgb/experiments.py - Grouped model evaluation → Peak screening: screens peaks
pfotzer_xgb/experiments.py - Grouped model evaluation → Scientific plots: creates figures
pfotzer_xgb/experiments.py - Grouped model evaluation → Evaluation artifacts: saves evaluation artifacts
README.md - Peak screening → Altitude profiles: smooths supported bins
pfotzer_xgb/peaks.py - Scientific plots → Altitude profiles: uses profile smoothing
pfotzer_xgb/plotting.py - Researcher → Exploratory HERA training: runs exploratory study
HERA_Exploratory_Training_2026-11-06/train_exploratory.py - Researcher → Final model refit: requests refit
README.md - Final model refit → Final prediction: enables model prediction
- Researcher → Final prediction: requests predictions
README.md