Access

The VLQ quantum computer, is deployed as a joint collaboration between EuroHPC JU and the LUMI-Q Consortium. To serve all involved parties, the access mechanism differs from standard IT4Innovations access method. Below we provide an overview as well as particular steps to be taken.

Please use the example Jupyter notebook GHZ_example.ipynb to jumpstart execution on the VLQ machine.

Overview

Get allocation
- Allocations are handed out in QPU seconds.
- Apply for allocation to EuroHPC JU
- Apply for allocation to IT4Innovations, e-Infra CZ
- Apply for allocation to one of the LUMI-Q national Brokers
Once allocated, you will receive:
- PROJECT id (string)
- RESOURCE id (string)
Log in to https://portal.lexis.tech
- Request project access
AUP and activation
- IT4I support will contact you and request that you send in digitally signed AUP
- Send in the signed AUP
- Support will confirm your PROJECT activation
Set up python environment
Execute circuits on the VLQ machine

LUMI-Q Brokers

Country / Beneficiary	Broker Name	Broker Abbreviation	RESOURCE id
EuroHPC JU	The European High Performance Computing Joint Undertaking	EuroHPC JU	VLQ-EU
Czech Republic	IT4Innovations, VSB-TUO	IT4I	VLQ-CZ
Finland	CSC - IT Center for Science	CSC	VLQ-FI
Sweden	Chalmers University of Technology	Chalmers	VLQ-SE
Denmark	The Danish e-infrastructure Consortium	DeIC	VLQ-DK
Poland	Akademickie Centrum Komputerowe Cyfronet AGH	Cyfronet	VLQ-PL
Norway	Sigma2 AS	Sigma2	VLQ-NO
Belgium	University of Hasselt	UHasselt	VLQ-BE
Netherlands	SURF	SURF	VLQ-NL

Contact relevant Broker to get an allocation on VLQ.

portal.lexis.tech

Log in to https://portal.lexis.tech. Use your MyAccessID credentials to log in. Once logged in, navigate to Projects menu and click the Request project access button

Fill in the PROJECT id. This is a single string containing no spaces Click Request.

IT4I support will get back to you, asking for AUP and confirming the project activation.

Set Up Python Environment

The VLQ machine is accessed via python compatible API. The python environment should be installed on the machine, from where you will execute circuits on VLQ. This may be a comute node of any HPC system (LUMI, Karolina, Vega, Meluxina, etc…), or your desktop, laptop or any other computer of your choice, with adequate network connectivity.

The python environment can be complex and sensitive to a particular python version. We recommend using environment management system such as conda or venv.

With conda, follow these steps:

# create conda vlq environment
conda create --name vlq

conda activate vlq

Once the conda environment is activated, install the mandatory modules:

# install python in version 3.11
conda install python=3.11

# install py4lexis module
pip3 install --index-url https://opencode.it4i.eu/api/v4/projects/107/packages/pypi/simple py4lexis

# intall qaas module
pip3 install git+https://github.com/It4innovations/quantum-as-a-service.git@v0.2.0

We recommend to also install jupyter notebooks and vizualization modules:

# install jupyter notebooks and matplotlib module
conda install jupyter
pip3 install matplotlib

Your environment is now set up!

Execute on VLQ

The execution is in python. To execute, you need to get access token. Once the access token is obtained, it may be saved and reused. The access token, along with PROJECT id and RESOURCE id is used to get the backend python object, that can be used to submit circuits into VLQ machine.

from py4lexis.session import LexisSession
from qaas.client import QProvider, QBackend, QJob

# 1. Authentication
lexis_session = LexisSession()
token = lexis_session.get_access_token()

# 2. Configure resources
PROJECT = "PROJECT id"   # OPEN-37-1
RESOURCE = "RESOURCE id" # VLQ-CZ

# 3. Initialize QaaS
provider = QProvider(token, PROJECT)
backend:QBackend = provider.get_backend(RESOURCE)

Please use the example jupyter notebook GHZ_example.ipynb to jumpstart execution on the VLQ machine.