qiskit.algorithms.Shor

class Shor(quantum_instance=None)

Shor’s factoring algorithm.

Shor’s Factoring algorithm is one of the most well-known quantum algorithms and finds the prime factors for input integer \(N\) in polynomial time.

Adapted from https://github.com/ttlion/ShorAlgQiskit

See also https://arxiv.org/abs/quant-ph/0205095

매개변수

quantum_instance (Union[QuantumInstance, BaseBackend, Backend, None]) – Quantum Instance or Backend

__init__(quantum_instance=None)

매개변수

quantum_instance (Union[QuantumInstance, BaseBackend, Backend, None]) – Quantum Instance or Backend

Methods

__init__([quantum_instance])	type quantum_instance Union[QuantumInstance, BaseBackend, Backend, None]
construct_circuit(N[, a, measurement])	Construct circuit.
factor(N[, a])	Execute the algorithm.
modinv(a, m)	Returns the modular multiplicative inverse of a with respect to the modulus m.

Attributes

quantum_instance

Returns quantum instance.

construct_circuit(N, a=2, measurement=False)

Construct circuit.

매개변수

• N (int) – The integer to be factored, has a min. value of 3.

• a (int) – Any integer that satisfies 1 < a < N and gcd(a, N) = 1.

• measurement (bool) – Boolean flag to indicate if measurement should be included in the circuit.

반환 형식

QuantumCircuit

반환값

Quantum circuit.

예외

ValueError – Invalid N

factor(N, a=2)

Execute the algorithm.

The input integer \(N\) to be factored is expected to be odd and greater than 2. Even though this implementation is general, its capability will be limited by the capacity of the simulator/hardware. Another input integer \(a\) can also be supplied, which needs to be a co-prime smaller than \(N\) .

매개변수

• N (int) – The integer to be factored, has a min. value of 3.

• a (int) – Any integer that satisfies 1 < a < N and gcd(a, N) = 1.

반환값

results of the algorithm.

반환 형식

ShorResult

예외

• ValueError – Invalid input

• AlgorithmError – If a quantum instance or backend has not been provided

static modinv(a, m)

Returns the modular multiplicative inverse of a with respect to the modulus m.

반환 형식

int

property quantum_instance

Returns quantum instance.

반환 형식

Optional[QuantumInstance]