qiskit.providers.ibmq.random.CQCExtractorJob

class CQCExtractorJob(job_id, client, parameters=None)

Representation of an asynchronous call to the CQC extractor.

An instance of this class is returned when you call run_async_ext1(), run_async_ext2(), or retrieve_job() method of the CQCExtractor class.

If the job is successfully submitted, you can inspect the job’s status by calling status().

Some of the methods in this class are blocking, which means control may not be returned immediately. block_until_ready() is an example of a blocking method, which waits until the job completes:

job = extractor.run_async_ext1(...)
random_bits = job.block_until_ready()

Note

An error may occur when querying the remote server to get job information. The most common errors are temporary network failures and server errors, in which case an RequestsApiError is raised. These errors usually clear quickly, so retrying the operation is likely to succeed.

CQCExtractorJob constructor.

Parameters

• job_id (str) – Job ID.

• client (RandomClient) – Object for connecting to the server.

• parameters (Optional[Dict]) – Parameters used for this job.

__init__(job_id, client, parameters=None)

CQCExtractorJob constructor.

Parameters

• job_id (str) – Job ID.

• client (RandomClient) – Object for connecting to the server.

• parameters (Optional[Dict]) – Parameters used for this job.

Methods

__init__(job_id, client[, parameters])	CQCExtractorJob constructor.
block_until_ready([timeout, wait])	Wait for the job to finish and return the result.
status()	Query the server for the latest job status.

Attributes

extractor_method	Return the extractor method used.
parameters	Return the parameters passed to the extractor.

block_until_ready(timeout=None, wait=10)

Wait for the job to finish and return the result.

Parameters

• timeout (Optional[float]) – Seconds to wait for the job. If None, wait indefinitely.

• wait (float) – Seconds between queries. Use a larger number if the job is expected to run for a long time.

Return type

List[int]

Returns

Extractor output.

Raises

JobTimeoutError – If the job does not finish before the specified timeout.

property extractor_method

Return the extractor method used.

Return type

str

Returns

Extractor method used.

property parameters

Return the parameters passed to the extractor.

Return type

Dict

Returns

Parameters passed to the extractor.

status()

Query the server for the latest job status.

Return type

JobStatus

Returns

The status of the job.