qraise

Raise one or more vQPUs with a well defined configuration.

The qraise command is used to deploy a set of virtual QPUs with a given configuration, including computational resources, backend selection, and communication capabilities. The raised vQPUs can subsequently be used to execute quantum circuits within the CUNQA framework.

Synopsis

qraise [OPTIONS]

Options

General deployment options

-n, --num-qpus <int>

Mandatory. Number of QPUs to be raised.

-t, --time <string>

Mandatory. Time during which the QPUs will remain active.

-c, --cores-per-qpu <int>

Number of CPU cores assigned to each QPU. Default: 2

-p, --partition <string>

Partition requested for the QPUs.

--mem, --mem-per-qpu <int>

Amount of memory (in GB) assigned to each QPU. Default: 15

-N, --n-nodes <int>

Number of compute nodes used to deploy the QPUs. Default: 1

--nodelist <string>

List of nodes where the QPUs will be deployed. Multiple nodes can be specified at a time.

--qpuN, --qpus-per-node <int>

Number of QPUs deployed on each node.

Backend and simulation options

-b, --backend <string>

Path to the backend configuration file.

--sim, --simulator <string>

Selects simulator responsible for running the simulations. Default: Aer

Grouping and communication options

--family <string>

Name used to identify the group of QPUs that were raised together. Default: default

--co-located

Enable co-located mode. If set, the vQPU can be accesed from any node. Otherwise, the user can only access it from the node it is deployed on.

--classical_comm

Enable classical communications between QPUs.

--quantum_comm

Enable quantum communications between QPUs.

GPU execution

--gpu

Enable GPU execution. The quantum simulation will be performed on GPU.

--gpu-name <string>

Name (type) of the GPU to request for the execution (e.g. a100, t4). Default: default

Real QPU

--qmio

Deploys the real quantum computer QMIO located at CESGA’s installations, allowing hybrid DQC infrastructures.

Basic usage

Command that deploys 2 vQPUs with classical communications, for 10 minutes and accessible from any node:

qraise -n 2 -t 00:10:00 --classical_comm --co-located

Notes

  • Some options are backend- or simulator-specific and may not be supported in all execution environments.

  • Invalid or incompatible combinations of options may result in an error at deployment time.