УВЕДОМЛЕНИЕ О ПРЕДУПРЕЖДЕННОМ УПОТРЕБЛЕНИИ

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

Для репозитория Modern QDK, пожалуйста, посетите Microsoft/qsharp.

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

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

Для получения дополнительной информации о Modern 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#.
• Симуляция: Эти образцы показывают, как моделировать эволюцию под различными гамильтонианами.Мы также рекомендуем ознакомиться с единичными тестами, используемыми для проверки правильности образцов квантового разработочного набора.

Настройка среды разработки

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

Если вы предпочитаете разработку кода локально, мы рекомендуем установить редактор, такой как [Visual Studio Code](https://code.visualstudio.com/download). Убедитесь, что на вашем локальном компьютере установлена версия [.NET Core SDK 3.1 или более поздняя](https://dotnet.microsoft.com/download). Для более подробных инструкций по настройке VS Code для разработки с использованием QDK, перейдите к нашим документам [здесь](https://docs.microsoft.com/azure/quantum/install-command-line-qdk).

После установки VS Code и .NET Core SDK скачайте этот репозиторий на ваш компьютер и откройте папку в VS Code. Редактор автоматически распознает файлы в папке `.vscode` и запросит у вас установку рекомендованных расширений. Это включает в себя [расширение Microsoft Quantum Development Kit для Visual Studio Code](https://marketplace.visualstudio.com/items?itemName=quantum.quantum-devkit-vscode), которое является самым быстрым способом для начала работы с QDK.

Откройте терминал для запуска ваших первых образцов (см. [здесь](#first-samples)).
```### Запуск Jupyter Notebook с использованием Docker

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

После установки [Docker](https://docs.docker.com/install/), вы можете использовать следующие команды для начала работы:

Для создания образа Docker и присвоения ему тега `iqsharp`:

```sh
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