Skip to content

update job submit instructions #2623

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 46 commits into from
Jun 30, 2025
Merged
Show file tree
Hide file tree
Changes from 3 commits
Commits
Show all changes
46 commits
Select commit Hold shift + click to select a range
2ad820d
update job submit instructions
TheKharleeci Jun 24, 2025
c37e0b7
update technical details
TheKharleeci Jun 24, 2025
abe2e5a
update overview
TheKharleeci Jun 25, 2025
6e77040
update broken references
TheKharleeci Jun 26, 2025
5018353
Add note on q50 topology
TheKharleeci Jun 26, 2025
59db3cc
Merge branch 'master' into rewrite-quantum-docs
TheKharleeci Jun 26, 2025
ffd518c
update topology image
TheKharleeci Jun 26, 2025
a897053
Merge branch 'rewrite-quantum-docs' of https://github.com/CSCfi/csc-u…
TheKharleeci Jun 26, 2025
0218a14
update sample job scripts
TheKharleeci Jun 27, 2025
fd1ea5c
add separate tables for backends
JooNiv Jun 27, 2025
6681221
Merge branch 'rewrite-quantum-docs' of https://github.com/CSCfi/csc-u…
JooNiv Jun 27, 2025
ec9220a
table tabs for qiskit and cirq examples
JooNiv Jun 27, 2025
d50badd
Fix errors in transpile / decompose section
JooNiv Jun 27, 2025
f77e4cc
update sample scripts
TheKharleeci Jun 27, 2025
ace22e8
table tabs for batch script
JooNiv Jun 27, 2025
1226e25
table tabs for batch and python scripts
JooNiv Jun 27, 2025
195469c
wording
JooNiv Jun 27, 2025
f5f906b
typo
JooNiv Jun 27, 2025
23a71e2
table tabs for metadata
JooNiv Jun 27, 2025
3cb602c
Add q50 reference to fom, fix link
JooNiv Jun 27, 2025
5c37076
Merge branch 'rewrite-quantum-docs' of https://github.com/CSCfi/csc-u…
JooNiv Jun 27, 2025
dea8424
typo
JooNiv Jun 27, 2025
9014364
Merge branch 'master' into rewrite-quantum-docs
TheKharleeci Jun 27, 2025
17f45fc
update running jobs interactively
TheKharleeci Jun 27, 2025
305a361
Merge branch 'rewrite-quantum-docs' of https://github.com/CSCfi/csc-u…
TheKharleeci Jun 27, 2025
252481e
add redirects
TheKharleeci Jun 27, 2025
8947dd9
Merge branch 'rewrite-quantum-docs' of https://github.com/CSCfi/csc-u…
JooNiv Jun 27, 2025
11b5b0f
Update mkdocs.yml
TheKharleeci Jun 27, 2025
c50845e
Merge branch 'rewrite-quantum-docs' of github.com:CSCfi/csc-user-guid…
JooNiv Jun 27, 2025
24c5c41
Update docs/accounts/index.md
TheKharleeci Jun 27, 2025
7a307bb
Merge branch 'rewrite-quantum-docs' of github.com:CSCfi/csc-user-guid…
JooNiv Jun 27, 2025
6c2e4a9
update images
TheKharleeci Jun 27, 2025
ea7b231
Merge branch 'rewrite-quantum-docs' of https://github.com/CSCfi/csc-u…
TheKharleeci Jun 27, 2025
1e85401
update broken links
TheKharleeci Jun 27, 2025
6ada6de
fix nav structure
JooNiv Jun 27, 2025
208b3ec
update accounts links
TheKharleeci Jun 27, 2025
026b718
Merge branch 'rewrite-quantum-docs' of github.com:CSCfi/csc-user-guid…
JooNiv Jun 27, 2025
8de0e01
Merge branch 'rewrite-quantum-docs' of github.com:CSCfi/csc-user-guid…
JooNiv Jun 27, 2025
83cba41
update running-jobs
TheKharleeci Jun 27, 2025
a6880af
Merge branch 'rewrite-quantum-docs' of github.com:CSCfi/csc-user-guid…
JooNiv Jun 27, 2025
66c9264
formatting, fix images
JooNiv Jun 27, 2025
15d6f6e
formatting
JooNiv Jun 27, 2025
c4d8f2b
add kvasi redirect
TheKharleeci Jun 27, 2025
f80cb77
Merge branch 'rewrite-quantum-docs' of https://github.com/CSCfi/csc-u…
TheKharleeci Jun 27, 2025
9da33c4
update helmi topology diagram
TheKharleeci Jun 27, 2025
41fed6d
update interactive job instruction
TheKharleeci Jun 27, 2025
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
24 changes: 0 additions & 24 deletions docs/computing/quantum-computing/helmi/helmi-from-lumi.md

