qiskit.circuit.ParameterExpression.bind

ParameterExpression.bind(parameter_values, allow_unknown_parameters=False)

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.

• allow_unknown_parameters (bool) – If False, raises an error if parameter_values contains Parameters in the keys outside those present in the expression. If True, any such parameters are simply ignored.

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.