Skip to main contentIBM Quantum Documentation
This page is from an old version of Qiskit SDK and does not exist in the latest version. We recommend you migrate to the latest version. See the release notes for more information.

LinearExpression

class LinearExpression(quadratic_program, coefficients)

GitHub

Bases: qiskit.optimization.problems.quadratic_program_element.QuadraticProgramElement

Representation of a linear expression by its coefficients.

Creates a new linear expression.

The linear expression can be defined via an array, a list, a sparse matrix, or a dictionary that uses variable names or indices as keys and stores the values internally as a dok_matrix.

Parameters

  • quadratic_program (Any) – The parent QuadraticProgram.
  • coefficients (Union[ndarray, spmatrix, List[float], Dict[Union[int, str], float]]) – The (sparse) representation of the coefficients.

Methods

evaluate

LinearExpression.evaluate(x)

Evaluate the linear expression for given variables.

Parameters

x (Union[ndarray, List, Dict[Union[int, str], float]]) – The values of the variables to be evaluated.

Return type

float

Returns

The value of the linear expression given the variable values.

evaluate_gradient

LinearExpression.evaluate_gradient(x)

Evaluate the gradient of the linear expression for given variables.

Parameters

x (Union[ndarray, List, Dict[Union[int, str], float]]) – The values of the variables to be evaluated.

Return type

ndarray

Returns

The value of the gradient of the linear expression given the variable values.

to_array

LinearExpression.to_array()

Returns the coefficients of the linear expression as array.

Return type

ndarray

Returns

An array with the coefficients corresponding to the linear expression.

to_dict

LinearExpression.to_dict(use_name=False)

Returns the coefficients of the linear expression as dictionary, either using variable names or indices as keys.

Parameters

use_name (bool) – Determines whether to use index or names to refer to variables.

Return type

Dict[Union[int, str], float]

Returns

An dictionary with the coefficients corresponding to the linear expression.


Attributes

coefficients

Returns the coefficients of the linear expression.

Return type

dok_matrix

Returns

The coefficients of the linear expression.

quadratic_program

Returns the parent QuadraticProgram.

Return type

Any

Returns

The parent QuadraticProgram.

Was this page helpful?
Report a bug or request content on GitHub.