simulate_summaries

voi.simulate_summaries(draws, study, *, seed=None)

Simulate one study dataset summary per parameter draw.

Parameters

Name Type Description Default
draws pd.DataFrame Parameter draw matrix (rows = iterations). required
study StudySimulator Callable simulating the proposed study from one draw. required
seed int | np.random.Generator | None Seed or generator for the study-data randomness. None

Returns

Name Type Description
pd.DataFrame DataFrame of summaries aligned on the draws’ iteration index.

Example

import numpy as np, pandas as pd from heormodel.voi import simulate_summaries draws = pd.DataFrame({“p”: [0.1, 0.2]}, … index=pd.RangeIndex(2, name=“iteration”)) def study(row, rng): … return {“x”: float(rng.binomial(100, row[“p”]))} simulate_summaries(draws, study, seed=1).shape (2, 1)