calibrate
split-conformal quantile at miscoverage α over caller-supplied nonconformity scores. MONARK does not see, store, or verify the caller's data or model, and does not validate that the supplied numbers are nonconformity scores of any model. Marginal 1−α coverage holds ONLY for future points exchangeable with the supplied scores; non-exchangeable data (e.g. distribution-shifted or time-ordered) voids it. Never a probability of being right.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| nMin | Yes | Minimum calibration count (>= 1); n < nMin fails closed to under_calib. | |
| alpha | Yes | Target miscoverage in the open interval (0,1). | |
| scores | Yes | Caller-supplied nonconformity scores (BYO: the caller owns the score function; MONARK stays agnostic). |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| n | Yes | The number of supplied scores (echoed). | |
| qhat | Yes | The conformal quantile q̂, or null when the calibration is insufficient (fail-closed). | |
| alpha | Yes | The target miscoverage (echoed). | |
| label | Yes | Honesty label (K-1): the marginal coverage holds only under exchangeability with the supplied scores. | |
| method | Yes | The conformal method — always split. | |
| reason | Yes | under_calib when q̂ is null, else null on success. | |
| set_digest | Yes | calibDigest(scores): recalculable by reference; the audit tie to verdict.calib_digest (C2). |