dimod.ConstrainedQuadraticModel.add_variable

ConstrainedQuadraticModel.add_variable(vartype: Vartype | str | frozenset, v: Hashable | None = None, *, lower_bound: float | None = None, upper_bound: float | None = None) → Hashable

Add a variable to the model.

Parameters:

• vartype –

  Variable type. One of:

  • SPIN, 'SPIN', {-1, 1}

  • BINARY, 'BINARY', {0, 1}

  • INTEGER, 'INTEGER'

  • REAL, 'REAL'

• v – Label for the variable. Defaults to the length of the quadratic model, if that label is available. Otherwise defaults to the lowest available positive integer label.

• lower_bound – Lower bound on the variable. Ignored when the variable is BINARY or SPIN.

• upper_bound – Upper bound on the variable. Ignored when the variable is BINARY or SPIN.

Returns:

Variable label.

Raises:

ValueError – If v is already a variable in the model and the vartype, lower_bound, or upper_bound are inconsistent.

Examples

>>> from dimod import ConstrainedQuadraticModel, Integer
>>> cqm = ConstrainedQuadraticModel()
>>> cqm.add_variable('INTEGER', 'i')
'i'