VarDict

(class from pyomo.core.beta.dict_objects)

class pyomo.core.beta.dict_objects.VarDict(*args, **kwargs)[source]

Bases: ComponentDict, IndexedVar

__init__(*args, **kwds)[source]

Methods

`__init__`(args, *kwds)
`add`(index)	Add a variable with a particular index.
`clear`()
`clear_suffix_value`(suffix_or_name[, expand])	Clear the suffix value for this component data
`cname`(args, *kwds)	DEPRECATED.
`construct`([data])	Construct the VarData objects for this variable
`dim`()	Return the dimension of the index
`display`([ostream, verbose, prefix])
`extract_values`([include_fixed_values])	Return a dictionary of index-value pairs.
`fix`([value, skip_validation])	Fix all variables in this `IndexedVar` (treat as nonvariable)
`flag_as_stale`()	Set the 'stale' attribute of every variable data object to True.
`free`()	Alias for `unfix()`
`get`(k[,d])
`get_suffix_value`(suffix_or_name[, default])	Get the suffix value for this component data
`get_units`()	Return the units expression for this Var.
`get_values`([include_fixed_values])	Return a dictionary of index-value pairs.
`getname`([fully_qualified, name_buffer, ...])	Returns the component name associated with this object.
`id_index_map`()	Return an dictionary id->index for all ComponentData instances.
`index_set`()	Return the index set
`is_component_type`()	Return True if this class is a Pyomo component
`is_constructed`()	Return True if this class has been constructed
`is_expression_type`([expression_system])	Return True if this numeric value is an expression
`is_indexed`()	Return true if this component is indexed
`is_logical_type`()	Return True if this class is a Pyomo Boolean object.
`is_named_expression_type`()	Return True if this numeric value is a named expression
`is_numeric_type`()	Return True if this class is a Pyomo numeric object
`is_parameter_type`()	Return False unless this class is a parameter object
`is_reference`()	Return True if this component is a reference, where "reference" is interpreted as any component that does not own its own data.
`is_variable_type`()	Return False unless this class is a variable object
`items`()
`iteritems`()	DEPRECATED.
`iterkeys`()	DEPRECATED.
`itervalues`()	DEPRECATED.
`keys`()
`model`()	Returns the model associated with this object.
`parent_block`()	Returns the parent of this object.
`parent_component`()	Returns the component associated with this object.
`pop`(k[,d])	If key is not found, d is returned if given, otherwise KeyError is raised.
`popitem`()	as a 2-tuple; but raise KeyError if D is empty.
`pprint`([ostream, verbose, prefix])	Print component information
`reconstruct`([data])	REMOVED: reconstruct() was removed in Pyomo 6.0.
`root_block`()	Return self.model()
`set_suffix_value`(suffix_or_name, value[, expand])	Set the suffix value for this component data
`set_value`(value)	Set the value of a scalar component.
`set_values`(new_values[, skip_validation])	Set the values of a dictionary.
`setdefault`(k[,d])
`setlb`(val)	Set the lower bound for this variable.
`setub`(val)	Set the upper bound for this variable.
`to_dense_data`()	TODO
`type`()	DEPRECATED.
`unfix`()	Unfix all variables in this `IndexedVar` (treat as variable)
`update`([E, ]**F)	If E present and has a .keys() method, does: for k in E: D[k] = E[k] If E present and lacks .keys() method, does: for (k, v) in E: D[k] = v In either case, this is followed by: for k, v in F.items(): D[k] = v
`valid_model_component`()	Return True if this can be used as a model component.
`values`()

Attributes

`active`	Return the active attribute
`ctype`	Return the class type for this component
`domain`
`local_name`	Get the component name only within the context of the immediate parent container.
`name`	Get the fully qualified component name.

Member Documentation

add(index): Add a variable with a particular index.

clear() → None. Remove all items from D.

clear_suffix_value(suffix_or_name, expand=True): Clear the suffix value for this component data

cname(*args, **kwds): DEPRECATED.

Deprecated since version 5.0: The cname() method has been renamed to getname(). The preferred method of obtaining a component name is to use the .name property, which returns the fully qualified component name. The .local_name property will return the component name only within the context of the immediate parent container.

construct(data=None): Construct the VarData objects for this variable

dim(): Return the dimension of the index

extract_values(include_fixed_values=True): Return a dictionary of index-value pairs.

fix(value=NOTSET, skip_validation=False)

