├── .gitignore
├── LICENSE
├── README.md
├── exercises
├── .gitkeep
├── week-0
│ ├── composer01.jpg
│ ├── composer02.jpg
│ ├── composer03.jpg
│ ├── composer04.jpg
│ ├── ex_0_en.ipynb
│ ├── ex_0_ja.ipynb
│ ├── ex_0_ko.ipynb
│ ├── histogram01.jpg
│ └── histogram02.jpg
├── week-1
│ ├── ex_1a_en.ipynb
│ ├── ex_1a_ja.ipynb
│ ├── ex_1a_ko.ipynb
│ ├── ex_1b_en.ipynb
│ ├── ex_1b_ja.ipynb
│ ├── ex_1b_ko.ipynb
│ ├── grover_algorithm.png
│ ├── oracle.png
│ ├── ryoko.png
│ ├── step0.png
│ ├── step1.png
│ ├── step2.png
│ ├── unstructured_search.png
│ └── week-1
│ │ ├── ex_1a_en.ipynb
│ │ ├── ex_1a_ja.ipynb
│ │ ├── ex_1a_ko.ipynb
│ │ ├── ex_1b_en.ipynb
│ │ ├── ex_1b_ja.ipynb
│ │ ├── ex_1b_ko.ipynb
│ │ ├── grover_algorithm.png
│ │ ├── oracle.png
│ │ ├── ryoko.png
│ │ ├── step0.png
│ │ ├── step1.png
│ │ ├── step2.png
│ │ └── unstructured_search.png
├── week-2
│ ├── 4lightsout_ex.png
│ ├── 4lightsout_pr.png
│ ├── circuit_ex.png
│ ├── ex_2a_en.ipynb
│ ├── ex_2a_ja.ipynb
│ ├── ex_2a_ko.ipynb
│ ├── ex_2b_en.ipynb
│ ├── ex_2b_ja.ipynb
│ ├── ex_2b_ko.ipynb
│ ├── gatesynthesis_ex.png
│ ├── lights_out_prob.png
│ └── lights_out_rule.png
└── week-3
│ ├── asteroids_beam_example.png
│ ├── asteroids_example.png
│ ├── false_asteroids_example.png
│ ├── final_en.ipynb
│ ├── final_ja.ipynb
│ ├── final_ko.ipynb
│ └── ryoko.png
├── fig
├── ep1.png
├── ep2.png
├── ep3.png
├── ep4.png
├── ep5.png
└── ep6.png
├── hints
├── hint_1a.pdf
├── hint_1b.pdf
├── hint_2a.pdf
├── hint_2a_nb
│ ├── hint_2a_board.png
│ ├── hint_2a_circuit.jpg
│ ├── hint_2a_ex.ipynb
│ ├── hint_2a_flip_tile.png
│ └── hint_2a_flip_tile_circuit.png
├── hint_2b.pdf
├── hint_2b_nb
│ └── Search QRAM Example.ipynb
└── hint_3.pdf
├── quizzes
├── .gitkeep
├── quiz_1
│ ├── quantum_challenge_quiz_1.pdf
│ └── quantum_challenge_quiz_1.pptx
├── quiz_2
│ ├── quantum_challenge_quiz_2.pdf
│ └── quantum_challenge_quiz_2.pptx
└── quiz_3
│ ├── quantum_challenge_quiz_3.pdf
│ └── quantum_challenge_quiz_3.pptx
├── solutions
├── amatsuo.png
├── drteaching.jpg
├── leaderboard.md
├── snishio.png
├── tsatoh.png
├── week-1
│ ├── ex_1a_solutions_en.ipynb
│ ├── ex_1a_solutions_ja.ipynb
│ ├── ex_1b_solutions_en.ipynb
│ ├── ex_1b_solutions_ja.ipynb
│ └── participant solutions
│ │ └── readme.txt
├── week-2
│ ├── ex_2a_solutions_en.ipynb
│ ├── ex_2a_solutions_ja.ipynb
│ ├── ex_2b_solutions_en.ipynb
│ ├── ex_2b_solutions_ja.ipynb
│ └── participant solutions
│ │ └── readme.txt
└── week-3
│ ├── Hint_3.png
│ ├── OR_cover_edge.png
│ ├── ex_3_overview.png
│ ├── ex_3_solution_en.ipynb
│ ├── ex_3_solution_ja.ipynb
│ ├── final_circuit_1.png
│ ├── final_circuit_2.png
│ └── sample_problem_set.json
└── submissions
├── FinalSolution(Ket.G).ipynb
├── IBM_QC_5124_Pulkit_Sinha.ipynb
├── readme.txt
├── writeup_Nagayoshi.ipynb
├── writeup_adsz.ipynb
├── writeup_burgholzer.ipynb
├── writeup_hillmich.ipynb
├── writeup_jarnicki.ipynb
├── writeup_jarnicki.pdf
├── writeup_joelms.html
├── writeup_joelms.ipynb
├── writeup_klukowski.ipynb
├── writeup_tulowiecki.ipynb
└── writeup_tulowiecki.pdf
/.gitignore:
--------------------------------------------------------------------------------
1 | .DS_Store
2 |
3 | .ipynb_checkpoints/
4 |
5 | .vscode/
6 |
--------------------------------------------------------------------------------
/LICENSE:
--------------------------------------------------------------------------------
1 | Apache License
2 | Version 2.0, January 2004
3 | http://www.apache.org/licenses/
4 |
5 | TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
6 |
7 | 1. Definitions.
8 |
9 | "License" shall mean the terms and conditions for use, reproduction,
10 | and distribution as defined by Sections 1 through 9 of this document.
11 |
12 | "Licensor" shall mean the copyright owner or entity authorized by
13 | the copyright owner that is granting the License.
14 |
15 | "Legal Entity" shall mean the union of the acting entity and all
16 | other entities that control, are controlled by, or are under common
17 | control with that entity. For the purposes of this definition,
18 | "control" means (i) the power, direct or indirect, to cause the
19 | direction or management of such entity, whether by contract or
20 | otherwise, or (ii) ownership of fifty percent (50%) or more of the
21 | outstanding shares, or (iii) beneficial ownership of such entity.
22 |
23 | "You" (or "Your") shall mean an individual or Legal Entity
24 | exercising permissions granted by this License.
25 |
26 | "Source" form shall mean the preferred form for making modifications,
27 | including but not limited to software source code, documentation
28 | source, and configuration files.
29 |
30 | "Object" form shall mean any form resulting from mechanical
31 | transformation or translation of a Source form, including but
32 | not limited to compiled object code, generated documentation,
33 | and conversions to other media types.
34 |
35 | "Work" shall mean the work of authorship, whether in Source or
36 | Object form, made available under the License, as indicated by a
37 | copyright notice that is included in or attached to the work
38 | (an example is provided in the Appendix below).
39 |
40 | "Derivative Works" shall mean any work, whether in Source or Object
41 | form, that is based on (or derived from) the Work and for which the
42 | editorial revisions, annotations, elaborations, or other modifications
43 | represent, as a whole, an original work of authorship. For the purposes
44 | of this License, Derivative Works shall not include works that remain
45 | separable from, or merely link (or bind by name) to the interfaces of,
46 | the Work and Derivative Works thereof.
47 |
48 | "Contribution" shall mean any work of authorship, including
49 | the original version of the Work and any modifications or additions
50 | to that Work or Derivative Works thereof, that is intentionally
51 | submitted to Licensor for inclusion in the Work by the copyright owner
52 | or by an individual or Legal Entity authorized to submit on behalf of
53 | the copyright owner. For the purposes of this definition, "submitted"
54 | means any form of electronic, verbal, or written communication sent
55 | to the Licensor or its representatives, including but not limited to
56 | communication on electronic mailing lists, source code control systems,
57 | and issue tracking systems that are managed by, or on behalf of, the
58 | Licensor for the purpose of discussing and improving the Work, but
59 | excluding communication that is conspicuously marked or otherwise
60 | designated in writing by the copyright owner as "Not a Contribution."
61 |
62 | "Contributor" shall mean Licensor and any individual or Legal Entity
63 | on behalf of whom a Contribution has been received by Licensor and
64 | subsequently incorporated within the Work.
65 |
66 | 2. Grant of Copyright License. Subject to the terms and conditions of
67 | this License, each Contributor hereby grants to You a perpetual,
68 | worldwide, non-exclusive, no-charge, royalty-free, irrevocable
69 | copyright license to reproduce, prepare Derivative Works of,
70 | publicly display, publicly perform, sublicense, and distribute the
71 | Work and such Derivative Works in Source or Object form.
72 |
73 | 3. Grant of Patent License. Subject to the terms and conditions of
74 | this License, each Contributor hereby grants to You a perpetual,
75 | worldwide, non-exclusive, no-charge, royalty-free, irrevocable
76 | (except as stated in this section) patent license to make, have made,
77 | use, offer to sell, sell, import, and otherwise transfer the Work,
78 | where such license applies only to those patent claims licensable
79 | by such Contributor that are necessarily infringed by their
80 | Contribution(s) alone or by combination of their Contribution(s)
81 | with the Work to which such Contribution(s) was submitted. If You
82 | institute patent litigation against any entity (including a
83 | cross-claim or counterclaim in a lawsuit) alleging that the Work
84 | or a Contribution incorporated within the Work constitutes direct
85 | or contributory patent infringement, then any patent licenses
86 | granted to You under this License for that Work shall terminate
87 | as of the date such litigation is filed.
88 |
89 | 4. Redistribution. You may reproduce and distribute copies of the
90 | Work or Derivative Works thereof in any medium, with or without
91 | modifications, and in Source or Object form, provided that You
92 | meet the following conditions:
93 |
94 | (a) You must give any other recipients of the Work or
95 | Derivative Works a copy of this License; and
96 |
97 | (b) You must cause any modified files to carry prominent notices
98 | stating that You changed the files; and
99 |
100 | (c) You must retain, in the Source form of any Derivative Works
101 | that You distribute, all copyright, patent, trademark, and
102 | attribution notices from the Source form of the Work,
103 | excluding those notices that do not pertain to any part of
104 | the Derivative Works; and
105 |
106 | (d) If the Work includes a "NOTICE" text file as part of its
107 | distribution, then any Derivative Works that You distribute must
108 | include a readable copy of the attribution notices contained
109 | within such NOTICE file, excluding those notices that do not
110 | pertain to any part of the Derivative Works, in at least one
111 | of the following places: within a NOTICE text file distributed
112 | as part of the Derivative Works; within the Source form or
113 | documentation, if provided along with the Derivative Works; or,
114 | within a display generated by the Derivative Works, if and
115 | wherever such third-party notices normally appear. The contents
116 | of the NOTICE file are for informational purposes only and
117 | do not modify the License. You may add Your own attribution
118 | notices within Derivative Works that You distribute, alongside
119 | or as an addendum to the NOTICE text from the Work, provided
120 | that such additional attribution notices cannot be construed
121 | as modifying the License.
122 |
123 | You may add Your own copyright statement to Your modifications and
124 | may provide additional or different license terms and conditions
125 | for use, reproduction, or distribution of Your modifications, or
126 | for any such Derivative Works as a whole, provided Your use,
127 | reproduction, and distribution of the Work otherwise complies with
128 | the conditions stated in this License.
129 |
130 | 5. Submission of Contributions. Unless You explicitly state otherwise,
131 | any Contribution intentionally submitted for inclusion in the Work
132 | by You to the Licensor shall be under the terms and conditions of
133 | this License, without any additional terms or conditions.
134 | Notwithstanding the above, nothing herein shall supersede or modify
135 | the terms of any separate license agreement you may have executed
136 | with Licensor regarding such Contributions.
137 |
138 | 6. Trademarks. This License does not grant permission to use the trade
139 | names, trademarks, service marks, or product names of the Licensor,
140 | except as required for reasonable and customary use in describing the
141 | origin of the Work and reproducing the content of the NOTICE file.
142 |
143 | 7. Disclaimer of Warranty. Unless required by applicable law or
144 | agreed to in writing, Licensor provides the Work (and each
145 | Contributor provides its Contributions) on an "AS IS" BASIS,
146 | WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
147 | implied, including, without limitation, any warranties or conditions
148 | of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
149 | PARTICULAR PURPOSE. You are solely responsible for determining the
150 | appropriateness of using or redistributing the Work and assume any
151 | risks associated with Your exercise of permissions under this License.
152 |
153 | 8. Limitation of Liability. In no event and under no legal theory,
154 | whether in tort (including negligence), contract, or otherwise,
155 | unless required by applicable law (such as deliberate and grossly
156 | negligent acts) or agreed to in writing, shall any Contributor be
157 | liable to You for damages, including any direct, indirect, special,
158 | incidental, or consequential damages of any character arising as a
159 | result of this License or out of the use or inability to use the
160 | Work (including but not limited to damages for loss of goodwill,
161 | work stoppage, computer failure or malfunction, or any and all
162 | other commercial damages or losses), even if such Contributor
163 | has been advised of the possibility of such damages.
164 |
165 | 9. Accepting Warranty or Additional Liability. While redistributing
166 | the Work or Derivative Works thereof, You may choose to offer,
167 | and charge a fee for, acceptance of support, warranty, indemnity,
168 | or other liability obligations and/or rights consistent with this
169 | License. However, in accepting such obligations, You may act only
170 | on Your own behalf and on Your sole responsibility, not on behalf
171 | of any other Contributor, and only if You agree to indemnify,
172 | defend, and hold each Contributor harmless for any liability
173 | incurred by, or claims asserted against, such Contributor by reason
174 | of your accepting any such warranty or additional liability.
175 |
176 | END OF TERMS AND CONDITIONS
177 |
178 | APPENDIX: How to apply the Apache License to your work.
179 |
180 | To apply the Apache License to your work, attach the following
181 | boilerplate notice, with the fields enclosed by brackets "[]"
182 | replaced with your own identifying information. (Don't include
183 | the brackets!) The text should be enclosed in the appropriate
184 | comment syntax for the file format. We also recommend that a
185 | file or class name and description of purpose be included on the
186 | same "printed page" as the copyright notice for easier
187 | identification within third-party archives.
188 |
189 | Copyright [yyyy] [name of copyright owner]
190 |
191 | Licensed under the Apache License, Version 2.0 (the "License");
192 | you may not use this file except in compliance with the License.
193 | You may obtain a copy of the License at
194 |
195 | http://www.apache.org/licenses/LICENSE-2.0
196 |
197 | Unless required by applicable law or agreed to in writing, software
198 | distributed under the License is distributed on an "AS IS" BASIS,
199 | WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
200 | See the License for the specific language governing permissions and
201 | limitations under the License.
202 |
--------------------------------------------------------------------------------
/README.md:
--------------------------------------------------------------------------------
1 |
2 | # Welcome to IBM Quantum Challenge!
3 |
4 | [](https://opensource.org/licenses/Apache-2.0)
5 |
6 |
7 | [日本語はこちら](#ibm-quantum-challengeへようこそ)
8 | [한글은 여기](#ibm-quantum-challenge환영합니다)
9 |
10 | ## Thank you! We have completed this challenge on Nov 30th, 2020.
11 |
12 | ## Leaderboard
13 | The [Leaderboard](./solutions/leaderboard.md) shows the top ten scores and standings of contestants who have submitted their code to the final exercise.
14 |
15 | ## How to Solve the Final Exercise
16 | [Sample solutions](./solutions/week-3/ex_3_solution_en.ipynb): Example solution to the final exercise with honorary mentions to the top three scorers by our judges.
17 |
18 | ## Top Scorers’ Solutions
19 | [Top Scorers’ Solutions](https://github.com/qiskit-community/IBMQuantumChallenge2020/tree/main/submissions): How did the top scorers tackle this problem? Check out their unique and excellent solutions.
20 |
21 |
22 | ## The Story behind IBM Quantum Chellenge
23 | You can explore each story behind the adventure of Dr. Ryoko.
24 |
25 | |[Episode 1](https://youtu.be/eLw7fWb2xv4) |[Episode 2](https://youtu.be/f8TEd_51rHI) |[Episode 3](https://youtu.be/kLizHnvTguE)|[Episode 4](https://youtu.be/25PcR5Pn4hk) | [Episode 5](https://youtu.be/Bkk5-j6rpoM) |[Episode 6](https://youtu.be/EC2Dc1QgLZY) |
26 | | --- | --- | --- | --- | --- | --- |
27 | |  |  |  |  |  |  |
28 |
29 |
30 | ## IMPORTANT : [Final exercise submission rules](#final-exercise-submission-rules)
31 |
32 |
33 | ## Hello, quantum world.
34 |
35 | As we approach the end of 2020, we would like to engage the community with new exciting set of challenges, and further push limits of our quantum systems to achieve another yet significant milestone.
36 |
37 | Our first competitive coding contest [IBM Quantum Challenge](https://ibmquantum.angelhack.com/) was held in November 2019, attracting both seasoned coders and newbies from all over the world to start their journey in Quantum Computing.
38 | In May 2020, we celebrated our fourth anniversary of IBM Quantum Experience with another Challenge where 1,745 people from 45 countries came together to solve four problems making total use of the 18 IBM Quantum systems on the IBM Cloud exceeding 1 billion circuits a day.
39 |
40 | Starting Nov 9th at 9am JST, we present you with three weeks of new challenges that will help grow your knowledge, skills, and understanding of quantum computing and Qiskit to tackle problems using some well-known quantum algorithms.
41 |
42 | In recognition of your participation, we are awarding digital badges to those who complete all exercises.
43 |
44 | Note that participation is allowed for those who have applied and received official confirmation from the challenge organizers only.
45 |
46 | ## Programming Environment
47 | IBM Quantum Challenge will be hosted on IBM Quantum Experience (a.k.a. IQX). IQX allows you to build, execute and evaluate your quantum circuits within a self-contained Jupyter notebook environment without downloading anything to your computer.
48 |
49 | On Nov 9, 2020 when the challenge site opens, participants will see a set of exercises hosted in this self-contained Jupyter notebook environment where you can write and run your code directly from and make submissions of your answers.
50 |
51 | Please note that the challenge site with exercises hosted in this Jupyter notebook environment is only accessible by applicants who confirmed participation upon receiving a confirmation email from the event organizers.
52 |
53 | ## Preparation
54 | In many cases, you may prefer to run your code locally when working on the exercises before you make your submission in the IBM Quantum Experience environment. In such case, you will need to install **Qiskit** to your computer. Qiskit is a Python based opensource framework for working with quantum computers at the level of pulses, circuits, and algorithms. Please see the [Qiskit.org](https://qiskit.org) page for more details.
55 |
56 | Qiskit can be installed by using *pip*:
57 |
58 | ```
59 | $ pip install qiskit
60 | ```
61 |
62 | Please check out [Install Qiskit](https://qiskit.org/documentation/install.html) or [YouTube video](https://www.youtube.com/watch?v=M4EkW4VwhcI) for a step by step installaion guide.
63 |
64 | ## Challenge Index
65 | The challenge content has been shared with the public on the following dates.
66 |
67 | | Week | Challenge | Message from Dr. Ryoko | Available on (JST) |
68 | | --- | --- | --- | --- |
69 | | Week 0 |[For Beginners: The atoms of computation](exercises/week-0/ex_0_en.ipynb) | [Episode 1](https://youtu.be/eLw7fWb2xv4) |Now Live |
70 | | Week 1 |[Learning Challenge Exercise I-A](https://github.com/qiskit-community/IBMQuantumChallenge2020/blob/iqx/exercises/week-1/ex_1a_en.ipynb) [Learning Challenge Exercise I-B](https://github.com/qiskit-community/IBMQuantumChallenge2020/blob/iqx/exercises/week-1/ex_1b_en.ipynb)| [Episode 2](https://youtu.be/f8TEd_51rHI) | Nov 9th 2020 |
71 | | Week 2 |[Learning Challenge Exercise II-A](https://github.com/qiskit-community/IBMQuantumChallenge2020/blob/main/exercises/week-2/ex_2a_en.ipynb) [Learning Challenge Exercise II-B](https://github.com/qiskit-community/IBMQuantumChallenge2020/blob/main/exercises/week-2/ex_2b_en.ipynb)| [Episode 3](https://youtu.be/kLizHnvTguE), [Episode 4](https://youtu.be/25PcR5Pn4hk) | Nov 16th 2020 |
72 | | Week 3 |[Final Challenge](https://github.com/qiskit-community/IBMQuantumChallenge2020/blob/main/exercises/week-3/final_en.ipynb) | [Episode 5](https://youtu.be/Bkk5-j6rpoM), [Episode 6](https://youtu.be/EC2Dc1QgLZY) | Nov 23rd 2020 |
73 |
74 |
75 |
76 | ## Final Exercise Submission Rules
77 | For valid submissions we ask that your solution adheres to the below rule.
78 | * Please implement the quantum circuit within **28 qubits**.
79 | * Use Grover's algorithm you learned in Week1 & 2 with **iteration = 1**.
80 | * The initial state for Grover's algorithm must be equal probability distributions. For example, if you want use only 3 computational bases for 2 qubits instead of 4 as the initial state. Then, the state will be sqrt(1/3)(|00⟩+|01⟩+|11⟩).
81 | * Please note that you can get the answer with the same endian as the one used in Week2 explanation. You should map the index of the problem into four classical registers c[0:4] in binary. c[0] is the highest bit and c[3] is the lowest bit. For example, when mapping 12, the furthest left bit of 1100 will be mapped to c[0].
82 | * Make sure you **create an oracle** that **doesn't require knowledge of what the answers are**. (For example, you are not allowed to create an oracle by using a classical optimization solver to get your answers for it.)
83 | With the exception of the Unroller, which is required for decomposing your circuit to calculate quantum costs, you are not allowed to use any existing transpiler passes nor original transpilers for making simplifications in this competition.
84 | * Please **do not run jobs in succession** even if you are concerned that your job is not running properly. This can create a long queue and clog the backend. You can check whether your job is running properly at: https://quantum-computing.ibm.com/results
85 | * Your score for this exercise will be same as the cost of your QuantumCircuit. The lower the cost, the better.
86 | * Judges will check top 10 solutions manually to see if the solutions adhere to the rules. **Please note that your ranking is subject to change after the challenge period as a result of the judging process**.
87 | * Top 10 participants will be recognized and asked to submit a write up on how they solved the exercise.
88 | * **When mapping the board information into your quantum circuit, you must not change the board information from the original one. (i.e. Do not rearrange the asteroid positions, nor rotate, invert, swap rows and columns.)**
89 |
90 |
91 |
92 |
93 |
94 | --------------------------------
95 | # IBM Quantum Challengeへようこそ!
96 | ## 当コンテストは2020年11月30日に終了しました。
97 | ## 順位表
98 | [順位表](./solutions/leaderboard.md): ファイナルチャレンジのトップ10のランキング表です。
99 |
100 | ## 最終問題の解法解説
101 | [最終問題解説](./solutions/week-3/ex_3_solution_ja.ipynb):ジャッジによる最終問題の解法例です。競技者の皆さんの独創的で素晴らしい解法↓↓↓もぜひチェックしてください。
102 |
103 | ## トップ10の解法解説
104 | [トップの解法解説](https://github.com/qiskit-community/IBMQuantumChallenge2020/tree/main/submissions): トップ10にランキングした皆さんが最終問題にどう挑んだのか。アプローチ、駆使したテクニックなどを公開しています。
105 |
106 | ## 重要:[最終問題の提出ルール](#final-exercise-submission-rules)
107 |
108 |
109 | 2020年も終わりに近づいてまいりましたが、量子コンピューティングの世界の新たな挑戦にご案内したいと思います。皆さんで一緒に量子の世界の新たなマイルストーンを達成しましょう!
110 |
111 | 2019年11月に初めて開催した[IBM Quantum Challenge](https://ibmquantum.angelhack.com/)では、量子情報の専門家から初心者の方まで多くの方にご参加いただきました。[IBM Qunatum Experience](https://quantum-computing.ibm.com/)誕生から4周年を祝して開催された2020年5月のIBM Quantum Challengeでは、45ヶ国から1745人の方が参加し、期間中に、18台のIBMの量子コンピューターシステムにおいて、1日に10億回の量子回路の計算が実行されました。
112 |
113 | 11月9日午前9時(日本時間)に開催される今回のChallengeは、3週間のChallengeです。ともに、量子コンピューターの知識・スキルを深め、Exercise問題に取り組んでまいりましょう。
114 |
115 | すべてのExercisesにおいて正解を提出できた方にDigital badgeをお送りします。
116 |
117 | 応募フォーム(Application Form)を完了し、Challenge事務局から確認メール(Confirmation Required)を受領し参加確認を行った方のみ、Challengeに参加可能です。
118 |
119 |
120 | ## プログラミング環境
121 | IBM Quantum ExperienceではPythonベースのオープンソースの量子開発フレームワークである**Qiskit**を利用します。
122 |
123 | 11月9日(月)のチャレンジ開始と同時に、参加者はIQXの専用サイトから、ホスティングされているJupyter Notebook内の問題を閲覧することが可能になります。参加者は自身のコンピュータにはQiskitをインストールすることなく、同ホスティング環境にてコードを記述、実行し、回答を提出することができます。
124 |
125 | 注)当ChallengeのIQX上の専用サイトは事前登録を済ませたのち、Challenge事務局からの確認メール(Confirmation Required)にて参加確認を行った方のみアクセス可能になります。予めご了承ください。
126 |
127 |
128 | ## 事前準備
129 | Challengeで出題されるExercise問題に取り組む際、すべてをIQX上で実行する前に、コードの作成や実行をローカルで試したい方もいらっしゃるでしょう。そういう場合のために、ご自身のパソコン環境にQiskitをインストールしておくことをお勧めします。Qiskitは量子コンピューターを使うためのPythonのオープンソース フレームワークです。パルスや回路、アルゴリズムといった様々なレイヤーで活用することができます。Qiskitの詳細は[Qiskit.org](https://qiskit.org)のページを参照して下さい。
130 |
131 | Qiskitは *pip* を用いてインストールできます。
132 |
133 | ```
134 | $ pip install qiskit
135 | ```
136 | インストールの詳細な手順については[Qiskitのインストール](https://qiskit.org/documentation/locale/ja/install.html)または[インストール動画](https://www.youtube.com/watch?v=M4EkW4VwhcI)を参照してください。
137 |
138 | ## チャレンジ内容
139 | 毎週以下の日付にそれぞれのチャレンジ内容を更新します。
140 |
141 | | ウィーク | チャレンジ | Dr.リョウコからのメッセージ | 更新日 |
142 | | --- | --- | --- | --- |
143 | | Week 0 |[初心者向け:量子計算の基礎](exercises/week-0/ex_0_ja.ipynb) | [Episode 1](https://youtu.be/eLw7fWb2xv4) | 公開済み |
144 | | Week 1 |[ラーニングチャレンジ演習 I-A](https://github.com/qiskit-community/IBMQuantumChallenge2020/blob/iqx/exercises/week-1/ex_1a_ja.ipynb) [ラーニングチャレンジ演習 II-B](https://github.com/qiskit-community/IBMQuantumChallenge2020/blob/iqx/exercises/week-1/ex_1b_ja.ipynb)| [Episode 2](https://youtu.be/f8TEd_51rHI) | Nov 9th 2020 |
145 | | Week 2 |[ラーニングチャレンジ演習 II-A](https://github.com/qiskit-community/IBMQuantumChallenge2020/blob/main/exercises/week-2/ex_2a_ja.ipynb) [ラーニングチャレンジ演習 II-B](https://github.com/qiskit-community/IBMQuantumChallenge2020/blob/main/exercises/week-2/ex_2b_ja.ipynb)| [Episode 3](https://youtu.be/kLizHnvTguE), [Episode 4](https://youtu.be/25PcR5Pn4hk) | Nov 16th 2020 |
146 | | Week 3 |[ファイナルチャレンジ(本戦)](https://github.com/qiskit-community/IBMQuantumChallenge2020/blob/main/exercises/week-3/final_ja.ipynb) | [Episode 5](https://youtu.be/Bkk5-j6rpoM), [Episode 6](https://youtu.be/EC2Dc1QgLZY) | Nov 23rd 2020 |
147 |
148 |
149 | --------------------------------
150 | # ibm-quantum-challenge환영합니다!
151 | ## Thank you! We have completed this challenge on Nov 30th, 2020.
152 | ## 중요 : [최종 과제 제출 규칙](#final-exercise-submission-rules)
153 |
154 | 2020년 말이 다가오는 시점에 커뮤니티 여러분을 위해 양자 시스템의 한계를 뚫고 나아가 새로운 이정표를 달성할 수 있는 새롭고 흥미 진진한 챌린지를 준비했습니다.
155 |
156 | 2019년 11월에 처음으로 시작된 [IBM Quantum Challenge](https://ibmquantum.angelhack.com/)는 전 세계의 많은 개발자들과 입문자들을 양자컴퓨터로의 여정으로 인도했습니다. 그리고 2020년 5월, IBM Quantum Experience의 4주년을 기념하여 열린 [IBM Qunatum Experience](https://quantum-computing.ibm.com/)에서 총 45개국에서 온 1745명의 참가자들은 4개의 문제를 풀기 위해 IBM 클라우드를 통해 총 18개의 IBM Quantum systems을 사용하여, 하루 기준 10억 개의 양자 회로 연산 수행 기록을 달성했습니다.
157 |
158 | 돌아오는 11월 9일 오전 9시부터, 몇 가지의 잘 알려진 양자 알고리즘을 사용해 양자컴퓨팅과 Qiskit에 대한 지식과 기술을 높일 수 있는 과제가 준비되어 있는 3주간의 새로운 챌린지가 시작됩니다.
159 |
160 | 연습문제를 모두 성공적으로 완료한 참가자에게는 디지털 배지가 수여됩니다.
161 |
162 | 참가 신청 후 주최 측으로 부터 참가에 대한 공식 확인을 받아야 참가가 가능한 점에 유의하세요.
163 |
164 |
165 | ## 코딩 환경
166 | IBM Quantum Challenge는 IBM Quantum Experience (일명 IQX)에서 진행됩니다. IQX를 사용하는 경우 개인 컴퓨터에 라이브러리나 파일을 다운로드 하거나 설치할 필요 없이 IQX에 자체 포함 된 Jupyter 노트북 환경에서 양자 회로를 구성, 실행하고 도전 과제를 평가받을 수 있습니다.
167 |
168 | 2020 년 11 월 9 일 챌린지 사이트가 열리면 참가자는 코드를 직접 작성하고 실행하고 답변을 제출할 수있는이 독립형 Jupyter 노트북 환경에서 연습 문제를 풀고 제출하게 됩니다.
169 |
170 | 연습 문제에 도전할 수 있는 Jupyter notebook 작업 공간은 주최 측으로 부터 공식 참가 확인 이메일을 받고 참여가 확정된 참가자만이 접근 가능한 점에 꼭 유의하세요.
171 |
172 |
173 | ## 준비사항
174 | IBM Quantum Experience 환경에서 연습 문제의 정답을 제출하기 전에 개인 작업 환경(개인 노트북 및 컴퓨터의 로컬 환경)에서 미리 실습해 보고 싶을 수 있습니다. 이 경우 컴퓨터에 **Qiskit**을 설치해야합니다. Qiskit은 펄스, 회로 및 알고리즘 수준에서 양자 컴퓨터 작업을위한 Python 기반 오픈 소스 프레임 워크입니다. 자세한 내용은 [Qiskit.org](https://qiskit.org) 페이지를 참조하십시오.
175 |
176 |
177 |
178 | *pip*를 사용하여 Qiskit을 간단하게 설치할 수 있습니다.
179 |
180 | ```
181 | $ pip install qiskit
182 | ```
183 | 자세한 내용은 [Install Qiskit](https://qiskit.org/documentation/install.html)이나 [YouTube video](https://www.youtube.com/watch?v=M4EkW4VwhcI) 를 참고하세요.
184 |
185 | ## 도전 순서
186 | 도전 과제는 다음의 날짜에 공개됩니다.
187 | | Week | 도전 과제 | 료코 박사의 메시지 | Available on (KST) |
188 | | --- | --- | --- | --- |
189 | | Week 0 |[초보자 대상: 양자 컴퓨팅의 기초](exercises/week-0/ex_0_ko.ipynb) | [Episode 1](https://youtu.be/eLw7fWb2xv4) | 도전 가능 |
190 | | Week 1 |[도전 과제 I-A](exercises/week-1/ex_1a_ko.ipynb) [도전 과제 I-B](exercises/week-1/ex_1b_ko.ipynb)| [Episode 2](https://youtu.be/f8TEd_51rHI) | 도전 가능 |
191 | | Week 2 |[도전 과제 II-A](exercises/week-2/ex_2a_ko.ipynb) [도전 과제 II-B](exercises/week-2/ex_2b_ko.ipynb)| [Episode 3](https://youtu.be/kLizHnvTguE), [Episode 4](https://youtu.be/25PcR5Pn4hk) | 도전 가능 |
192 | | Week 3 |[최종 과제](exercises/week-3/final_ko.ipynb) | [Episode 5](https://youtu.be/Bkk5-j6rpoM), [Episode 6](https://youtu.be/EC2Dc1QgLZY) | 도전 가능 |
193 |
--------------------------------------------------------------------------------
/exercises/.gitkeep:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/qiskit-community/IBMQuantumChallenge2020/b96e2c1551048d3df4d925bdfb0fbbd7688f3522/exercises/.gitkeep
--------------------------------------------------------------------------------
/exercises/week-0/composer01.jpg:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/qiskit-community/IBMQuantumChallenge2020/b96e2c1551048d3df4d925bdfb0fbbd7688f3522/exercises/week-0/composer01.jpg
--------------------------------------------------------------------------------
/exercises/week-0/composer02.jpg:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/qiskit-community/IBMQuantumChallenge2020/b96e2c1551048d3df4d925bdfb0fbbd7688f3522/exercises/week-0/composer02.jpg
--------------------------------------------------------------------------------
/exercises/week-0/composer03.jpg:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/qiskit-community/IBMQuantumChallenge2020/b96e2c1551048d3df4d925bdfb0fbbd7688f3522/exercises/week-0/composer03.jpg
--------------------------------------------------------------------------------
/exercises/week-0/composer04.jpg:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/qiskit-community/IBMQuantumChallenge2020/b96e2c1551048d3df4d925bdfb0fbbd7688f3522/exercises/week-0/composer04.jpg
--------------------------------------------------------------------------------
/exercises/week-0/histogram01.jpg:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/qiskit-community/IBMQuantumChallenge2020/b96e2c1551048d3df4d925bdfb0fbbd7688f3522/exercises/week-0/histogram01.jpg
--------------------------------------------------------------------------------
/exercises/week-0/histogram02.jpg:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/qiskit-community/IBMQuantumChallenge2020/b96e2c1551048d3df4d925bdfb0fbbd7688f3522/exercises/week-0/histogram02.jpg
--------------------------------------------------------------------------------
/exercises/week-1/grover_algorithm.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/qiskit-community/IBMQuantumChallenge2020/b96e2c1551048d3df4d925bdfb0fbbd7688f3522/exercises/week-1/grover_algorithm.png
--------------------------------------------------------------------------------
/exercises/week-1/oracle.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/qiskit-community/IBMQuantumChallenge2020/b96e2c1551048d3df4d925bdfb0fbbd7688f3522/exercises/week-1/oracle.png
--------------------------------------------------------------------------------
/exercises/week-1/ryoko.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/qiskit-community/IBMQuantumChallenge2020/b96e2c1551048d3df4d925bdfb0fbbd7688f3522/exercises/week-1/ryoko.png
--------------------------------------------------------------------------------
/exercises/week-1/step0.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/qiskit-community/IBMQuantumChallenge2020/b96e2c1551048d3df4d925bdfb0fbbd7688f3522/exercises/week-1/step0.png
--------------------------------------------------------------------------------
/exercises/week-1/step1.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/qiskit-community/IBMQuantumChallenge2020/b96e2c1551048d3df4d925bdfb0fbbd7688f3522/exercises/week-1/step1.png
--------------------------------------------------------------------------------
/exercises/week-1/step2.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/qiskit-community/IBMQuantumChallenge2020/b96e2c1551048d3df4d925bdfb0fbbd7688f3522/exercises/week-1/step2.png
--------------------------------------------------------------------------------
/exercises/week-1/unstructured_search.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/qiskit-community/IBMQuantumChallenge2020/b96e2c1551048d3df4d925bdfb0fbbd7688f3522/exercises/week-1/unstructured_search.png
--------------------------------------------------------------------------------
/exercises/week-1/week-1/grover_algorithm.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/qiskit-community/IBMQuantumChallenge2020/b96e2c1551048d3df4d925bdfb0fbbd7688f3522/exercises/week-1/week-1/grover_algorithm.png
--------------------------------------------------------------------------------
/exercises/week-1/week-1/oracle.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/qiskit-community/IBMQuantumChallenge2020/b96e2c1551048d3df4d925bdfb0fbbd7688f3522/exercises/week-1/week-1/oracle.png
--------------------------------------------------------------------------------
/exercises/week-1/week-1/ryoko.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/qiskit-community/IBMQuantumChallenge2020/b96e2c1551048d3df4d925bdfb0fbbd7688f3522/exercises/week-1/week-1/ryoko.png
--------------------------------------------------------------------------------
/exercises/week-1/week-1/step0.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/qiskit-community/IBMQuantumChallenge2020/b96e2c1551048d3df4d925bdfb0fbbd7688f3522/exercises/week-1/week-1/step0.png
--------------------------------------------------------------------------------
/exercises/week-1/week-1/step1.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/qiskit-community/IBMQuantumChallenge2020/b96e2c1551048d3df4d925bdfb0fbbd7688f3522/exercises/week-1/week-1/step1.png
--------------------------------------------------------------------------------
/exercises/week-1/week-1/step2.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/qiskit-community/IBMQuantumChallenge2020/b96e2c1551048d3df4d925bdfb0fbbd7688f3522/exercises/week-1/week-1/step2.png
--------------------------------------------------------------------------------
/exercises/week-1/week-1/unstructured_search.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/qiskit-community/IBMQuantumChallenge2020/b96e2c1551048d3df4d925bdfb0fbbd7688f3522/exercises/week-1/week-1/unstructured_search.png
--------------------------------------------------------------------------------
/exercises/week-2/4lightsout_ex.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/qiskit-community/IBMQuantumChallenge2020/b96e2c1551048d3df4d925bdfb0fbbd7688f3522/exercises/week-2/4lightsout_ex.png
--------------------------------------------------------------------------------
/exercises/week-2/4lightsout_pr.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/qiskit-community/IBMQuantumChallenge2020/b96e2c1551048d3df4d925bdfb0fbbd7688f3522/exercises/week-2/4lightsout_pr.png
--------------------------------------------------------------------------------
/exercises/week-2/circuit_ex.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/qiskit-community/IBMQuantumChallenge2020/b96e2c1551048d3df4d925bdfb0fbbd7688f3522/exercises/week-2/circuit_ex.png
--------------------------------------------------------------------------------
/exercises/week-2/gatesynthesis_ex.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/qiskit-community/IBMQuantumChallenge2020/b96e2c1551048d3df4d925bdfb0fbbd7688f3522/exercises/week-2/gatesynthesis_ex.png
--------------------------------------------------------------------------------
/exercises/week-2/lights_out_prob.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/qiskit-community/IBMQuantumChallenge2020/b96e2c1551048d3df4d925bdfb0fbbd7688f3522/exercises/week-2/lights_out_prob.png
--------------------------------------------------------------------------------
/exercises/week-2/lights_out_rule.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/qiskit-community/IBMQuantumChallenge2020/b96e2c1551048d3df4d925bdfb0fbbd7688f3522/exercises/week-2/lights_out_rule.png
--------------------------------------------------------------------------------
/exercises/week-3/asteroids_beam_example.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/qiskit-community/IBMQuantumChallenge2020/b96e2c1551048d3df4d925bdfb0fbbd7688f3522/exercises/week-3/asteroids_beam_example.png
--------------------------------------------------------------------------------
/exercises/week-3/asteroids_example.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/qiskit-community/IBMQuantumChallenge2020/b96e2c1551048d3df4d925bdfb0fbbd7688f3522/exercises/week-3/asteroids_example.png
--------------------------------------------------------------------------------
/exercises/week-3/false_asteroids_example.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/qiskit-community/IBMQuantumChallenge2020/b96e2c1551048d3df4d925bdfb0fbbd7688f3522/exercises/week-3/false_asteroids_example.png
--------------------------------------------------------------------------------
/exercises/week-3/ryoko.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/qiskit-community/IBMQuantumChallenge2020/b96e2c1551048d3df4d925bdfb0fbbd7688f3522/exercises/week-3/ryoko.png
--------------------------------------------------------------------------------
/fig/ep1.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/qiskit-community/IBMQuantumChallenge2020/b96e2c1551048d3df4d925bdfb0fbbd7688f3522/fig/ep1.png
--------------------------------------------------------------------------------
/fig/ep2.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/qiskit-community/IBMQuantumChallenge2020/b96e2c1551048d3df4d925bdfb0fbbd7688f3522/fig/ep2.png
--------------------------------------------------------------------------------
/fig/ep3.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/qiskit-community/IBMQuantumChallenge2020/b96e2c1551048d3df4d925bdfb0fbbd7688f3522/fig/ep3.png
--------------------------------------------------------------------------------
/fig/ep4.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/qiskit-community/IBMQuantumChallenge2020/b96e2c1551048d3df4d925bdfb0fbbd7688f3522/fig/ep4.png
--------------------------------------------------------------------------------
/fig/ep5.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/qiskit-community/IBMQuantumChallenge2020/b96e2c1551048d3df4d925bdfb0fbbd7688f3522/fig/ep5.png
--------------------------------------------------------------------------------
/fig/ep6.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/qiskit-community/IBMQuantumChallenge2020/b96e2c1551048d3df4d925bdfb0fbbd7688f3522/fig/ep6.png
--------------------------------------------------------------------------------
/hints/hint_1a.pdf:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/qiskit-community/IBMQuantumChallenge2020/b96e2c1551048d3df4d925bdfb0fbbd7688f3522/hints/hint_1a.pdf
--------------------------------------------------------------------------------
/hints/hint_1b.pdf:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/qiskit-community/IBMQuantumChallenge2020/b96e2c1551048d3df4d925bdfb0fbbd7688f3522/hints/hint_1b.pdf
--------------------------------------------------------------------------------
/hints/hint_2a.pdf:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/qiskit-community/IBMQuantumChallenge2020/b96e2c1551048d3df4d925bdfb0fbbd7688f3522/hints/hint_2a.pdf
--------------------------------------------------------------------------------
/hints/hint_2a_nb/hint_2a_board.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/qiskit-community/IBMQuantumChallenge2020/b96e2c1551048d3df4d925bdfb0fbbd7688f3522/hints/hint_2a_nb/hint_2a_board.png
--------------------------------------------------------------------------------
/hints/hint_2a_nb/hint_2a_circuit.jpg:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/qiskit-community/IBMQuantumChallenge2020/b96e2c1551048d3df4d925bdfb0fbbd7688f3522/hints/hint_2a_nb/hint_2a_circuit.jpg
--------------------------------------------------------------------------------
/hints/hint_2a_nb/hint_2a_flip_tile.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/qiskit-community/IBMQuantumChallenge2020/b96e2c1551048d3df4d925bdfb0fbbd7688f3522/hints/hint_2a_nb/hint_2a_flip_tile.png
--------------------------------------------------------------------------------
/hints/hint_2a_nb/hint_2a_flip_tile_circuit.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/qiskit-community/IBMQuantumChallenge2020/b96e2c1551048d3df4d925bdfb0fbbd7688f3522/hints/hint_2a_nb/hint_2a_flip_tile_circuit.png
--------------------------------------------------------------------------------
/hints/hint_2b.pdf:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/qiskit-community/IBMQuantumChallenge2020/b96e2c1551048d3df4d925bdfb0fbbd7688f3522/hints/hint_2b.pdf
--------------------------------------------------------------------------------
/hints/hint_3.pdf:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/qiskit-community/IBMQuantumChallenge2020/b96e2c1551048d3df4d925bdfb0fbbd7688f3522/hints/hint_3.pdf
--------------------------------------------------------------------------------
/quizzes/.gitkeep:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/qiskit-community/IBMQuantumChallenge2020/b96e2c1551048d3df4d925bdfb0fbbd7688f3522/quizzes/.gitkeep
--------------------------------------------------------------------------------
/quizzes/quiz_1/quantum_challenge_quiz_1.pdf:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/qiskit-community/IBMQuantumChallenge2020/b96e2c1551048d3df4d925bdfb0fbbd7688f3522/quizzes/quiz_1/quantum_challenge_quiz_1.pdf
--------------------------------------------------------------------------------
/quizzes/quiz_1/quantum_challenge_quiz_1.pptx:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/qiskit-community/IBMQuantumChallenge2020/b96e2c1551048d3df4d925bdfb0fbbd7688f3522/quizzes/quiz_1/quantum_challenge_quiz_1.pptx
--------------------------------------------------------------------------------
/quizzes/quiz_2/quantum_challenge_quiz_2.pdf:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/qiskit-community/IBMQuantumChallenge2020/b96e2c1551048d3df4d925bdfb0fbbd7688f3522/quizzes/quiz_2/quantum_challenge_quiz_2.pdf
--------------------------------------------------------------------------------
/quizzes/quiz_2/quantum_challenge_quiz_2.pptx:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/qiskit-community/IBMQuantumChallenge2020/b96e2c1551048d3df4d925bdfb0fbbd7688f3522/quizzes/quiz_2/quantum_challenge_quiz_2.pptx
--------------------------------------------------------------------------------
/quizzes/quiz_3/quantum_challenge_quiz_3.pdf:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/qiskit-community/IBMQuantumChallenge2020/b96e2c1551048d3df4d925bdfb0fbbd7688f3522/quizzes/quiz_3/quantum_challenge_quiz_3.pdf
--------------------------------------------------------------------------------
/quizzes/quiz_3/quantum_challenge_quiz_3.pptx:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/qiskit-community/IBMQuantumChallenge2020/b96e2c1551048d3df4d925bdfb0fbbd7688f3522/quizzes/quiz_3/quantum_challenge_quiz_3.pptx
--------------------------------------------------------------------------------
/solutions/amatsuo.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/qiskit-community/IBMQuantumChallenge2020/b96e2c1551048d3df4d925bdfb0fbbd7688f3522/solutions/amatsuo.png
--------------------------------------------------------------------------------
/solutions/drteaching.jpg:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/qiskit-community/IBMQuantumChallenge2020/b96e2c1551048d3df4d925bdfb0fbbd7688f3522/solutions/drteaching.jpg
--------------------------------------------------------------------------------
/solutions/leaderboard.md:
--------------------------------------------------------------------------------
1 | # Final Exercise Leaderboard
2 |
3 | ## Congratulations to the winners and top scorers!
4 |
5 | Thank you to everyone who submitted their code to the final challenge!
6 | The following shows the top ten scorers who submitted their code to the final challenge (Nov 30, 2020 13:00 JST)
7 |
8 |
9 | ### Top Ten Scorers
10 | *(Note: All top scorers submissions have been verified by judges and scores are finalized. Their decision will be final and no further discussions will be held.)*
11 |
12 | | Ranking | Name | Score |
13 | | --- | --- | --- |
14 | | 1 | Hironari Nagayoshi | 4004 |
15 | | 2 | Adam Szady | 4819 |
16 | | 3 | Pulkit Sinha | 5124 | --- |
17 | | 4 | Witold Jarnicki | 6065 | --- |
18 | | 5 | Lukas Burgholzer | 6552 | --- |
19 | | 6 | Jan Tulowiecki | 6574 | --- |
20 | | 7 | Guillermo Alonso | 7799 | --- |
21 | | 8 | Stefan Hillmich | 8188 | --- |
22 | | 9 | Joel Sunil | 8864 | --- |
23 | | 10 | Chris Chen | 9127 | --- |
24 |
25 | ## Judges
26 | The following members served as judges for the challenge. They were the core members who created the exercises for our IBM Quantum Challenge Fall 2020.
27 |
28 | 
29 | **Dr. Takahiko Satoh**
30 | **Project Assistant Professor, Keio Quantum Computing Center**
31 |
32 | 
33 | **Shin Nishio**
34 | **Research Assistant, National Institute of Informatics/SOKENDAI**
35 |
36 | 
37 | **Atsushi Matsuo**
38 | **Researcher, IBM Quantum**
39 |
40 |
41 | ## How we determined the score
42 | Scores were determined by measuring the circuit implementation cost to solve the final exercise.
43 | Cost is defined as: Cost = *S* + 10*C* where *S* is the number of single-qubit gates and *C* is the number of CNOT (CX) gates. Any given quantum circuit can be decomposed into single-qubit gates and two-qubit gates. With the current Noisy Intermediate-Scale Quantum (NISQ) devices, CNOT error rates are generally ten times higher than a single qubit gate.Therefore, we weigh CNOT gates ten times more than a single-qubit gate for evaluating the circuit implementation cost.
44 | The lower the cost, the better.
45 |
46 |
47 | --------------------------------
48 | # Participants who completed the final exercise
49 |
50 | ## Congratulations to all who completed the final exercise!
51 |
52 | *(Listed in alphabetical order)*
53 | Kusal Mahendra Abeywickrama,
54 | Mitesh Adake,
55 | Chulwoo Ahn,
56 | Riccardo Aiudi,
57 | Ibrahim Almosallam,
58 | Guillermo Alonso,
59 | Md Sajid Anis,
60 | Riya Arora,
61 | Kaito Asai,
62 | Hiroki Asakawa,
63 | Mostafa Atallah,
64 | Diego Athayde Monteiro,
65 | Bao Bach,
66 | Vishal Bajpe,
67 | Armando Bellante,
68 | Juan Bernardo Benavides Rubio,
69 | Naphan Benchasattabuse,
70 | Amandeep Bhatia,
71 | Gary Bilkus,
72 | Subhadeep Biswas,
73 | Sorin Bolos,
74 | Luigi Bonati,
75 | Aditya Bothra,
76 | Sebastian Brandhofer,
77 | Lukas Burgholzer,
78 | Fabiola Cañete Leyva,
79 | Ivan Carvalho,
80 | Carlo Cascio,
81 | Mantas Cepulkovskis,
82 | Sanivarapu Sarath Chandra Reddy,
83 | Adarsh Chandrashekar,
84 | Chris (Jielun) Chen,
85 | Man Hin Cheng,
86 | Manav Chhibber,
87 | Wei-Chen Chien,
88 | Yujin Cho,
89 | Peter Cogill,
90 | Adrian Copetudo Espinosa,
91 | Franklin de Lima Marquezino,
92 | Pascal Debus,
93 | Indranil Dey,
94 | Sagar Dollin,
95 | Patrick Downing,
96 | Nico Einsidler,
97 | Paul Faehrmann,
98 | Fabrizio Finozzi,
99 | Khurshed Fitter,
100 | Aboulkhair Foda,
101 | Guillermo Andrés Fonseca Kuvacic,
102 | Pablo Formoso Estrada,
103 | Shion Fukuzawa,
104 | Sri Ram Kailash G,
105 | Subrahmanyam Gantasala,
106 | Tanya Garg,
107 | Bahman Ghandchi,
108 | Elies Gil-Fuster,
109 | Bhaavan Goel,
110 | Wittmann Goh,
111 | Dhruv Gopalakrishnan,
112 | Nancy Goyal,
113 | Saumya Goyal,
114 | Anne-Lise Guilmin,
115 | Manvi Gusain,
116 | Moritz Gutt,
117 | Ramy Harib,
118 | Ruofan He,
119 | Stefan Hillmich,
120 | Marcel Hinsche,
121 | Tom Holden-Dye,
122 | Calum Holker,
123 | Meng Hua,
124 | Shadab Hussain,
125 | Yuki Ito,
126 | Dustin Jacqmin,
127 | Ammar Jahin,
128 | Vipul Jain,
129 | Vaibhav Jain,
130 | Babita Jajodia,
131 | Witold Jarnicki,
132 | Praveen Jayakumar,
133 | Siyu Jian,
134 | Kiran Johns,
135 | Saasha Joshi,
136 | Akshay Kale,
137 | Sumit Suresh Kale,
138 | Sampreet Kalita,
139 | Shruti Kalkar,
140 | Eyal Kalman,
141 | Yusuke Kanamori,
142 | Marius Kavaliauskas,
143 | Akito Kawasaki,
144 | Josh Kelso,
145 | Nikhil Keshav,
146 | Ufuk Keskin,
147 | Dongsin Kim,
148 | Gyeonghun Kim,
149 | Hoyoung Kim,
150 | Saesun Kim,
151 | Hiraku Koduma,
152 | Yuki Koizumi,
153 | Eileen Kuehn,
154 | Hideto Kumakura,
155 | Jitesh Lalwani,
156 | Denisa Lampášová,
157 | Samantha Lang,
158 | Elbert Timothy Lasiman,
159 | I-KWAN Lee,
160 | Xinwei Lee,
161 | Polina Levyant,
162 | Tai Yue Li,
163 | Zhengze Li,
164 | Billy Lim Jun Ming,
165 | Deep Lokhande,
166 | Shufan Lu,
167 | Taoyuze Lv,
168 | Chien-Kai Ma,
169 | Onkar Madli,
170 | Danyal Maheshwari,
171 | Ritajit Majumdar,
172 | Jyot Makadiya,
173 | Alberto Maldonado Romo,
174 | Andres Camilo Marulanda Bran,
175 | Sergi Masot Llima,
176 | Alena Mastiukova,
177 | Anuj Mehrotra,
178 | Kou Misaki,
179 | Abhigyan Mishra,
180 | Abhijit Mitra,
181 | Naoki Mitsui,
182 | Shah Mohtashim,
183 | Sukrut Mondkar,
184 | Masato Mouri,
185 | Tristan Müller,
186 | Eraraya Ricardo Muten,
187 | Keerthiraj Nagaraj,
188 | Hironari Nagayoshi,
189 | Soshun Naito,
190 | Yuya Nakagawa,
191 | Yudai Nakakubo,
192 | Shota Nakasuji,
193 | Rafael Nepomechie,
194 | Ana Nikolic,
195 | Keith O'Donnell,
196 | Ryunosuke Okubo,
197 | Kosuke Onishi,
198 | Tamiya Onodera,
199 | Renganathan Palanisamy,
200 | Joachim Paret,
201 | Eunju Park,
202 | Carlos Pegueros,
203 | Huba Péter,
204 | Dario Petrillo,
205 | Kamen Petroff,
206 | Jakub Pilch,
207 | Krishanu Podder,
208 | Rohit Prasad,
209 | Florian Preis,
210 | Ziwei Qiu,
211 | Mohammed Aamir Qudsi,
212 | Khushwanth Kumar Ragam,
213 | Suryaprasath Ramalingam,
214 | Ricardo Ramirez,
215 | Kenyi Josué Ramírez Palacios,
216 | Chang Ran-Yu,
217 | Michael Rollin,
218 | Gonzalo Rubio Martínez,
219 | Lewis Ruks,
220 | Hyunwoo Ryu,
221 | Nahum Sá,
222 | Saptarshi Sahoo,
223 | Najla Said,
224 | Freddie Samy,
225 | Hirmay Sandesara,
226 | Radha Pyari Sandhir,
227 | Andy Saporito,
228 | Hayk Sargsyan,
229 | Md. Sakibul Islam Sazzad,
230 | John Schneider,
231 | Pinaki Sen,
232 | Jayath Seneviratne,
233 | Diego Emilio Serrano,
234 | Vadim Shabashov,
235 | Farida Shagieva,
236 | Soyoung Shin,
237 | Shashwat Shukla,
238 | Daniel Sierra-Sosa,
239 | Divyanshu Singh,
240 | Prakhar Singh,
241 | Rishabh Singhal,
242 | Pulkit Sinha,
243 | Satzhan Sitmukhambetov,
244 | Kouhei Souji,
245 | Adrien Suau,
246 | Gary Sung,
247 | Jirayu Supasil,
248 | Adam Szady,
249 | Muhammed Jabir T,
250 | Shokichi Takakura,
251 | Nobuhiko Tamura,
252 | Ritu Thombre,
253 | Miroslav Tomasik,
254 | Andrei Voicu Tomut,
255 | Tony Tong,
256 | Duc Tran,
257 | Georgios Tsilimigkounakis,
258 | Satoyuki Tsukano,
259 | Jan Tułowiecki,
260 | Hironori Uchikawa,
261 | Arthi Udayakumar,
262 | Abhirami V S,
263 | Natan Vander Meeren,
264 | Chetan Vardhan,
265 | Sanjay Vishwakarma,
266 | Alexander Vlasov,
267 | Ryo Wakizaka,
268 | Joshua Wang,
269 | Anosh Wasker,
270 | Ming-Tso Wei,
271 | Christof Wendenius,
272 | Weichen Xie,
273 | Hiroyuki Yamada,
274 | Yuya Yoshimura,
275 | Zhenhua Zhang,
276 | Zhiyong Zhang
277 |
278 | 
--------------------------------------------------------------------------------
/solutions/snishio.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/qiskit-community/IBMQuantumChallenge2020/b96e2c1551048d3df4d925bdfb0fbbd7688f3522/solutions/snishio.png
--------------------------------------------------------------------------------
/solutions/tsatoh.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/qiskit-community/IBMQuantumChallenge2020/b96e2c1551048d3df4d925bdfb0fbbd7688f3522/solutions/tsatoh.png
--------------------------------------------------------------------------------
/solutions/week-1/ex_1b_solutions_en.ipynb:
--------------------------------------------------------------------------------
1 | {
2 | "cells": [
3 | {
4 | "cell_type": "markdown",
5 | "metadata": {},
6 | "source": [
7 | "# Learning Exercise I-B\n",
8 | "Find the number of iterations with the largest amplitude when you run the Grover's algorithm with one solution in a database with $N = 2 ^ 7$. As shown above, change the number of iterations and check the amplification. The answer must be an integer.\n",
9 | "\n",
10 | "Hint: Fewer than 15 times. "
11 | ]
12 | },
13 | {
14 | "cell_type": "markdown",
15 | "metadata": {},
16 | "source": [
17 | "## Answer \n",
18 | "As explained in hint by Ryoko, the optimal number of times can be calculated using the following formula.\n",
19 | "$$t = \\frac{\\pi}{4}\\sqrt{N}-\\frac{1}{2}$$\n",
20 | "\n",
21 | "Let's find the optimum number of iterations (approximate) when N is up to $2^{16}$."
22 | ]
23 | },
24 | {
25 | "cell_type": "code",
26 | "execution_count": 1,
27 | "metadata": {},
28 | "outputs": [
29 | {
30 | "name": "stdout",
31 | "output_type": "stream",
32 | "text": [
33 | "['N:1', 'Number of iteration:0.2853981633974483']\n",
34 | "['N:2', 'Number of iteration:0.6107207345395915']\n",
35 | "['N:4', 'Number of iteration:1.0707963267948966']\n",
36 | "['N:8', 'Number of iteration:1.721441469079183']\n",
37 | "['N:16', 'Number of iteration:2.641592653589793']\n",
38 | "['N:32', 'Number of iteration:3.942882938158366']\n",
39 | "['N:64', 'Number of iteration:5.783185307179586']\n",
40 | "['N:128', 'Number of iteration:8.385765876316732']\n",
41 | "['N:256', 'Number of iteration:12.066370614359172']\n",
42 | "['N:512', 'Number of iteration:17.271531752633464']\n",
43 | "['N:1024', 'Number of iteration:24.632741228718345']\n",
44 | "['N:2048', 'Number of iteration:35.04306350526693']\n",
45 | "['N:4096', 'Number of iteration:49.76548245743669']\n",
46 | "['N:8192', 'Number of iteration:70.58612701053386']\n",
47 | "['N:16384', 'Number of iteration:100.03096491487338']\n",
48 | "['N:32768', 'Number of iteration:141.67225402106772']\n"
49 | ]
50 | }
51 | ],
52 | "source": [
53 | "# Number of iteration \n",
54 | "import math\n",
55 | "import numpy as np\n",
56 | "def num_iter(n):\n",
57 | " res = ((np.pi/4) * (math.sqrt(n))) - (1/2)\n",
58 | " iter_list = ['N:'+str(n), 'Number of iteration:'+ str(res)]\n",
59 | " return iter_list\n",
60 | "\n",
61 | "for i in range(16):\n",
62 | " n = 2**i\n",
63 | " print(num_iter(n))"
64 | ]
65 | },
66 | {
67 | "cell_type": "markdown",
68 | "metadata": {},
69 | "source": [
70 | "We got 8.39. It's about 8.\n",
71 | "\n",
72 | "Let's generate a quantum circuit and check the actual amplification. Generate a circuit to search for 47 (use any number up to $2^7$-1) from $2^7$."
73 | ]
74 | },
75 | {
76 | "cell_type": "code",
77 | "execution_count": 2,
78 | "metadata": {},
79 | "outputs": [],
80 | "source": [
81 | "# importing Qiskit\n",
82 | "from qiskit import Aer\n",
83 | "from qiskit import QuantumCircuit, ClassicalRegister, QuantumRegister, execute\n",
84 | "from qiskit.providers.aer import QasmSimulator\n",
85 | "\n",
86 | "backend = Aer.get_backend('qasm_simulator')\n",
87 | "prob_of_ans = []\n",
88 | "\n",
89 | "for x in range(15):\n",
90 | " database = QuantumRegister(7)\n",
91 | " oracle = QuantumRegister(1)\n",
92 | " ancilla = QuantumRegister(5) \n",
93 | " cr = ClassicalRegister(7)\n",
94 | " qc = QuantumCircuit(database, oracle, ancilla, cr)\n",
95 | " qc.h(database[:])\n",
96 | " qc.x(oracle[0])\n",
97 | " qc.h(oracle[0])\n",
98 | "\n",
99 | "\n",
100 | " for j in range(x):\n",
101 | " # oracle_7q\n",
102 | " # search 47: 0101111\n",
103 | " qc.x(database[0])\n",
104 | " qc.x(database[2])\n",
105 | " qc.mct(database[:], oracle[0], ancilla[:], mode='basic') \n",
106 | " qc.x(database[0])\n",
107 | " qc.x(database[2])\n",
108 | "\n",
109 | " # diffusion_7q\n",
110 | " qc.h(database[:])\n",
111 | " qc.x(database[:])\n",
112 | " qc.h(database[6])\n",
113 | " qc.mct(database[0:6], database[6], ancilla[:], mode='basic')\n",
114 | " qc.h(database[6])\n",
115 | " qc.x(database[:])\n",
116 | " qc.h(database[:])\n",
117 | "\n",
118 | "\n",
119 | " qc.h(oracle[0])\n",
120 | " qc.x(oracle[0])\n",
121 | " qc.measure(database,cr)\n",
122 | " # Change the endian \n",
123 | " qc = qc.reverse_bits() \n",
124 | "\n",
125 | " job = execute(qc, backend=backend, shots=1000, backend_options={\"fusion_enable\":True})\n",
126 | " result = job.result()\n",
127 | " count = result.get_counts()\n",
128 | " answer = count['0101111']\n",
129 | " prob_of_ans.append(answer)"
130 | ]
131 | },
132 | {
133 | "cell_type": "code",
134 | "execution_count": 3,
135 | "metadata": {},
136 | "outputs": [
137 | {
138 | "data": {
139 | "text/plain": [
140 | "Text(0, 0.5, '# of times the solution was obtained')"
141 | ]
142 | },
143 | "execution_count": 3,
144 | "metadata": {},
145 | "output_type": "execute_result"
146 | },
147 | {
148 | "data": {
149 | "image/png": "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\n",
150 | "text/plain": [
151 | "