pareto#

eclypse.policies.distribution.pareto(*, node_assets=None, edge_assets=None, node_distribution=1.0, edge_distribution=None, node_asset_distributions=None, edge_asset_distributions=None, minimum=0.0, node_ids=None, node_filter=None, edge_ids=None, edge_filter=None)[source]#

Sample Pareto multiplicative factors.

Parameters:
  • node_assets (str | list[str] | None) – Optional node asset key selector.

  • edge_assets (str | list[str] | None) – Optional edge asset key selector.

  • node_distribution (float) – Default Pareto alpha for selected node assets.

  • edge_distribution (float | None) – Default alpha for selected edge assets. When omitted, node_distribution is reused.

  • node_asset_distributions (dict[str, float] | None) – Optional per-node-asset alphas.

  • edge_asset_distributions (dict[str, float] | None) – Optional per-edge-asset alphas.

  • minimum (float) – Lower bound after applying the sampled multiplier.

  • node_ids (list[str] | None) – Optional explicit node identifiers to mutate.

  • node_filter (NodeFilter | None) – Optional predicate receiving (node_id, data).

  • edge_ids (list[tuple[str, str]] | None) – Optional explicit edge identifiers to mutate.

  • edge_filter (EdgeFilter | None) – Optional predicate receiving (source, target, data).

Returns:

Policy that multiplies selected numeric assets by Pareto samples.

Return type:

UpdatePolicy