QUDORAClient

class QUDORAClient

ベースクラス: QuantumBaseClient[AlgoType, _QudoraJobMeta, QiskitCircuit]

Client that executes quantum circuits on QUDORA hardware.

Connects to the QUDORA platform using an API token and runs circuits on the specified device. Accepts any algorithm conforming to QuantumAlgoProtocol via the algo parameter.

Methods

__init__

Initialize a QUDORAClient.

solve

Call the solver service to solve the given optimization problem.

version

Return the installed qudora_sdk package version.

Attributes

acceptable_degrees

Polynomial degrees accepted by the algorithm for the objective and constraints.

algo

The algorithm class used by this client.

device

Name of the target QUDORA device.

device_settings

Device-specific settings forwarded to the QUDORA backend on each job submission.

qiskit_pass_manager

Qiskit transpilation pass manager.

token

QUDORA API token used to authenticate, or None if not set.

url

QUDORA service URL, or None to use the default endpoint.

parameters

Algorithm parameters instance.

__init__(
algo: type[AlgoType],
token: str | None = None,
url: str | None = None,
device: str = 'Qamelion',
qiskit_pass_manager: PassManager | EllipsisType | None = Ellipsis,
device_settings: dict | None = None,
) None

Initialize a QUDORAClient.

パラメータ:
  • algo (type[AlgoType]) -- The algorithm class to use (e.g., QAOA).

  • token (str | None) -- QUDORA API token. Required to access the service.

  • url (str | None) -- QUDORA service URL. If None, the default endpoint is selected automatically based on the token prefix.

  • device (str) -- Name of the QUDORA device. Defaults to "Qamelion".

  • qiskit_pass_manager (PassManager | EllipsisType | None) -- Custom Qiskit transpilation pass manager. If ... (default), a preset pass manager is generated automatically. Pass None to skip transpilation.

  • device_settings (dict | None) -- Device-specific settings forwarded to the QUDORA backend on each job submission.

solve(objective: Poly | Matrix, constraints: ConstraintList | None, dry_run: bool = False) CustomClientResultProtocol | None

Call the solver service to solve the given optimization problem.

パラメータ:
  • objective (Poly | Matrix) -- The objective function to minimize.

  • constraints (ConstraintList | None) -- Constraints for the problem. If None, no constraints are applied.

  • dry_run (bool) -- If True, validate inputs without executing circuits and return None.

戻り値:

The algorithm result, or None if dry_run is True.

戻り値の型:

CustomClientResultProtocol | None

version() str

Return the installed qudora_sdk package version.

property acceptable_degrees: AcceptableDegrees

Polynomial degrees accepted by the algorithm for the objective and constraints.

property algo: type[AlgoType]

The algorithm class used by this client.

property device: str

Name of the target QUDORA device.

property device_settings: dict | None

Device-specific settings forwarded to the QUDORA backend on each job submission.

parameters

Algorithm parameters instance. The concrete type depends on the algorithm; for QAOA this is QAOA.Parameters. Modify this to configure the algorithm before calling solve().

property qiskit_pass_manager: PassManager | EllipsisType | None

Qiskit transpilation pass manager.

... (default) generates a preset pass manager automatically; None skips transpilation.

property token: str | None

QUDORA API token used to authenticate, or None if not set.

property url: str | None

QUDORA service URL, or None to use the default endpoint.