haipipe-utils

Normalize a logged activity (any cohort's dialect, free text or vendor code) to a PA Compendium MET and, when minutes and body mass are known, an estimated kcal. Use when an Exercise ProcName's ExerciseType column needs energy or intensity, when a SourceFn must enrich exercise data, or when a cohort's activity codes must be typed before analysis. Trigger: describe exercise, exercise to MET, activity to calories, resolve ExerciseType, compendium, exnorm, 运动归一化.

Normalize free-text food descriptions (any cohort's dialect) to USDA nutrition. Use when a Diet ProcName's FoodName column needs Calories/Carbs/Protein/Fat/Fiber, when a SourceFn must enrich diet data, or when the FoodNorm lexicon needs rebuilding. Trigger: describe food, food to nutrition, resolve diet to USDA, fill nutrition columns, foodnorm, 食物营养归一化.

Turn an insulin product name into pharmacokinetic parameters: class, onset, peak, duration. Consumes describe-medication's DrugKey, and also serves cohorts that name only an insulin CLASS (OhioT1DM) or a product the FDA Directory does not list (Shanghai). Use when insulin-on-board or insulin action timing is needed, or when insulin rows must be classified rapid/short/intermediate/long/ultra-long/premix. Trigger: describe insulin, insulin PK, onset peak duration, IOB, insulin on board, DIA, basal bolus, insnorm, 胰岛素药代.

Normalize a logged medication (any cohort's dialect: a WellDoc MedicationID, an OhioT1DM drug class, a Shanghai free-text string) to an FDA-identified drug with a dose that states its own unit. Use when a Medication ProcName needs a drug name, an NDC, a pharmacologic class, or a dose scale, or when a SourceFn must enrich medication data. Trigger: describe medication, medication to drug name, resolve MedicationID, NDC, RxNorm, dose unit, mednorm, 药物归一化.

The contract every describe-* normalizer obeys: free text in a cohort's own dialect, resolved against a reference bank, into numbers that carry their own provenance. Owns the five rules and the door signature; ships no code. Load before building or changing a normalizer. Trigger: normalizer contract, new normalizer, describe-food, describe-exercise, normalize door, provenance columns, basis column, haipipe-utils.