Qiskit for developers
Please visit the main repository of the project to know about the rest of the tools.
Install
npm i @qiskit/algo
Use
const qiskit = require('@qiskit/algo');
// With the default engine and length.
qiskit.random().then(rand => console.log(`Random number(default): ${rand}`));
qiskit
.random({
engine: 'anu',
length: 8,
})
.then(rand => console.log(`Random number: ${rand}`));
API
version
The actual version of the library.
-
version
(string) - Version number.
async random(opts) -> rand | jobId
Generate a true random number among 0 and 1.
-
opts
(object) - Optional parameters:-
engine
(string) - Where to run the operation. Please visit the packages to see the supported ones. The number of digits depends on the selected engine. (default: "js") -
length
(number) - Number of random hex characters to ask for to the engine. As you can see in the doc referenced before each engine has different limit, they will throw in it's overpassed. (default: 16) -
format
(string) - To ask for the result in a different format, supported ("hex"). -
custom
(string/object) - Custom stuff (API key, inited connector instance, etc) needed for some backends (visit each specific doc).
-
-
rand
(number) - Generated random number in the desired format if the operation doesn't involves a background job. -
jobId
(string) - Identifier for the generated background job (see next method).
async result(jobId, opts) -> result
Get the result of a background job generated by an algorithm method. The engine is ommited because IBM Q is the unique which uses background jobs for now.
-
jobId
(string) - Job identifier got as initial response. -
opts
(object) - Optional parameters:custom
-
result
(?) - Depending on the used agorithm:- "random": (object) - With nex fields:
-
status
(string) - To know if the job has finished correctly. Supported: "running", "completed", TODO. -
data
(number) - Generated random number. Only present if "status" is "completed".
-
- "random": (object) - With nex fields:
async factor(number) -> prime
Integer factorization in prime numbers using Shor's algorithm. Only supported in the local simulator for now, so the engine is also ommited here for now. The result can be invalid, retry in this clase.
-
number
(number/string) - Number to factorize, an integer for now. -
prime
(number) - Prime factor of the passed one.