Skip to content

voiage.schema.ParameterSet

Container for parameter samples from a probabilistic sensitivity analysis.

frame : pl.DataFrame Wide Polars frame with one Float64 column per parameter in declared order. Column names are the parameter names. Sample count is the frame height.

>>> import numpy as np >>> from voiage.schema import ParameterSet >>> params = ParameterSet.from_numpy_or_dict({“cost”: np.array([1.0, 2.0])}) >>> params.parameter_names [‘cost’]

from_polars([positional or keyword] cls: None = None, [positional or keyword] frame: pl.DataFrame = None) -> ParameterSet

Create a ParameterSet from a wide Polars frame.

Parameters:

  • cls
  • frame pl.DataFrame

Returns: ParameterSet

to_polars([positional or keyword] self: ParameterSet = None) -> pl.DataFrame

Return a deep copy of the wide Polars frame.

Parameters:

  • self ParameterSet

Returns: pl.DataFrame

copy([positional or keyword] self: ParameterSet = None) -> ParameterSet

Return a deep copy of the ParameterSet.

Parameters:

  • self ParameterSet

Returns: ParameterSet

subset_by_parameters([positional or keyword] self: ParameterSet = None, [positional or keyword] parameter_names: Sequence[str] = None) -> ParameterSet

Return a new ParameterSet containing only the requested parameters.

Parameters:

  • self ParameterSet
  • parameter_names Sequence[str]

Returns: ParameterSet

from_numpy_or_dict([positional or keyword] cls: None = None, [positional or keyword] parameters: np.ndarray | dict[str, np.ndarray] | JaxArray | dict[str, JaxArray] = None) -> ParameterSet

Create a ParameterSet from a numpy/JAX array or dictionary.

Args: parameters: Either a 2D array of shape (n_samples, n_parameters) or a dictionary mapping parameter names to 1D arrays. Supports both NumPy and JAX arrays.

ParameterSet: A new ParameterSet instance

Parameters:

  • cls
  • parameters np.ndarray | dict[str, np.ndarray] | JaxArray | dict[str, JaxArray]

Returns: ParameterSet

from_jax([positional or keyword] cls: None = None, [positional or keyword] parameters: JaxArray | dict[str, JaxArray] = None) -> ParameterSet

Create a ParameterSet from a JAX array or dictionary.

Args: parameters: Either a 2D JAX array of shape (n_samples, n_parameters) or a dictionary mapping parameter names to 1D JAX arrays

ParameterSet: A new ParameterSet instance

Parameters:

  • cls
  • parameters JaxArray | dict[str, JaxArray]

Returns: ParameterSet