Downloads · 30 days
0
tuva-ml-models/medicare-cost-encounter-model-prospective
medicare-cost-encounter-model-prospective is a machine learning model from tuva-ml-models. Use it for the machine learning task on the model card, and read the license before you ship it in a product. The card lists the license as mit.
Model ID: Medicare LDS 2023 Prospective PMPM + Encounter Model Bundle Model Types: XGBoost regressor bundle (Tweedie for PMPM, Poisson for PMPC) Dataset: 2023 CMS Limited Data Set (LDS) 5% Sample Target Level: Member…
Downloads · 30 days
0
Access
Public
Updated Sep 8, 2025
Repo size
91.2 MB
Likes
0
Public
Click a slice to open those files.
.pkl91.2 MB · 100%
From the Hugging Face model README
Model ID: Medicare LDS 2023 Prospective PMPM + Encounter Model Bundle Model Types: XGBoost regressor bundle (Tweedie for PMPM, Poisson for PMPC) Dataset: 2023 CMS Limited Data Set (LDS) 5% Sample Target Level: Member month (annualized for evaluation)
This repository contains a bundle of prospective regression models that forecast next-year healthcare cost and utilization. Models are trained using prior-year demographics and lagged clinical features (e.g., condition flags, HCCs, CMS chronic indicators) to predict outcomes for the subsequent prediction year.
The models predict outcomes at three levels of granularity:
Note on prediction type: These are prospective models — they use features from the baseline period to predict the following year’s outcomes. All core models output a rate (PMPM or PMPC) that is multiplied by member months to yield annualized values for reporting and evaluation.
This bundle supports forward-looking financial and operational workflows:
These metrics reflect performance on a held-out evaluation split from the 2023 CMS LDS data produced by the training pipeline in this repo. Models predict PMPM/PMPC rates; metrics are computed on annualized values (rate × member months). See prosp_model_eval_metrics_train.csv for full details across all targets.
Note: The complete list of encounter type metrics (e.g., ACUTE_INPATIENT, TELEHEALTH) are included in prosp_model_eval_metrics_train.csv along with calibration factors and prediction-to-actual (P/A) ratios.
2023_prospective_models_bundle.pkl — Bundle with trained XGBoost models, per-target calibration factors, and feature list.pmpm_encounters_prospective_train.py — Training pipeline (prospective): builds PMPM and PMPC models, logs metrics, and writes the bundle.pmpm_encounters_prospective_predict.py — Inference + evaluation script: loads the bundle, scores the prediction year, and logs metrics/predictions.prosp_model_eval_metrics_train.csv — Evaluation metrics exported from training (annualized MAE, MAE%, R², P/A ratios, calibration factors) for each target.prosp_encounter_model_feature_frequency.csv — Feature prevalence (non-zero rates) in training features used by the bundle.prosp_encounter_model_hyperparams.csv — Tuned hyperparameters used for key PMPM targets (when tuning enabled).This repository includes CSV outputs summarizing what the prospective models learned and how they were trained.
prosp_encounter_model_feature_frequency.csv)prosp_encounter_model_hyperparams.csv)objective, tweedie_variance_power, tree depth, regularization, and n_estimators.prosp_model_eval_metrics_train.csv)The training and inference scripts are designed to run in a Snowflake environment using Snowpark.
Prereqs:
MEDICARE_LDS_FIVE_MULTI_YEAR.BENCHMARKS.PERSON_YEAR_PROSPECTIVE.@MEDICARE_LDS_FIVE_PERCENT.BENCHMARKS.MODEL_STAGE.pandas numpy scikit-learn xgboost snowflake-snowpark-python.Train (writes metrics to Snowflake and uploads the bundle to the stage):
pmpm_encounters_prospective_train.py within a Snowpark session. It trains PMPM/PMPC models (groups and types), computes calibration factors on train, evaluates on a held-out split, and writes 2023_prospective_models_bundle.pkl to the stage.Predict + evaluate (scores the prospective prediction year and logs metrics/predictions):
pmpm_encounters_prospective_predict.py. It downloads the bundle, scores the configured SCORING_YEAR, applies calibration, logs evaluation metrics, and writes per-member predictions with BENCHMARK_KEY.All per-target metrics, calibration factors, and feature frequencies are exported in the CSVs included in this repo for reference.