Fix all variables in this IndexedVar (treat as nonvariable)

This sets the fixed indicator to True for every variable in this IndexedVar. If value is provided, the value (and the skip_validation flag) are first passed to set_value().

flag_as_stale(): Set the ‘stale’ attribute of every variable data object to True.

free(): Alias for unfix()

get(k[, d]) → D[k] if k in D, else d. d defaults to None.

get_suffix_value(suffix_or_name, default=None): Get the suffix value for this component data

get_units(): Return the units expression for this Var.

get_values(include_fixed_values=True): Return a dictionary of index-value pairs.

getname(fully_qualified=False, name_buffer=None, relative_to=None)

Returns the component name associated with this object.

Parameters:

fully_qualified (bool) – Generate full name from nested block names
relative_to (Block) – Generate fully_qualified names relative to the specified block.

id_index_map(): Return an dictionary id->index for all ComponentData instances.

index_set(): Return the index set

is_component_type(): Return True if this class is a Pyomo component

is_constructed(): Return True if this class has been constructed

is_expression_type(expression_system=None): Return True if this numeric value is an expression

is_indexed(): Return true if this component is indexed

is_logical_type()

Return True if this class is a Pyomo Boolean object.

Boolean objects include constants, variables, or logical expressions.

is_named_expression_type(): Return True if this numeric value is a named expression

is_numeric_type(): Return True if this class is a Pyomo numeric object

is_parameter_type(): Return False unless this class is a parameter object

is_reference(): Return True if this component is a reference, where “reference” is interpreted as any component that does not own its own data.

is_variable_type(): Return False unless this class is a variable object

items() → a set-like object providing a view on D's items

iteritems()

DEPRECATED.

Return a list (index,data) tuples from the dictionary

Deprecated since version 6.0: The iteritems method is deprecated. Use dict.items().

iterkeys()

DEPRECATED.

Return a list of keys in the dictionary

Deprecated since version 6.0: The iterkeys method is deprecated. Use dict.keys().

itervalues()

DEPRECATED.

Return a list of the component data objects in the dictionary

Deprecated since version 6.0: The itervalues method is deprecated. Use dict.values().

keys() → a set-like object providing a view on D's keys

model(): Returns the model associated with this object.

parent_block(): Returns the parent of this object.

parent_component(): Returns the component associated with this object.

pop(k[, d]) → v, remove specified key and return the corresponding value.: If key is not found, d is returned if given, otherwise KeyError is raised.

popitem() → (k, v), remove and return some (key, value) pair: as a 2-tuple; but raise KeyError if D is empty.

pprint(ostream=None, verbose=False, prefix=''): Print component information

reconstruct(data=None)

REMOVED: reconstruct() was removed in Pyomo 6.0.

Re-constructing model components was fragile and did not correctly update instances of the component used in other components or contexts (this was particularly problemmatic for Var, Param, and Set). Users who wish to reproduce the old behavior of reconstruct(), are comfortable manipulating non-public interfaces, and who take the time to verify that the correct thing happens to their model can approximate the old behavior of reconstruct with:

component.clear() component._constructed = False component.construct()

root_block(): Return self.model()

set_suffix_value(suffix_or_name, value, expand=True): Set the suffix value for this component data

set_value(value): Set the value of a scalar component.

set_values(new_values, skip_validation=False)

Set the values of a dictionary.

The default behavior is to validate the values in the dictionary.

setdefault(k[, d]) → D.get(k,d), also set D[k]=d if k not in D

setlb(val): Set the lower bound for this variable.

setub(val): Set the upper bound for this variable.

to_dense_data(): TODO

type()

DEPRECATED.

Return the class type for this component

Deprecated since version 5.7: Component.type() method has been replaced by the .ctype property.

unfix()

Unfix all variables in this IndexedVar (treat as variable)

This sets the VarData.fixed indicator to False for every variable in this IndexedVar.

update([E, ]**F) → None. Update D from mapping/iterable E and F.: If E present and has a .keys() method, does: for k in E: D[k] = E[k] If E present and lacks .keys() method, does: for (k, v) in E: D[k] = v In either case, this is followed by: for k, v in F.items(): D[k] = v

valid_model_component(): Return True if this can be used as a model component.

values() → an object providing a view on D's values

property active: Return the active attribute

property ctype: Return the class type for this component

property local_name: Get the component name only within the context of the immediate parent container.

property name: Get the fully qualified component name.