execute

qnexus.execute(

circuits: CircuitRef | list[CircuitRef],

n_shots: list[int] | list[None],

backend_config: Annotated[AerConfig | AerStateConfig | AerUnitaryConfig | BraketConfig | QuantinuumConfig | IBMQConfig | IBMQEmulatorConfig | ProjectQConfig | QulacsConfig, FieldInfo(annotation=NoneType, required=True, discriminator='type')],

name: str,

description: str = '',

properties: OrderedDict[str, bool | int | float | str] | None = None,

project: ProjectRef | None = None,

valid_check: bool = True,

postprocess: bool = True,

noisy_simulator: bool = True,

wasm_module: WasmModuleRef | None = None,

language: Language = Language.AUTO,

seed: int | None = None,

credential_name: str | None = None,

user_group: str | None = None,

timeout: float | None = 300.0,

) → list[BackendResult]

Utility method to run an execute job and return the results. Blocks until the results are available. See qnexus.start_execute_job for a function that submits the job and returns immediately, rather than waiting for results.

qnexus.start_execute_job(

circuits: CircuitRef | list[CircuitRef],

n_shots: list[int] | list[None],

backend_config: Annotated[AerConfig | AerStateConfig | AerUnitaryConfig | BraketConfig | QuantinuumConfig | IBMQConfig | IBMQEmulatorConfig | ProjectQConfig | QulacsConfig, FieldInfo(annotation=NoneType, required=True, discriminator='type')],

name: str,

description: str = '',

properties: OrderedDict[str, bool | int | float | str] | None = None,

project: ProjectRef | None = None,

valid_check: bool = True,

postprocess: bool = True,

noisy_simulator: bool = True,

language: Language = Language.AUTO,

seed: int | None = None,

credential_name: str | None = None,

wasm_module: WasmModuleRef | None = None,

user_group: str | None = None,

) → ExecuteJobRef

Submit an execute job to be run in Nexus. Returns an ExecuteJobRef object which can be used to check the job’s status. See qnexus.execute for a utility method that waits for the results and returns them.

class qnexus.models.references.ExecuteJobRef(

*,

id: UUID,

annotations: Annotations,

job_type: JobType = JobType.EXECUTE,

last_status: StatusEnum,

last_message: str,

project: ProjectRef,

type: Literal['ExecuteJobRef'] = 'ExecuteJobRef',

)

Proxy object to an ExecuteJob in Nexus.

df() → DataFrame

Present in a pandas DataFrame.

class qnexus.models.references.ExecutionResultRef(

*,

id: UUID,

annotations: Annotations,

project: ProjectRef,

type: Literal['ExecutionResultRef'] = 'ExecutionResultRef',

)

Proxy object to the results of a circuit execution through Nexus.

df() → DataFrame

Present in a pandas DataFrame.

download_backend_info() → BackendInfo

Get a copy of the pytket BackendInfo.

download_result() → BackendResult

Get a copy of the pytket BackendResult.

get_input() → CircuitRef

Get the CircuitRef of the input circuit.