physix/verifier/__init__.py

"""Verifier layer: parse hypothesis, simulate, score, summarise mismatch.

Public API:

- :func:`parse_equation` (``parser``): convert a SymPy-grammar string into a
  callable ODE right-hand-side, validated against a strict whitelist.
- :func:`simulate_hypothesis` (``simulator``): run the parsed RHS forward in
  time via ``scipy.integrate.odeint``.
- :func:`compute_match` (``metrics``): R-squared between observed and
  predicted trajectories.
- :func:`summarize_mismatch` (``mismatch``): generate a one-sentence English
  description of where prediction diverges from observation.
- :func:`compute_reward` (``reward``): combine all components into a
  :class:`RewardBreakdown`.
"""

from physix.verifier.metrics import (
    compute_amplitude_match,
    compute_frequency_match,
    compute_match,
    compute_shape_match,
    residual_summary,
)
from physix.verifier.mismatch import summarize_mismatch
from physix.verifier.parser import ParseError, ParsedEquation, parse_equation
from physix.verifier.reward import compute_reward
from physix.verifier.simulator import SimulationError, simulate_hypothesis

__all__ = [
    "compute_match",
    "compute_shape_match",
    "compute_amplitude_match",
    "compute_frequency_match",
    "residual_summary",
    "summarize_mismatch",
    "ParseError",
    "ParsedEquation",
    "parse_equation",
    "compute_reward",
    "SimulationError",
    "simulate_hypothesis",
]