How iqm-finland/sdk works
This repository is a read-only mirror of versioned IQM SDK packages, not a single deployed application. Its principal user workflow is to submit quantum circuits through a framework or Python client, have them validated and encoded for an IQM service, and retrieve job results. Other major capabilities include QAOA problem modeling and hardware-aware routing, pulse construction, and shared station-control/data models. Relationships are limited to README statements, excerpts, and SOURCE INDEX references; package paths are versioned, and unshown wiring is omitted.
Main entry points: iqm_client.py Circuit client · iqm_server_client.py Server API client · greedy_router.py Sparse greedy router · models.py Job models
Components 23
Quantum clients
- Circuit client
src/4.5.3/iqm-client/src/iqm/iqm_client/iqm_client.py - Circuit validation
src/4.5.3/iqm-client/src/iqm/iqm_client/validation.py - Circuit models
src/4.5.3/iqm-client/src/iqm/iqm_client/models.py - Cirq integration
src/4.5.3/iqm-client/src/iqm/cirq_iqm/iqm_sampler.py - Qiskit integration
src/4.5.3/iqm-client/src/iqm/qiskit_iqm/iqm_backend.py - Qrisp pass manager
src/4.6.3/iqm-client/src/iqm/qrisp_iqm/passes/default_pass_manager.py
Execution and control
- Server API client
src/4.5.3/iqm-client/src/iqm/iqm_server_client/iqm_server_client.py - Job models
src/4.5.3/iqm-client/src/iqm/iqm_server_client/models.py - IQM quantum service
- Station control client
src/4.5.3/iqm-station-control-client/src/iqm/station_control/client/station_control.py - Authentication
src/4.5.3/iqm-station-control-client/src/iqm/station_control/client/authentication.py - Pulse construction
src/4.5.3/iqm-pulse/src/iqm/pulse/builder.py
QAOA tooling
- Optimization problems
src/4.5.3/iqm-qaoa/src/iqm/applications/applications.py - QAOA circuits
src/4.5.3/iqm-qaoa/src/iqm/qaoa/circuits.py - QAOA backends
src/4.5.3/iqm-qaoa/src/iqm/qaoa/backends.py - Hardware topology
src/4.5.3/iqm-qaoa/src/iqm/qaoa/transpiler/quantum_hardware.py - Circuit routing
src/4.5.3/iqm-qaoa/src/iqm/qaoa/transpiler/routing.py - Sparse greedy router
src/4.5.3/iqm-qaoa/src/iqm/qaoa/transpiler/sparse/greedy_router.py
Shared models
- Settings and parameters
src/4.5.3/iqm-exa-common/src/exa/common/data/setting_node.py - Sweep serialization
src/4.5.3/iqm-exa-common/src/exa/common/sweep/database_serialization.py - Station-control schemas
src/4.5.3/iqm-data-definitions/protos/iqm/data_definitions/station_control/v1/task_service.proto - Observation handling
src/4.5.3/iqm-pulla/src/iqm/cpc/core/observation/observation_handler_base.py
Other components
- SDK user
Connections 13
- SDK user → Circuit client: submits circuits
src/4.5.3/iqm-client/src/iqm/iqm_client/iqm_client.py - Circuit client → Circuit validation: validates
src/4.5.3/iqm-client/src/iqm/iqm_client/iqm_client.py - Circuit client → Circuit models: builds requests
src/4.5.3/iqm-client/src/iqm/iqm_client/iqm_client.py - Circuit client → Server API client: submits jobs
src/4.5.3/iqm-client/src/iqm/iqm_client/iqm_client.py - Circuit client → Job models: uses job data
src/4.5.3/iqm-client/src/iqm/iqm_client/iqm_client.py - Server API client → Job models: uses models
src/4.5.3/iqm-client/src/iqm/iqm_server_client/iqm_server_client.py - Server API client → IQM quantum service: REST requests
src/4.5.3/iqm-client/src/iqm/iqm_server_client/iqm_server_client.py - Station control client → Authentication: authenticates
- Sparse greedy router → Hardware topology: uses topology
src/4.5.3/iqm-qaoa/src/iqm/qaoa/transpiler/sparse/greedy_router.py - Sparse greedy router → Circuit routing: uses routing
src/4.5.3/iqm-qaoa/src/iqm/qaoa/transpiler/sparse/greedy_router.py - Qrisp pass manager → IQM quantum service: targets hardware
- Sweep serialization → Settings and parameters: serializes settings
src/4.5.3/iqm-exa-common/src/exa/common/sweep/database_serialization.py - Observation handling → Settings and parameters: uses settings
src/4.5.3/iqm-pulla/src/iqm/cpc/core/observation/observation_handler_base.py