What problem does it solve?
Animal welfare monitoring typically evaluates each readout (weight loss, temperature, clinical scores) in isolation, making it hard to judge how severely an individual animal is affected or to anticipate humane endpoints before they are reached.
Core Features & Use Cases
- RELSA scoring: Combines multiple welfare readouts into one per-animal, per-time-point severity score relative to a reference set, with baseline normalization, directionality (turned variables), and ordinal score mapping.
- ARIMA forecasting (foRcast): Fits per-animal ARIMA models to RELSA trajectories to predict endpoint scores with 95% prediction intervals, evaluated by RMSE, PICP, and MPIW.
- KDE severity zones: Derives candidate attention/danger thresholds from kernel density minima on the RELSA scale, with bandwidth sensitivity guidance.
- Use Case: Given a CSV of daily mouse measurements (weight, temperature, clinical score, biomarker), compute RELSA scores against the endpoint-reaching reference group, forecast which animals will reach the humane endpoint, and report severity zones for a 3Rs or EU Directive 2010/63/EU welfare assessment.
Quick Start
Ask the agent to compute RELSA scores from your cohort CSV using scripts/relsa_score.py with the endpoint group as reference, then forecast endpoints with scripts/forecast_relsa.py.