Shortcuts

qiskit.circuit.ParameterExpression

class ParameterExpression(symbol_map, expr)[source]

ParameterExpression class to enable creating expressions of Parameters.

Create a new ParameterExpression.

Not intended to be called directly, but to be instantiated via operations on other Parameter or ParameterExpression objects.

Parameters
  • symbol_map (Dict[Parameter, [ParameterExpression, float, or int]]) – Mapping of Parameter instances to the sympy.Symbol serving as their placeholder in expr.

  • expr (sympy.Expr) – Expression of sympy.Symbol s.

__init__(symbol_map, expr)[source]

Create a new ParameterExpression.

Not intended to be called directly, but to be instantiated via operations on other Parameter or ParameterExpression objects.

Parameters
  • symbol_map (Dict[Parameter, [ParameterExpression, float, or int]]) – Mapping of Parameter instances to the sympy.Symbol serving as their placeholder in expr.

  • expr (sympy.Expr) – Expression of sympy.Symbol s.

Methods

__init__(symbol_map, expr)

Create a new ParameterExpression.

assign(parameter, value)

Assign one parameter to a value, which can either be numeric or another parameter expression.

bind(parameter_values)

Binds the provided set of parameters to their corresponding values.

conjugate()

Return the conjugate, which is the ParameterExpression itself, since it is real.

subs(parameter_map)

Returns a new Expression with replacement Parameters.

Attributes

parameters

Returns a set of the unbound Parameters in the expression.

assign(parameter, value)[source]

Assign one parameter to a value, which can either be numeric or another parameter expression.

Parameters
  • parameter (Parameter) – A parameter in this expression whose value will be updated.

  • value (Union[ParameterExpression, float, int]) – The new value to bind to.

Return type

ParameterExpression

Returns

A new expression parameterized by any parameters which were not bound by assignment.

bind(parameter_values)[source]

Binds the provided set of parameters to their corresponding values.

Parameters

parameter_values (Dict) – Mapping of Parameter instances to the numeric value to which they will be bound.

Raises
  • CircuitError

    • If parameter_values contains Parameters outside those in self. - If a non-numeric value is passed in parameter_values.

  • ZeroDivisionError

    • If binding the provided values requires division by zero.

Return type

ParameterExpression

Returns

A new expression parameterized by any parameters which were not bound by parameter_values.

conjugate()[source]

Return the conjugate, which is the ParameterExpression itself, since it is real.

Return type

ParameterExpression

property parameters

Returns a set of the unbound Parameters in the expression.

Return type

Set

subs(parameter_map)[source]

Returns a new Expression with replacement Parameters.

Parameters

parameter_map (Dict) – Mapping from Parameters in self to the ParameterExpression instances with which they should be replaced.

Raises

CircuitError

  • If parameter_map contains Parameters outside those in self. - If the replacement Parameters in parameter_map would result in a name conflict in the generated expression.

Return type

ParameterExpression

Returns

A new expression with the specified parameters replaced.

You are viewing lang: English
Languages
English
Japanese
German
Korean