simulate.py

Go to the documentation of this file.

# Copyright (c) 2025-present Aquin Labs Private Limited. All Rights Reserved.
# This file is part of the Aquin Engine. Unauthorized copying, modification,
# distribution, or use of this file, via any medium, is strictly prohibited.
# Proprietary and confidential. See LICENSE for terms.
 
"""Simulate — forecast train outcomes."""
 
from __future__ import annotations
 
from typing import Any
 
from aquin.sdk._runtime import invoke
 
 
def run(**kwargs: Any) -> dict[str, Any]:
    """Run a training simulation for the loaded model."""
    return invoke("run_simulation", kwargs, command="simulate")
 
 
def list_runs(**kwargs: Any) -> dict[str, Any]:
    return invoke("list_simulation_runs", kwargs, command="list simulation", needs_model=False)
 
 
def replay(run_id: str, **kwargs: Any) -> dict[str, Any]:
    args = {"run_id": run_id, **kwargs}
    return invoke("load_simulation_run", args, command="replay simulation", needs_model=False)
 
 
def compare(run_id_a: str, run_id_b: str, **kwargs: Any) -> dict[str, Any]:
    args = {"run_id_a": run_id_a, "run_id_b": run_id_b, **kwargs}
    return invoke("compare_simulations", args, command="compare simulation", needs_model=False)