iQuHACK 2023 - QuEra Challenge

See state_prep.md for details on state preparation, followed by challenge.md to find out more about the actual challenge.

The folders slides/ and tutorial/ contain materials similar to the ones used during the QuEra challenge workshop.

Working on qBraid

1. If you're working 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  2023_QuEra
git remote set-url origin <url>
git branch <team_name>
git checkout <team_name>

3. Use the environment manager (ENVS tab in the right sidebar) to install environment "Amazon Braket". The installation should take ~2 min.
4. Once the installation is complete, click Activate to add a new ipykernel for "Amazon Braket".
5. From the FILES tab in the left sidebar, double-click on the 2023_QuEra directory.
6. You are now ready to begin hacking! 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.

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 can be in the form of a blog post, a short YouTube video or any form of social media. 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 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.