module ptwm.ablation

def attribute_leave_one_out(input_path: str | Path, baseline_policy: str | Path | None, out_dir: str | Path, max_attributions: int = 32) -> AttributionResult

def attribute_shapley(input_path: str | Path, baseline_policy: str | Path | None, out_dir: str | Path, max_attributions: int = 8) -> AttributionResult

class AttributionResult:

def __init__(self, method: str, rows: list[AttributionRow]) -> None

method: str

rows: list[AttributionRow]

class AttributionRow:

def __init__(self, contribution_id: str, label: str, baseline_size: int, without_size: int, delta_bytes: int, delta_pct: float) -> None

baseline_size: int

contribution_id: str

delta_bytes: int

delta_pct: float

label: str

without_size: int

def bench_compare(a: str | Path, b: str | Path) -> CompareResult

def bench_compress(input_path: str | Path, baseline_policy: str | Path | None, variant_policies: Iterable[str | Path], metrics: list[str], trials: int, out_dir: str | Path) -> BenchResult

def bench_replay(results_csv: str | Path, row: int, out_dir: str | Path | None = None) -> ReplayResult

class BenchResult:

def __init__(self, rows: list[BenchRow] = list()) -> None

rows: list[BenchRow] = field(default_factory=list)

class BenchRow:

def __init__(self, variant: str, trial: int, input_bytes: int, output_bytes: int, ratio: float, encode_ns: int, decode_ns: int, peak_mem_bytes: int, resolved_policy_toml: str, out_file: str) -> None

decode_ns: int

encode_ns: int

input_bytes: int

out_file: str

output_bytes: int

peak_mem_bytes: int

ratio: float

resolved_policy_toml: str

trial: int

variant: str

class CompareResult:

def __init__(self, only_in_a: list[tuple[str, str]], only_in_b: list[tuple[str, str]], common: list[tuple[str, str]], size_a: int, size_b: int) -> None

common: list[tuple[str, str]]

only_in_a: list[tuple[str, str]]

only_in_b: list[tuple[str, str]]

size_a: int

size_b: int

class ReplayResult:

def __init__(self, row_variant: str, row_trial: int, expected_output_bytes: int, actual_output_bytes: int, matches: bool, out_file: str) -> None

actual_output_bytes: int

expected_output_bytes: int

matches: bool

out_file: str

row_trial: int

row_variant: str

def resolve_active(policy_path: str | os.PathLike | None = None) -> ResolvedPolicy