ybkim95's picture
Create codas_engine/models.py
ca1bfe7 verified
Raw History Blame Contribute Delete
2.52 kB
"""Shared data models for CoDaS deterministic runners."""
from __future__ import annotations
from dataclasses import asdict, dataclass, field
from typing import Any
import numpy as np
def _jsonable(value: Any) -> Any:
if isinstance(value, dict):
return {str(key): _jsonable(item) for key, item in value.items()}
if isinstance(value, list):
return [_jsonable(item) for item in value]
if isinstance(value, tuple):
return [_jsonable(item) for item in value]
if isinstance(value, np.generic):
return value.item()
if isinstance(value, float) and not np.isfinite(value):
return None
return value
@dataclass
class DatasetProfile:
rows: int
columns: int
numeric_columns: list[str]
categorical_columns: list[str]
datetime_columns: list[str]
missing_fraction: dict[str, float]
suggested_targets: list[str]
target_column: str | None = None
participant_id_column: str | None = None
time_column: str | None = None
def to_dict(self) -> dict[str, Any]:
return _jsonable(asdict(self))
@dataclass
class ValidationTestResult:
name: str
dimension: str
passed: bool
applicable: bool = True
hard_gate: bool = False
metric: float | None = None
p_value: float | None = None
details: str = ""
def to_dict(self) -> dict[str, Any]:
return _jsonable(asdict(self))
@dataclass
class BiomarkerCandidate:
feature: str
rho: float
p_value: float
q_value: float
n: int
direction: str
score: float
verdict: str = "untested"
pass_rate: float = 0.0
components: list[str] = field(default_factory=list)
tests: list[ValidationTestResult] = field(default_factory=list)
evidence: str = ""
def to_dict(self) -> dict[str, Any]:
data = _jsonable(asdict(self))
data["tests"] = [test.to_dict() for test in self.tests]
return data
@dataclass
class DiscoveryReport:
profile: DatasetProfile
candidates: list[BiomarkerCandidate]
fact_sheet: dict[str, Any]
audit_log: list[str]
warnings: list[str]
markdown_report: str
def to_dict(self) -> dict[str, Any]:
return {
"profile": self.profile.to_dict(),
"candidates": [candidate.to_dict() for candidate in self.candidates],
"fact_sheet": self.fact_sheet,
"audit_log": self.audit_log,
"warnings": self.warnings,
"markdown_report": self.markdown_report,
}