Spaces:
Running
Running
File size: 3,296 Bytes
713f736 | 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 | """Pydantic mirror of schemas/vision_output.json (plan §6.1-6.2).
The JSON Schema is the contract; this model mirrors it field for field and adds the rules JSON
Schema cannot express: volumes rounded to one decimal, and mismatch fields derived from the
two volumes. tests/test_contract.py checks that the two stay in sync.
"""
from typing import Literal, Optional
from pydantic import BaseModel, ConfigDict, Field, model_validator
SCHEMA_VERSION = "0.1"
OcclusionSite = Literal["ICA", "M1", "M2", "basilar", "none", "unknown"]
# Below this core volume the ratio is numerically meaningless and is reported as null.
MIN_CORE_FOR_RATIO_ML = 1.0
VOLUME_DECIMALS = 1
RATIO_DECIMALS = 2
def derive_mismatch(
core_ml: Optional[float], penumbra_ml: Optional[float]
) -> tuple[Optional[float], Optional[float]]:
"""Return (mismatch_ratio, mismatch_volume_ml) from the already-rounded volumes.
ratio = penumbra / core, null if core < 1 mL; volume = penumbra - core.
Either volume null -> both null.
"""
if core_ml is None or penumbra_ml is None:
return None, None
volume = round(penumbra_ml - core_ml, VOLUME_DECIMALS)
if core_ml < MIN_CORE_FOR_RATIO_ML:
return None, volume
return round(penumbra_ml / core_ml, RATIO_DECIMALS), volume
class _Strict(BaseModel):
# strict: no silent coercion ("true" -> True, null -> 0); forbid: no undeclared fields.
model_config = ConfigDict(extra="forbid", strict=True, frozen=True)
class Haemorrhage(_Strict):
present: bool
confidence: float = Field(ge=0, le=1)
class Confidence(_Strict):
core: float = Field(ge=0, le=1)
penumbra: float = Field(ge=0, le=1)
class VisionOutput(_Strict):
schema_version: Literal["0.1"]
case_id: str = Field(min_length=1)
model_version: str = Field(min_length=1)
haemorrhage: Haemorrhage
core_ml: Optional[float] = Field(ge=0)
penumbra_ml: Optional[float] = Field(ge=0)
mismatch_ratio: Optional[float] = Field(ge=0)
mismatch_volume_ml: Optional[float]
occlusion_site: OcclusionSite
aspects: Optional[int] = Field(ge=0, le=10)
confidence: Confidence
warnings: list[str]
@model_validator(mode="after")
def _check_rounding_and_derived(self) -> "VisionOutput":
for name in ("core_ml", "penumbra_ml", "mismatch_volume_ml"):
value = getattr(self, name)
if value is not None and round(value, VOLUME_DECIMALS) != value:
raise ValueError(f"{name}={value} is not rounded to {VOLUME_DECIMALS} decimal")
expected_ratio, expected_volume = derive_mismatch(self.core_ml, self.penumbra_ml)
if self.mismatch_ratio != expected_ratio:
raise ValueError(
f"mismatch_ratio={self.mismatch_ratio}, expected {expected_ratio} "
f"from core_ml={self.core_ml}, penumbra_ml={self.penumbra_ml}"
)
if self.mismatch_volume_ml != expected_volume:
raise ValueError(
f"mismatch_volume_ml={self.mismatch_volume_ml}, expected {expected_volume} "
f"from core_ml={self.core_ml}, penumbra_ml={self.penumbra_ml}"
)
if any(not w for w in self.warnings):
raise ValueError("warnings must be non-empty strings")
return self
|