This file was deleted.

40 changes: 0 additions & 40 deletions docs/computing/quantum-computing/helmi/helmi-projects.md

This file was deleted.

28 changes: 0 additions & 28 deletions docs/computing/quantum-computing/kvasi/kvasi-billing.md

This file was deleted.

64 changes: 0 additions & 64 deletions docs/computing/quantum-computing/kvasi/kvasi.md

This file was deleted.

37 changes: 18 additions & 19 deletions docs/computing/quantum-computing/overview.md
Original file line number Diff line number Diff line change
Expand Up @@ -10,37 +10,36 @@ computational operators. Before QPUs can be utilized, they require tailor-made p
and algorithms. The [Finnish Quantum-Computing Infrastructure](https://fiqci.fi) FiQCI provides access to
quantum computing resources through CSC's service portals.

## Helmi
## Quantum Computers

**5 Qubit Quantum Computer**
### Helmi (VTT Q5)

Helmi, the first Finnish quantum computer, is co-developed by VTT and IQM Quantum Computers. Presently, Helmi provides 5 qubits. With Helmi, users can run quantum programs and algorithms on a real, physical device.
Helmi, the first Finnish quantum computer, is co-developed by VTT and IQM Quantum Computers. It offers a 5-qubit system, enabling users to execute quantum programs and algorithms on a physical quantum device.

Access to Helmi is provided through the LUMI supecomputer environment. Users will need to apply for a quantum computing project on LUMI, which gives access to Helmi through the LUMI job scheduler (SLURM). Applying for a project is done through [MyCSC](../../accounts/how-to-create-new-project.md).


### VTT Q50

Q50 is a 53-qubit quantum computer, also co-developed by VTT and IQM Quantum Computers.

Similar to Helmi, Q50 is accessible through the LUMI supercomputer environment. Users will need to apply for a quantum computing project on LUMI. Upon approval, Q50 can be accessed using the LUMI job scheduler (SLURM). Applying for a project is done through [MyCSC](../../accounts/how-to-create-new-project.md).


For further reading:

* [A more technical description about Helmi](./helmi/helmi-specs.md).
* [Specific instructions for the LUMI Helmi partition](./helmi/fiqci-partition.md)
* [Getting started with Helmi](./helmi/helmi-from-lumi.md)
* [A more technical description about the quantum computers](./quantum-computers/specs.md).
* [Specific instructions for the fiqci partition](./quantum-computers/fiqci-partition.md)
* [Getting started with Helmi/Q50](./quantum-computers/access.md)
* [LUMI Documentation page](https://docs.lumi-supercomputer.eu/)


## Kvasi

**The Quantum Learning Machine**
## Simulators

Kvasi is an advanced quantum computer simulator/emulator. With Kvasi, the user can explore and develop algorithms
for quantum computers. Read here [detailed instructions on how to access](../quantum-computing/kvasi/kvasi.md)
### Qiskit

Kvasi provides an ecosystem for developing and simulating quantum algorithms in both
ideal and realistic, noisy conditions. With Kvasi, you can optimize your algorithm
for a specific hardware (QPU), with specific qubit connectivity and basic gate operations.
The LUMI supercomputer now supports the simulation of quantum algorithms with up to 44 qubits using Qiskit, IBM’s open-source quantum computing framework. This capability enables researchers to explore and test large-scale quantum algorithms in preparation for quantum advantage.

The algorithms can be developed either at a level close to the hardware, using
the Atos Quantum Assembler (AQASM) language, or using a higher level, Python based
language and ready-made libraries. The QLM comes with several ready-made examples.
You can also download and run locally [myQLM](../quantum-computing/kvasi/kvasi.md#myqlm) - a light-weight version of the
QLM ecosystem.
For more details, refer to this [blog](https://fiqci.fi/publications/2025-04-01-LUMI-quantum-simulations-qiskit-aer)


20 changes: 20 additions & 0 deletions docs/computing/quantum-computing/quantum-computers/access.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,20 @@
# Setting up a LUMI project and accounts for accessing the Quantum computers

This page outlines the steps to set up a LUMI account and project for accessing the **Helmi(VTT Q5)** and **VTT Q50** quantum computers. It is assumed that you have some knowledge of supercomputing systems. If you're new, start with the [overview of CSC supercomputers](../../../computing/index.md).

To access Helmi or Q50, you must first create a LUMI project with quantum computing resources: [Quantum Projects on LUMI](projects.md).

Once the project is created, the **Principal Investigator (PI)** can invite other users: [How to add members to project](../../../accounts/how-to-add-members-to-project.md)

The project PI is responsible for ensuring that the [Terms of Use](https://a3s.fi/FiQCI/Helmi-Terms-of-Use-2022.pdf) are followed.

## Connect to LUMI

Follow the official instructions to connect to the LUMI system: [Connecting to LUMI – Official Documentation](https://docs.lumi-supercomputer.eu/firststeps/).

Details for running jobs on the quantum computers through LUMI can found in the [Running quantum jobs](running-quantum-jobs.md) page.

## Support channels

For support with access via LUMI, contact the [CSC Service Desk](../../../support/contact.md), reachable at [email protected].

Original file line number Diff line number Diff line change
@@ -1,28 +1,25 @@
# Specific instructions for the FiQCI partition on LUMI

The FiQCI partition of LUMI provides access to the Helmi quantum computer. Access is granted for users belonging to projects that have been granted QPU resources. In addition to running jobs on Helmi via LUMI, users can also use the general LUMI system and software stack including using simulators.
The FiQCI partition within LUMI provides access to quantum processing units (QPUs) for users belonging to projects with allocated QPU resources. In addition to executing quantum workloads via LUMI, users can leverage the full LUMI infrastructure, including its software stack and quantum simulators, for development, testing, and hybrid quantum-classical workflows.

!!! info "View status of Helmi"
!!! info "View status of the quantum computers"
You can check the status of the connection here: [https://fiqci.fi/status](https://fiqci.fi/status)


## LUMI Helmi projects vs. regular LUMI projects
## LUMI Quantum Computing projects vs. regular LUMI projects

Helmi projects are slightly different from standard LUMI projects. The main difference is, that you will
Quantum computing projects are slightly different from standard LUMI projects. The main difference is, that you will
need to apply for quantum resources in addition to CPU, GPU, and storage.

!!! info "Pilot Phase"
During the pilot phase, approved projects will get 24 hours of access to the FiQCI Partition.
[See the Call text for details](https://fiqci.fi/_posts/2022-11-01-Helmi-pilot/).

## The FiQCI partition `q_fiqci`

Access to Helmi is only available through the FiQCI partition on LUMI, which provides a direct connection between a [LUMI-C
Access to the quantum computers is only available through the FiQCI partition on LUMI, which provides a direct connection between a [LUMI-C
node](https://docs.lumi-supercomputer.eu/hardware/lumic/) and Helmi.

* [Further details on LUMI nodes](https://docs.lumi-supercomputer.eu/hardware/)

There is one queue in the Helmi partition corresponding to FiQCI projects: `q_fiqci`.
There is one queue in the LUMI partition corresponding to FiQCI projects: `q_fiqci`.
Currently, the maximum run time of a quantum job is 2 hours.

| Name | Max walltime | Max jobs |
Expand All @@ -41,7 +38,7 @@ Quantum computing projects work similarly to the regular LUMI system. The main d
1. FiQCI projects use the `--partition=q_fiqci` partition instead of the regular LUMI-C `--partition=standard` and `--partition=small`.
2. The maximum job walltime is **2 hours**.
3. Usage is billed as QPU seconds **QPUs** in `q_fiqci`.
4. The LUMI-Helmi computing environment has to be loaded separately. See [Running on Helmi](./running-on-helmi.md) for details.
4. The LUMI-Helmi computing environment has to be loaded separately. See [Running on Helmi](./running-quantum-jobs.md) for details.

Presently, running through the `q_fiqci` queue will consume QPU seconds for the amount of wall-time spent running in the `q_fiqci` queue.

Expand Down
Loading