QuantumKatas
velopment Kit 0.5
우리는 Quantum Katas 경험을 현대화하고 있습니다. Azure Quantum의 Copilot의 통합 지원으로 https://quantum.microsoft.com/experience/quantum-katas를 방문하십시오.
최신 QDK 저장소는 Microsoft/Qsharp를 방문하십시오.
최신 QDK 및 Azure Quantum에 대한 자세한 내용은 https://aka.ms/aq/documentation을 방문하십시오.
Quantum Katas는 자체 진행중인 자습서 및 프로그래밍 연습 모음으로 Quantum Computing 및 Q# 프로그래밍을 배우는 데 도움이됩니다.
각 Kata는 다음과 같은 별도의 연습 세트입니다.
Quantum Katas에는 필요한 수학 (복소수 및 선형 대수)부터 시작하여 Quantum Computing에 사용되는 기본 개념 및 알고리즘을 학습자에게 소개하는 자습서 도 포함되어 있습니다. 그들은 Q# 데모 및 실습 프로그래밍 연습으로 이론을 보충하는 것과 동일한 패턴을 따릅니다.
양자 컴퓨팅 및 양자 프로그래밍을 배우기 시작하면 따라야하는 학습 경로는 다음과 같습니다. 기본 사항에 익숙해지면 관심을 끌 수있는 주제로 넘어갈 수 있습니다!
Q# 프로그래밍 언어 빠른 참조 시트는 Q# 언어 빠른 참조를 참조하십시오.
Quantum Katas는 이제 Jupyter Notebooks Online으로 제공됩니다! 모든 katas 및 튜토리얼 목록은 index.ipynb를 참조하고 온라인으로 실행하기위한 지침을 참조하십시오.
mybinder.org는 용량이 감소하여 실행 중이므로 가상 머신을 얻고 노트북을 시작하는 데 몇 가지 시도가 필요할 수 있습니다. Katas Online을 실행하는 것이 시작하기 가장 쉬운 옵션이지만 진행 상황을 저장하고 더 나은 성능을 즐기려면 로컬 설정 옵션을 선택하는 것이 좋습니다.
Quantum Katas를 로컬로 사용하려면 Windows 10, MacOS 및 Linux에서 사용할 수있는 Quantum Development Kit가 필요합니다. Quantum Development 키트가 아직 설치되지 않은 경우 Quantum Development Kit의 설치 안내서를 참조하십시오.
Katas와 튜토리얼을 로컬로 Jupyter 노트북으로 실행하려면 :
pytest 패키지가 필요합니다.matplotlib 패키지가 필요합니다.matplotlib 및 numpy 패키지가 필요합니다.IQ# 커널을 월간 QDK 릴리스와 함께 새 버전으로 업데이트하려면 IQ# 커널 업데이트를 참조하십시오.
Q# 프로젝트로 Katas 및 Tutorials를 로컬로 실행하려면 :
Visual Studio, Visual Studio Code 또는 기타 편집자의 QDK 설치 안내서의 단계를 따르십시오.
Katas의 Q# 프로젝트를 로컬로 운영하려면 .NET 6.0 SDK를 다운로드하고 설치해야합니다. 여러 버전이 나란히 지원되므로 다른 .NET 버전이 설치되어 있어도이 작업을 수행 할 수 있습니다.
Visual Studio 2019는 .NET 6.0 프로젝트를 지원하지 않으므로 Visual Studio 2022로 업그레이드하고 해당 Microsoft Quantum Development Kit 확장을 설치해야합니다.
Git을 설치 한 경우 Microsoft/Quantumkatas 저장소를 복제하십시오.
$ git clone https://github.com/Microsoft/QuantumKatas.git팁
Visual Studio 2022와 Visual Studio Code는 개발 환경 내에서 저장소를 쉽게 복제 할 수 있도록합니다. 자세한 내용은 Visual Studio 및 Visual Studio Code 설명서를 참조하십시오.
git을 설치하지 않은 경우 https://github.com/microsoft/quantumkatas/archive/main.zip에서 katas를 다운로드하십시오.
Jupyter Notebooks로 Katas를 실행하는 가장 좋은 방법은 저장소의 루트 폴더로 이동하고 Jupyter를 사용하여 index.ipynb 열는 것입니다.
$ cd QuantumKatas/
$ jupyter notebook index.ipynb이렇게하면 모든 katas 및 튜토리얼 목록이 포함 된 노트북이 열리고 링크를 사용하려는 링크로 이동할 수 있습니다.
참고 : 이것은 명령을 실행하는 데 사용한 것과 동일한 명령 줄 창에서 Jupyter Notebooks 서버를 시작합니다. 내비게이션을 위해 해당 창을 계속 사용하려면 다음 명령을 사용하여 새 창에서 Jupyter Notebooks 서버를 시작할 수 있습니다.
Windows :
$ cd QuantumKatas/ $ start jupyter notebook index.ipynb우분투를 위해 :
$ cd QuantumKatas/ $ gnome-terminal -- start jupyter notebook index.ipynb
개별 노트북을 직접 열 수 있지만 내부 링크를 유효하게 만들 수 있습니다.
$ cd QuantumKatas/tutorials/ComplexArithmetic
$ jupyter notebook ComplexArithmetic.ipynb각 Kata는 자체 포함 Q# 프로젝트, 솔루션 및 Jupyter 노트북 트리플렛으로 자체 디렉토리에 있습니다. 예를 들어 Basicgates 디렉토리 구조는 다음과 같습니다.
QuantumKatas/
BasicGates/
README.md # Instructions specific to this kata.
.vscode/ # Metadata used by Visual Studio Code.
BasicGates.sln # Visual Studio solution file.
BasicGates.csproj # Project file used to build both classical and quantum code.
BasicGates.ipynb # Jupyter Notebook front-end for this kata.
Workbook_BasicGates.ipynb # Jupyter Notebook workbook for this kata.
Tasks.qs # Q# source code that you will fill as you solve each task.
Tests.qs # Q# tests that verify your solutions.
ReferenceImplementation.qs # Q# source code containing solutions to the tasks.Visual Studio 2022에서 Basic Gates Kata를 열려면 Quantumkatas/Basicgates/Basicgates.sln 솔루션 파일을 엽니 다.
Visual Studio Code에서 Basic Gates Kata를 열려면 Quantumkatas/ Basic Gates/ 폴더를 엽니 다. Ctrl + Shift + P (또는 MacOS의 ⌘ + shift + P )를 눌러 명령 팔레트를 엽니 다. Windows 10 또는 Linux에서 열린 폴더를 입력하거나 MacOS에서 열립니다 .
팁
Visual Studio Code에서 사용 가능한 거의 모든 명령은 명령 팔레트에 있습니다. 고정되면 Ctrl + Shift + P (또는 MacOS의 ⌘ + shift + P )를 누르고 입력을 시작하여 사용 가능한 모든 명령을 검색하십시오.명령 줄에서 Visual Studio 코드를 시작할 수도 있습니다.
$ code QuantumKatas/BasicGates/
Kata가 열리면 다음 지침을 사용하여 테스트를 실행할 차례입니다. 처음에는 모든 테스트가 실패합니다. 당황하지 말 것! tasks.qs를 열고 코드를 작성하여 작업을 완료하십시오. 각 작업에는 단위 테스트가 포함됩니다. 작업에 대한 올바른 코드를 작성하면 프로젝트를 재건하고 테스트를 다시 실행하면 해당 단위 테스트가 통과됩니다.
cd 명령을 사용하여 Kata의 *.csproj 파일을 포함하는 폴더로 이동하십시오.dotnet test 실행하십시오. 이것은 Kata 프로젝트를 구축하고 모든 단위 테스트를 실행해야합니다. 모든 단위 테스트는 실패해야합니다.dotnet test 에서 작업의 코드 변경 사항을 테스트합니다.편의를 위해 Tasks.json 구성 파일이 각 Kata에 대해 존재합니다. Visual Studio 코드가 명령 팔레트에서 빌드 및 테스트 단계를 실행할 수 있습니다. Ctrl + Shift + P (또는 MacOS의 ⌘ + shift + P )를 눌러 팔레트를 열고 실행 빌드 작업을 유형하거나 테스트 작업을 실행 하고 Enter를 누릅니다.
포함 된 dockerfile을 사용하여 명령 줄이나 Jupyter에서 Katas를 실행하는 데 필요한 모든 도구가 포함 된 Docker 이미지를 만들 수 있습니다.
katas 를 태그하십시오. docker build -t katas .katas-container 라는 컨테이너에서 대화식 명령 줄 및 리디렉션 컨테이너 포트 8888 (Jupyter를 실행하는 데 필요한) 8888 이미지를 실행하십시오. docker run -it --name katas-container -p 8888:8888 katas /bin/bash cd ~ /BasicGates/
dotnet test cd ~ /BasicGates/ && jupyter notebook --ip=0.0.0.0 --no-browser http://localhost:8888/notebooks/BasicGates.ipynb
Docker 컨테이너를 죽이지 않고 종료하려면 (데몬 모드) Ctrl+P, Ctrl+Q를 누릅니다.
기존 katas-container (데몬 모드)를 다시 입력하려면 :
docker attach katas-container 완료되면 katas-container 제거하십시오.
docker rm --force katas-container이 프로젝트는 기여와 제안을 환영합니다. 어떻게 기여할 수 있습니까? 자세한 내용.
이 프로젝트는 Microsoft 오픈 소스 행동 강령을 채택했습니다. 자세한 내용은 추가 질문이나 의견이 있으면 행동 강령 FAQ 또는 [email protected]에 문의하십시오.
