cirq_google.engine.AbstractJob

View source on GitHub

An abstract object representing a quantum job execution.

This represents the state of a possibly asynchronous Job being executed by a simulator, the cloud Engine service, or other means.

This is an abstract interface that implementers of services or mocks should implement. It generally represents the execution of a circuit using a set of parameters called a sweep. It can also represent the execution of a batch job (a list of circuit/sweep pairs) or the execution of a calibration request.

This job may be in a variety of states. It may be scheduling, it may be executing on a machine, or it may have entered a terminal state (either succeeding or failing).

AbstractJobs can be iterated over, returning Results. These Results can also be accessed by index. Note that this will block until the results are returned.

Methods

add_labels

View source

@abc.abstractmethod
add_labels(
    labels: dict[str, str]
) -> AbstractJob

Adds new labels to a previously created quantum job.

cancel

View source

@abc.abstractmethod
cancel() -> (bool | None)

Cancel the job.

create_time

View source

@abc.abstractmethod
create_time() -> datetime.datetime

Returns when the job was created.

delete

View source

@abc.abstractmethod
delete() -> (bool | None)

Deletes the job and result, if any.

description

View source

@abc.abstractmethod
description() -> str

Returns the description of the job.

engine

View source

@abc.abstractmethod
engine() -> abstract_engine.AbstractEngine

Returns the parent AbstractEngine object.

execution_status

View source

@abc.abstractmethod
execution_status() -> quantum.ExecutionStatus.State

Return the execution status of the job.

failure

View source

@abc.abstractmethod
failure() -> (tuple[str, str] | None)

Return failure code and message of the job if present.

get_calibration

View source

@abc.abstractmethod
get_calibration() -> (calibration.Calibration | None)

Returns the recorded calibration at the time when the job was run, if one was captured, else None.

get_processor

View source

@abc.abstractmethod
get_processor() -> (abstract_processor.AbstractProcessor | None)

Returns the AbstractProcessor for the processor the job is/was run on, if available, else None.

get_repetitions_and_sweeps

View source

@abc.abstractmethod
get_repetitions_and_sweeps() -> tuple[int, list[cirq.Sweep]]

Returns the repetitions and sweeps for the job.

id

View source

@abc.abstractmethod
id() -> str

Returns the id of this job.

labels

View source

@abc.abstractmethod
labels() -> dict[str, str]

Returns the labels of the job.

processor_ids

View source

@abc.abstractmethod
processor_ids() -> list[str]

Returns the processor ids provided when the job was created.

program

View source

@abc.abstractmethod
program() -> abstract_program.AbstractProgram

Returns the parent AbstractProgramobject.

remove_labels

View source

@abc.abstractmethod
remove_labels(
    keys: list[str]
) -> AbstractJob

Removes labels with given keys.

results

View source

results()

Returns the job results, blocking until the job is complete.

results_async

View source

results_async()

Returns the job results, blocking until the job is complete.

set_description

View source

@abc.abstractmethod
set_description(
    description: str
) -> AbstractJob

Sets the description of the job.

set_labels

View source

@abc.abstractmethod
set_labels(
    labels: dict[str, str]
) -> AbstractJob

Sets (overwriting) the labels for a previously created quantum job.

update_time

View source

@abc.abstractmethod
update_time() -> datetime.datetime

Returns when the job was last updated.

__getitem__

View source

__getitem__(
    item
)

__iter__

View source

__iter__() -> Iterator[cirq.Result]

__len__

View source

__len__() -> int