양자

지원 중단 공지

이 저장소는 더 이상 사용되지 않습니다.

최신 QDK 리포지토리를 보려면 Microsoft/qsharp를 방문하세요.

Azure Quantum Python 패키지를 사용하는 샘플을 보려면 Azure Quantum Python 리포지토리를 방문하세요.

vscode.dev/퀀텀에서 웹용 VS Code의 최신 QDK를 시험해 볼 수도 있습니다.

최신 QDK 및 Azure Quantum에 대한 자세한 내용을 보려면 https://aka.ms/AQ/Documentation을 방문하세요.

클래식 QDK

이 샘플은 다양한 양자 컴퓨팅 작업에 Quantum Development Kit를 사용하는 방법을 보여줍니다.

각 샘플은 폴더에 자체 포함되어 있으며 Q#을 사용하여 양자 애플리케이션을 개발하는 방법을 보여줍니다.

소수의 샘플에는 Quantum Development Kit의 나머지 부분보다 추가 설치 요구 사항이 있습니다. 이러한 내용은 전체 설치 지침과 함께 각 샘플의 README.md 파일에 나와 있습니다.

시작하기

양자 프로그래밍 개념에 대한 소개도 포함된 온라인 설명서에서 양자 개발 키트를 설치하는 방법에 대한 지침을 찾을 수 있습니다.

Visual Studio Code 또는 GitHub Codespaces를 사용하여 처음부터 개발 환경을 설정하는 방법에 대한 빠른 가이드는 여기를 참조하세요.

귀하의 편의를 위해 Docker 이미지 정의도 제공됩니다. 이를 구축하고 사용하는 방법에 대한 지침은 여기를 참조하세요.

첫 번째 샘플

양자 또는 양자 개발 키트를 처음 사용하는 경우 시작하기 샘플부터 시작하는 것이 좋습니다.

위 옵션 중 하나를 사용하여 개발 환경을 설정한 후 터미널을 통해 samples/getting-started/teleportation 찾아 dotnet run 실행해 보세요. 다음과 같은 내용이 표시됩니다.

 Round 1: Sent False, got False.
Teleportation successful!
Round 2: Sent True, got True.
Teleportation successful!
Round 3: Sent False, got False.
Teleportation successful!
Round 4: Sent False, got False.
Teleportation successful!
Round 5: Sent False, got False.
Teleportation successful!
Round 6: Sent False, got False.
Teleportation successful!
Round 7: Sent True, got True.
Teleportation successful!
Round 8: Sent False, got False.
Teleportation successful!

축하합니다. 이제 양자 프로그래밍을 시작할 수 있습니다!

더 나아가

양자 개발을 더 진행하면서 우리는 탐색할 수 있는 다양한 샘플 범주를 제공합니다.

• 알고리즘 : 이 샘플은 데이터베이스 검색 및 정수 분해와 같은 다양한 양자 알고리즘을 보여줍니다.
• 산술 : 이 샘플은 산술 데이터를 일관되게 변환하는 방법을 보여줍니다.
• 특성화 : 이 샘플은 클래식 데이터에서 양자 시스템의 속성을 학습하는 방법을 보여줍니다.
• 화학 : 이 샘플은 Quantum Chemistry 라이브러리의 사용을 보여줍니다.
• 진단 : 이 샘플은 Q# 애플리케이션을 진단하고 테스트하는 방법을 보여줍니다.
• 오류 수정 : 이 샘플은 Q# 프로그램에서 양자 오류 수정 코드를 사용하는 방법을 보여줍니다.
• 상호 운용성 : 이 샘플은 다양한 호스트 언어로 Q#을 사용하는 방법을 보여줍니다.
• 기계 학습 : 이 샘플은 반달 및 와인 데이터 세트에서 간단한 순차 모델을 훈련하는 방법을 보여줍니다.
• Numerics : 이 폴더의 샘플은 숫자 라이브러리를 사용하는 방법을 보여줍니다.
• 런타임 : 이 샘플은 Q# 시뮬레이션 런타임을 사용하는 방법을 보여줍니다.
• 시뮬레이션 : 이 샘플은 다양한 해밀턴의 진화를 시뮬레이션하는 방법을 보여줍니다.

또한 Quantum Development Kit 샘플의 정확성을 확인하는 데 사용되는 단위 테스트를 살펴보는 것이 좋습니다.

개발 환경 설정

이 저장소에는 코딩을 쉽게 시작할 수 있는 여러 구성 파일이 포함되어 있습니다. 아래에는 VSCode 또는 Jupyter 노트북을 시작하기 위한 몇 가지 지침이 나와 있습니다.

비주얼 스튜디오 코드

로컬에서 코드를 개발하려는 경우 Visual Studio Code와 같은 편집기를 설치하는 것이 좋습니다. 로컬 머신에 .NET Core SDK 3.1 이상을 설치해야 합니다. QDK를 사용한 개발을 위해 VS Code를 설정하는 방법에 대한 자세한 지침을 보려면 여기에서 문서를 참조하세요.

VS Code 및 .NET Core SDK를 설치한 후 이 저장소를 컴퓨터에 다운로드하고 VS Code에서 폴더를 엽니다. 편집기는 .vscode 폴더의 파일을 자동으로 인식하고 권장 확장을 설치하도록 요청합니다. 여기에는 QDK를 시작하는 가장 빠른 방법인 Visual Studio Code용 Microsoft Quantum Development Kit 확장이 포함되어 있습니다.

터미널을 열어 첫 번째 샘플 실행을 시작하세요(여기 참조).

Docker로 Jupyter Notebook 실행

Q#에서 빠르게 개발을 시작하는 또 다른 방법은 Docker를 사용하고 로컬 컴퓨터에서 Jupyter Notebook을 시작하는 것입니다. 포함된 Dockerfile을 사용하면 Quantum Development Kit를 사용하여 C#, Python 또는 Jupyter에서 양자 애플리케이션을 구축하는 데 필요한 모든 라이브러리가 포함된 Docker 이미지를 생성할 수 있습니다.

Docker를 설치한 후에는 다음 명령을 사용하여 시작할 수 있습니다.

Docker 이미지를 빌드하고 iqsharp 태그를 지정하려면 다음을 수행하세요.

docker build -t iqsharp .

대화형 명령줄을 사용하여 iqsharp-container 라는 컨테이너에서 이미지를 실행하고 컨테이너 포트 8888을 로컬 포트 ​​8888로 리디렉션하려면(jupyter 실행에 필요):

docker run -it --name iqsharp-container -p 8888:8888 iqsharp /bin/bash

해당 컨테이너 명령줄에서 다음을 사용하여 순간 이동 샘플의 C# 버전을 실행할 수 있습니다.

 cd ~ /samples/getting-started/teleportation && dotnet run

마찬가지로 다음을 사용하여 Python 버전의 순간 이동 샘플을 실행할 수 있습니다.

 cd ~ /samples/getting-started/teleportation && python host.py

마지막으로 순간 이동 샘플의 이미지 내에서 Jupyter Notebook을 시작하려면 다음을 사용합니다.

 cd ~ /samples/getting-started/teleportation && jupyter notebook --ip=0.0.0.0 --no-browser 

Jupyter가 시작되면 브라우저에서 순간이동 노트북을 열 수 있습니다(이전 단계에서 jupyter가 시작될 때 생성된 토큰이 필요합니다).

http://localhost:8888/notebooks/Notebook.ipynb

완료되면 iqsharp-container 라는 컨테이너를 제거합니다.

docker rm --force iqsharp-container