Programar com Q# e PythonDevelop with Q# and Python

Instale o QDK para desenvolver programas anfitriões Python para chamar operações Q#.Install the QDK to develop Python host programs to call Q# operations.

Instale o pacote qsharp do PythonInstall the qsharp Python package

  1. Instale o Miniconda ou o Anaconda.Install Miniconda or Anaconda. Nota: Instalação de 64 bits obrigatória.Note: 64-bit installation required.

  2. Abra um Pedido do Anaconda.Open an Anaconda Prompt.

    • Em alternativa, se preferir utilizar o PowerShell ou o pwsh:, abra uma shell, execute conda init powershell, feche e reabra a shell.Or, if you prefer to use PowerShell or pwsh: open a shell, run conda init powershell, then close and re-open the shell.
  3. Crie e ative um novo ambiente conda com o nome qsharp-env com os pacotes necessários (incluindo Jupyter Notebook e IQ#) ao executar os seguintes comandos:Create and activate a new conda environment named qsharp-env with the required packages (including Jupyter Notebook and IQ#) by running the following commands:

    conda create -n qsharp-env -c quantum-engineering qsharp notebook
    
    conda activate qsharp-env
    
  4. Execute python -c "import qsharp" a partir do mesmo terminal para verificar a instalação e povoar a cache de pacotes local com todos os componentes QDK necessários.Run python -c "import qsharp" from the same terminal to verify your installation and populate your local package cache with all required QDK components.

Já está!That's it! Tem agora o pacote qsharp do Python e o kernel do IQ# para Jupyter, que fornecem a principal funcionalidade para compilar e executar operações Q# a partir do Python e utilizar o Q# Jupyter Notebook.You now have both the qsharp Python package and the IQ# kernel for Jupyter, which provide the core functionality for compiling and running Q# operations from Python and allows you to use Q# Jupyter Notebooks.

Escolha o seu IDEChoose your IDE

Embora possa utilizar o Q# com o Python em qualquer IDE, recomendamos vivamente utilizar o IDE do Visual Studio Code (VS Code) para as aplicações Q# + Python.While you can use Q# with Python in any IDE, we highly recommend using Visual Studio Code (VS Code) IDE for your Q# + Python applications. Com a extensão QDK do Visual Studio Code, obtém acesso a funcionalidades mais avançadas, como avisos, realce de sintaxe, modelos de projeto e muito mais.With the QDK Visual Studio Code extension you gain access to richer functionality such as warnings, syntax highlighting, project templates, and more.

Se quiser utilizar o VS Code:If you would like to use VS Code:

Se quiser utilizar um editor diferente, as instruções acima têm tudo definido.If you would like to use a different editor, the instructions above have you all set.

Escreva o seu primeiro programa Q#Write your first Q# program

Agora, está preparado para verificar a instalação do pacote qsharp do Python ao escrever e executar um programa Q# simples.Now you are ready to verify your qsharp Python package installation by writing and running a simple Q# program.

  1. Crie uma operação Q# mínima ao criar um ficheiro chamado Operation.qs e adicionar ao mesmo o seguinte código:Create a minimal Q# operation by creating a file called Operation.qs and adding the following code to it:

    namespace Qrng {
        open Microsoft.Quantum.Intrinsic;
    
        operation SampleQuantumRandomNumberGenerator() : Result {
            using (q = Qubit())  { // Allocate a qubit.
                H(q);             // Put the qubit to superposition. It now has a 50% chance of being 0 or 1.
                let r = M(q);     // Measure the qubit value.
                Reset(q);
                return r;
            }
        }
    }
    
  2. Na mesma pasta de Operation.qs, crie um programa Python chamado host.py para simular a operação Q# SampleQuantumRandomNumberGenerator():In the same folder as Operation.qs, create a Python program called host.py to simulate the Q# SampleQuantumRandomNumberGenerator() operation:

    import qsharp
    from Qrng import SampleQuantumRandomNumberGenerator
    
    print(SampleQuantumRandomNumberGenerator.simulate())
    
  3. A partir do ambiente que criou durante a instalação (ou seja, o ambiente conda ou Python onde instalou qsharp), execute o programa:From the environment you created during installation (i.e., the conda or Python environment where you installed qsharp), run the program:

    python host.py
    
  4. Deverá ver o resultado da operação que invocou.You should see the result of the operation you invoked. Neste caso, como a operação gera um resultado aleatório, verá 0 ou 1 impressos no ecrã.In this case, because your operation generates a random result, you will see either 0 or 1 printed on the screen. Se executar o programa repetidamente, deverá ver cada resultado aproximadamente metade do tempo.If you run the program repeatedly, you should see each result approximately half the time.

Nota

  • O código Python é um programa Python normal.The Python code is just a normal Python program. Pode utilizar qualquer ambiente Python, incluindo Jupyter Notebooks baseados em Python, para escrever o programa Python e chamar as operações Q#.You can use any Python environment, including Python-based Jupyter Notebooks, to write the Python program and call Q# operations. O programa Python pode importar operações Q# a partir de quaisquer ficheiros .qs localizados na mesma pasta do próprio código Python.The Python program can import Q# operations from any .qs files located in the same folder as the Python code itself.

Passos seguintesNext steps

Agora que testou o Quantum Development Kit no seu ambiente preferido, pode seguir este tutorial para escrever e executar o seu primeiro programa quântico.Now that you have tested the Quantum Development Kit in your preferred environment, you can follow this tutorial to write and run your first quantum program.