Уведомление о прекращении поддержки

Этот репозиторий прекращает поддержку.

Для репозитория с современным QDK посетите Microsoft/qsharp.

Для примеров, использующих пакет Azure Quantum Python, посетите репозиторий Azure Quantum Python.

Вы также можете попробовать современный QDK в VS Code для Web по адресу vscode.dev/quantum.

Дополнительную информацию о современном QDK и Azure Quantum можно найти по адресу https://aka.ms/AQ/Documentation.

Классический QDK

Эти образцы демонстрируют использование Quantum Development Kit для выполнения различных задач квантового вычисления.

Каждый образец является автономным и расположен в отдельной папке, показывая, как использовать Q# для создания квантовых приложений.

Небольшая часть образцов требует дополнительной установки, помимо основных требований для Quantum Development Kit. Это указано в файлах README.md каждого образца вместе с полными инструкциями по установке.

Начало работы

Инструкции по установке Quantum Development Kit можно найти в нашей онлайн-документации, которая также включает в себя введение в основные концепции квантового программирования.

Для быстрого руководства по созданию среды разработки с нуля с помощью Visual Studio Code или GitHub Codespaces, см. этот раздел.

Также предоставляется определение образа Docker для вашего удобства, см. этот раздел для инструкций по сборке и использованию.

Первые образцы

Если вы новичок в области квантовой механики или в Quantum Development Kit, мы рекомендуем начать с образцов Getting Started.

После того, как вы установили среду разработки с помощью одного из вышеуказанных вариантов, попробуйте перейти к samples/getting-started/teleportation через терминал и запустить dotnet run. Вы должны видеть что-то вроде следующего:

Округ 1: Отправлено False, получено False.
Успешная телепортация!
Округ 2: Отправлено True, получено True.
Успешная телепортация!
Округ 3: Отправлено False, получено False.
Успешная телепортация!
Округ 4: Отправлено False, получено False.
Успешная телепортация!
Округ 5: Отправлено False, получено False.
Успешная телепортация!
Округ 6: Отправлено False, получено False.
Успешная телепортация!
Округ 7: Отправлено True, получено True.
Успешная телепортация!
Округ 8: Отправлено False, получено False.
Успешная телепортация!

Поздравляем, теперь вы можете приступить к квантовому программированию!

Дальнейшие шаги

По мере продвижения в квантовом разработке мы предлагаем несколько категорий образцов для исследования:

• Алгоритмы: Эти образцы демонстрируют различные квантовые алгоритмы, такие как поиск в базе данных и факторизация целых чисел.
• Арифметика: Эти образцы показывают, как коэргировать арифметические данные.
• Характеризация: Эти образцы демонстрируют, как учиться свойствам квантовых систем из классических данных.
• Химия: Эти образцы демонстрируют использование библиотеки квантовой химии.
• Диагностика: Эти образцы показывают, как диагностировать и тестировать приложения Q#.
• Коррекция ошибок: Эти образцы показывают, как работать с кодами коррекции ошибок в Q# программах.
• Интероперабильность: Эти образцы показывают, как использовать Q# с различными языками-хостами.
• Машинное обучение: Эти образцы демонстрируют, как обучать простые последовательные модели на данных полумесяцев и вина.
• Численные методы: Образцы в этой папке показывают, как использовать библиотеку численных методов.
• Рантайм: Эти образцы показывают, как работать с Q# симуляционным рантаймом.
• Симуляция: Эти образцы показывают, как моделировать эволюцию под различными Гамильтонами.

Мы также рекомендуем ознакомиться с единичными тестами, используемыми для проверки правильности образцов Quantum Development Kit.

Установка среды разработки

Этот репозиторий содержит несколько конфигурационных файлов, которые помогут вам быстро начать работу с кодированием. Ниже представлены инструкции по установке среды разработки с помощью VSCode или Jupyter notebooks.

Visual Studio Code

Если вы предпочитаете разрабатывать код локально, мы рекомендуем установить редактор, такой как Visual Studio Code. Убедитесь, что установлен .NET Core SDK 3.1 или более поздней версии на вашем компьютере. Для более подробных инструкций по установке VS Code для разработки с QDK, обратитесь к нашим документам здесь.

После установки VS Code и .NET Core SDK скачайте этот репозиторий на ваш компьютер и откройте папку в VS Code. Редактор автоматически распознает файлы в папке .vscode и запросит вас установить рекомендованные расширения. Это включает в себя расширение Microsoft Quantum Development Kit для Visual Studio Code, которое является самым быстрым способом начала работы с QDK.

Откройте терминал для запуска ваших первых образцов (см. здесь).

Запуск Jupyter Notebook с Poddera DockerЕщё один способ быстро начать разработку в Q# — это использовать Docker и запустить Jupyter notebook на вашем локальном компьютере. Вы можете использовать включённый Dockerfile для создания образа Docker со всеми необходимыми библиотеками для использования Quantum Development Kit для создания квантовых приложений на C#, Python или Jupyter.

После установки 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