NoiseHelpers

braket.circuits.noise_helpers.no_noise_applied_warning(noise_applied)[source]

Helper function to give a warning is noise is not applied.

Parameters:: noise_applied (bool) – True if the noise has been applied.
Return type:: None

braket.circuits.noise_helpers.wrap_with_list(an_item)[source]

Helper function to make the input parameter a list.

Parameters:: an_item (Any) – The item to wrap.
Return type:: list[Any]
Returns:: list[Any] – The item wrapped in a list.

braket.circuits.noise_helpers.check_noise_target_gates(noise, target_gates)[source]

Helper function to check 1. whether all the elements in target_gates are a Gate type; 2. if noise is multi-qubit noise and target_gates contain gates with the number of qubits is the same as noise.qubit_count.

Parameters:

noise (Noise) – A Noise class object to be applied to the circuit.
target_gates (Iterable[type[Gate]]) – Gate class or List of Gate classes which noise is applied to.

Return type:

None

braket.circuits.noise_helpers.check_noise_target_unitary(noise, target_unitary)[source]

Helper function to check 1. whether the input matrix is a np.ndarray type; 2. whether the target_unitary is a unitary;

Parameters:

noise (Noise) – A Noise class object to be applied to the circuit.
target_unitary (ndarray) – matrix of the target unitary gates

Return type:

None

braket.circuits.noise_helpers.check_noise_target_qubits(circuit, target_qubits=None)[source]

Helper function to check whether all the target_qubits are positive integers.

Parameters:

circuit (Circuit) – A circuit where noise is to be checked.
target_qubits (QubitSetInput | None) – Index or indices of qubit(s).

Return type:

QubitSet

Returns:

QubitSet – The target qubits.

braket.circuits.noise_helpers.apply_noise_to_moments(circuit, noise, target_qubits, position)[source]

Apply initialization/readout noise to the circuit.

When noise.qubit_count == 1, noise is added to all qubits in target_qubits.

When noise.qubit_count > 1, noise.qubit_count must be the same as the length of target_qubits.

Parameters:

circuit (Circuit) – A circuit to noise is applied to.
noise (Iterable[type[Noise]]) – Noise channel(s) to be applied to the circuit.
target_qubits (QubitSet) – Index or indices of qubits. noise is applied to.
position (str) – The position to add the noise to. May be ‘initialization’ or ‘readout_noise’.

Return type:

Circuit

Returns:

Circuit – modified circuit.

braket.circuits.noise_helpers.apply_noise_to_gates(circuit, noise, target_gates, target_qubits)[source]

Apply noise after target gates in target qubits.

When noise.qubit_count == 1, noise is applied to target_qubits after target_gates.

When noise.qubit_count > 1, all elements in target_gates, if is given, must have the same number of qubits as noise.qubit_count.

Parameters:

circuit (Circuit) – A circuit where noise is applied to.
noise (Iterable[type[Noise]]) – Noise channel(s) to be applied to the circuit.
target_gates (Iterable[type[Gate]] | np.ndarray) – List of gates, or a unitary matrix which noise is applied to.
target_qubits (QubitSet) – Index or indices of qubits which noise is applied to.

Return type:

Circuit

Returns:

Circuit – modified circuit.

Raises:

Warning – If noise is multi-qubit noise while there is no gate with the same number of qubits in target_qubits or in the whole circuit when target_qubits is not given. If no target_gates exist in target_qubits or in the whole circuit when target_qubits is not given.