离散场景集

(类来自 pyomo.contrib.pyros.uncertainty_sets)

class pyomo.contrib.pyros.uncertainty_sets.DiscreteScenarioSet(scenarios)[source]

基础:UncertaintySet

一组有限的离散不确定参数实现(或情景)。

Parameters:

场景 ((M, N) 数组形式) – 一个包含M个不同不确定参数实现的序列。

示例

包含三种场景的2D集合:

>>> from pyomo.contrib.pyros import DiscreteScenarioSet
>>> discrete_set = DiscreteScenarioSet(
...     scenarios=[[1, 1], [2, 1], [1, 2]],
... )
>>> discrete_set.scenarios
[(1, 1), (2, 1), (1, 2)]
__init__(scenarios)[源代码]

初始化自身(参见类文档字符串)。

方法

__init__(scenarios)

初始化自身(参见类文档字符串)。

compute_auxiliary_uncertain_param_vals(point)

计算给定点的辅助不确定参数值。

is_bounded(config)

如果不确定性集合是有界的,则返回True,否则返回False。

is_nonempty(config)

如果不确定性集合非空,则返回True,否则返回False。

is_valid(config)

如果不确定性集合是有界且非空的,则返回True,否则返回False。

point_in_set(point)

确定给定点是否位于离散场景集中。

set_as_constraint([uncertain_params, block])

构建一个Pyomo约束块,定义表示不确定参数的变量的不确定性集,用于两阶段鲁棒优化问题或子问题(如PyROS分离子问题)。

属性

dim

离散场景集的维度 N

geometry

离散场景集的几何形状。

parameter_bounds

离散场景集在每个维度上的边界。

scenarios

包含集合的不确定参数实现。

type

不确定性集合类型的简要描述。

成员文档

compute_auxiliary_uncertain_param_vals(point, solver=None)

计算给定点的辅助不确定参数值。 该点不需要位于不确定集合中。

Parameters:
  • point ((N,) array-like) – 兴趣点。

  • solver (Pyomo solver, optional) – 如果需要,可以使用一个Pyomo求解器来计算辅助值。

Returns:

aux_space_pt – 计算出的辅助不确定参数值。

Return type:

numpy.ndarray

is_bounded(config)[source]

如果不确定性集合是有界的,则返回 True,否则返回 False。

默认情况下,离散场景集是有界的,因为所有不确定参数场景的条目都是有限的。

is_nonempty(config)

如果不确定性集合非空,则返回True,否则返回False。

is_valid(config)

如果不确定性集合是有界且非空的,则返回True,否则返回False。

point_in_set(point)[source]

确定给定点是否位于离散场景集中。

Parameters:

point ((N,) array-like) – 感兴趣的点(参数值)。

Returns:

如果点在集合中则为真,否则为假。

Return type:

bool

set_as_constraint(uncertain_params=None, block=None)[source]

构建一个Pyomo约束块,定义表示不确定参数的变量的不确定性集,用于两阶段鲁棒优化问题或子问题(如PyROS分离子问题)。

Parameters:
  • uncertain_params (None, Var, 或 listVar, 可选) – 表示(主要)不确定参数的变量对象。如果传递了 None,则会构造新的变量对象。

  • block (BlockDataNone, 可选) – 在其上声明约束和任何新变量对象的块。如果传递了None,则会构造一个新的块。

Returns:

添加或处理的组件集合。

Return type:

UncertaintyQuantification

property dim

离散场景集的维度 N

Type:

int

property geometry

离散场景集的几何。 参见Geometry类文档。

property parameter_bounds

离散场景集在每个维度上的边界。

Returns:

列表,长度为N,包含2元组。每个元组指定其对应维度的边界。

Return type:

list 元组列表

property scenarios

包含集合的不确定参数实现。每个元组都是一个不确定参数的实现。

请注意,scenarios 属性可能会被修改,但仅限于集合的维度保持不变的情况下。

Type:

list 元组列表

property type

不确定性集合类型的简要描述。

Type:

str