qpandalite.task.origin_qcloud package#

Submodules#

qpandalite.task.origin_qcloud.task module#

Origin Quantum Cloud (本源量子云) backend for task submission and querying.

This is the primary production backend for QPanda-lite.

All HTTP communication is routed through OriginQAdapter in the adapters layer — there are no raw requests calls in this module.

Configuration is loaded from environment variables (preferred) or from originq_cloud_config.json (deprecated fallback):

QPANDA_API_KEY : API token QPANDA_SUBMIT_URL : Submission endpoint URL QPANDA_QUERY_URL : Query endpoint URL QPANDA_TASK_GROUP_SIZE: Max circuits per group (default: 200)

Public API:

  • submit_task — Submit circuit(s) for execution on OriginQ Cloud.

  • query_by_taskid — Asynchronously query task status by task ID.

  • query_by_taskid_sync — Synchronously query task status (blocking).

  • query_all_tasks — Query all locally recorded tasks.

qpandalite.task.origin_qcloud.task.query_all_task(savepath=None, **kwargs)[源代码]

Deprecated — use query_all_tasks() instead.

qpandalite.task.origin_qcloud.task.query_all_tasks(savepath=None, **kwargs)[源代码]

Query status of all locally recorded tasks.

返回类型:

tuple[int, int]

qpandalite.task.origin_qcloud.task.query_by_taskid(taskid, savepath=None, **kwargs)[源代码]

Query task status by task ID (non-blocking).

Supports a single task ID or a list. Results are merged; overall status reflects the worst case (failed > running > success).

参数:

taskid (List[str] | str)

返回类型:

dict

qpandalite.task.origin_qcloud.task.query_by_taskid_sync(taskid, interval=2.0, timeout=60.0, retry=5, savepath=None, **kwargs)[源代码]

Query task status by task ID (blocking) until completion or timeout.

参数:

  • taskid (List[str] | str)

  • interval (float)

  • timeout (float)

  • retry (int)

返回类型:

list

qpandalite.task.origin_qcloud.task.submit_task(circuit, task_name=None, tasktype=None, chip_id=72, shots=1000, circuit_optimize=True, measurement_amend=False, auto_mapping=False, specified_block=None, savepath=None, **kwargs)[源代码]

Submit one or more quantum circuits for execution on OriginQ Cloud.

参数:

  • circuit (str | List[str]) -- OriginIR circuit string or list of strings.

  • task_name (str | None) -- Human-readable task name.

  • tasktype -- Reserved (unused).

  • chip_id (int) -- Target chip ID (default 72).

  • shots (int) -- Number of measurement shots.

  • circuit_optimize (bool) -- Enable circuit optimization.

  • measurement_amend (bool) -- Enable measurement error mitigation.

  • auto_mapping (bool) -- Enable automatic qubit mapping.

  • specified_block -- Reserved (unused).

  • savepath -- Directory for local task records.

返回:

Task ID(s) assigned by the backend.

返回类型:

str or list[str]

Module contents#

Origin Quantum Cloud (本源量子云) backend — the primary production backend.