Skip to content

Matthew-Marsicano/2024_QuEra

Repository files navigation

iQuHACK 2024 - QuEra Challenge

Here you will learn all the details needed to operate QuEra resources for iQuHack 2024. See challenge.md to find out about the actual challenge.

The folder tutorial/ contains material related to the presentation of the iQuHack Friday workshop.

Check also the references/ folder for papers that may be relevant for you. If useful, the authors of the original work in which this challenge is based have also documented their code quite clearly in this GitHub repo. But beware: time for this challenge is short, so make sure to not get lost in navigating too much content!

Installing Bloqade and other packages

Bloqade, QuEra's neutral atom emulator and SDK, is going to be the key software you will operate for this challenge. Bloqade has both Julia-based and Python-based versions and we suggest focusing on the latter here.

For this event, you will need to operate it from inside qBraid's platform, but if you want to run emulations by yourself, you can easily install Bloqade locally via pip install bloqade.

Guidelines for the Julia version can also be found here. Another of QuEra's packages for graph problems that may be useful to you is Generic Tensor Networks; instructions can be found here. It is also based on Julia language.

Working on qBraid

While simulations and emulations of your program can be done locally on your computer, operation of QuEra's systems for this event will mandatorily go via qBraid (where you can also do the emulations, if you want). So here are some guidelines:

  1. To launch these materials on qBraid, first fork this repository and click the above Launch on qBraid button. It will take you to your qBraid Lab with the repository cloned.
  2. Once cloned, open terminal (first icon in the Other column in Launcher) and cd into this repo. Set the repo's remote origin using the git clone url you copied in Step 1, and then create a new branch for your team:
cd  2024_QuEra
git remote set-url origin <url>
git branch <team_name>
git checkout <team_name>
  1. Use the environment manager (ENVS tab in the right sidebar) to install environment "Bloqade Python". The installation should take ~2 min.

  2. Once the installation is complete, click Activate to add a new ipykernel for "Bloqade Python".

  3. From the FILES tab in the left sidebar, double-click on the 2024_QuEra directory and select the Bloqade Python kernel from the kernel selector.

  4. You are now ready to begin hacking and submitting jobs to Aquila! Work with your team to complete either of the challenges listed above.

For other questions or additional help using qBraid, see Lab User Guide, or reach out on Discord.

Quantum resources availability and code of conduct

To guarantee fair sharing of resources among teams, here are the guidelines for usage of QuEra's quantum computing resources during the hackaton:

  • Tasks are to be limited to 100 repetition shots.
  • Hybrid optimization jobs will not be allowed.
  • Aquila will be continuously available to participants from [time range]

Documentation

This year’s iQuHACK challenges require a write-up/documentation portion that is heavily considered during judging. The write-up is a chance for you to be creative in describing your approach and describing your process. It should clearly explain the problem, the approach you used, your implementation with results from simulation and hardware, and how you accessed the quantum hardware (total number of shots used, backends used, etc.).

Make sure to clearly link the documentation into the README.md of your own solutions folder and to include a link to the original challenge repository from the documentation!

Submission

To submit the challenge, do the following:

  1. Place all the code you wrote in one folder with your team name under the team_solutions/ folder (for example team_solutions/quantum_team).
  2. Create a new entry in team_solutions.md following the format shown that links to the folder with your solution and your documentation.
  3. Create a Pull Request from your repository to the original challenge repository
  4. Submit the "challenge submission" form

Project submission forms will automatically close on Sunday at 10am EST and won't accept late submissions.

About

QuEra iQuHACK 2024 In-Person Challenge

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published