How phuctran33/regression-lab01 works
This is a teaching project for predicting penguin body mass with linear-regression models. The user workflow is to explore the data and choose common features, run and compare four model variants on a shared train/test split, then inspect predictions and plots in the notebook and prepare a report and demo. The shared Python module loads the CSV, preprocesses features, fits models, and calculates metrics; each model module delegates to it. Notebook internals were not sampled, so notebook connections below rely on README statements rather than inspected code.
Main entry points: lab01.ipynb Explore and predict · modeling.py Shared modeling pipeline · m1.py Model M1 · m2.py Model M2
Components 10
Notebook workflow
- Explore and predict
source/lab01.ipynb - Penguins CSV
data/penguins.csv
Model implementations
- Shared modeling pipeline
source/modeling.py - Model M1
source/models/m1.py - Model M2
source/models/m2.py - Model M3
source/models/m3.py - Model M4
source/models/m4.py
Results and reporting
- Report template
report/report-template.md - Metrics and plots
source/lab01.ipynb
Other components
- Project user
Connections 15
- Project user → Explore and predict: runs and explores
README.md - Shared modeling pipeline → Penguins CSV: loads CSV
source/modeling.py - Explore and predict → Penguins CSV: uses shared data
README.md - Explore and predict → Shared modeling pipeline: uses pipeline
README.md - Model M1 → Shared modeling pipeline: builds and runs
source/models/m1.py - Model M2 → Shared modeling pipeline: builds and runs
source/models/m2.py - Model M3 → Shared modeling pipeline: builds and runs
source/models/m3.py - Model M4 → Shared modeling pipeline: builds and runs
source/models/m4.py - Explore and predict → Model M1: compares models
README.md - Explore and predict → Model M2: compares models
README.md - Explore and predict → Model M3: compares models
README.md - Explore and predict → Model M4: compares models
README.md - Shared modeling pipeline → Metrics and plots: computes metrics
source/modeling.py - Explore and predict → Metrics and plots: shows predictions and plots
README.md - Metrics and plots → Report template: informs report
README.md