Last month, Microsoft announced a new quantum computing language named Q#, pronounced as “q-sharp”. With the language, Microsoft also announced a quantum development kit (QDK) for developers with all the necessary tools, a compiler, simulators, and the resources to build Q# programs using Visual Studio 2017 and C#.
In this tutorial, you’ll learn how to build your first simple “Hello World” Q# app. Just follow these following steps.
If you’re new to quantum computing, start with A Beginner’s Guide to Quantum Computing.
Step 1. Install Visual Studio 2017
To build quantum computing applications, you will need the latest version of Visual Studio 2017 (15.6 or later).
Download Visual Studio 2017 Community edition from here: https://www.visualstudio.com/downloads/
Step 2. Install Microsoft Quantum Development Kit
Visit Microsoft’s Quantum Computing home page here:
https://www.microsoft.com/en-us/quantum/development-kit
Click on "Download Now" button.
On the next page, fill out the details and click on "Download Now".
This action will send you to the Visual Studio Marketplace and download the Quantum Development Kit page:
https://marketplace.visualstudio.com/items?itemName=quantum.DevKit
Download Quantum Development Kit and installed it. Once the installation is completed, you should see the following Figure 2.
Installation of the Quantum Development Kit adds Q# Visual Studio project templates to the VS templates list.
Step 3. Create Q# Project
Now, let’s create our first Q# application.
Open Visual Studio 2017 Community and go to File > New Project > Visual C#. We see three Q# project templates – Q# Application, Q# Library, and Q# Test Project.
Select Q# Application project template, type your project name and click OK. See Figure 3.
The default solution looks like Figure 4.
Each Q# application has two default files – the C# driver (Driver.cs) and quantum code (Operation.qs). C# driver code listed in Driver.cs file is the entry point of the application. This code will look familiar to C# developers. See Listing 1.
- using Microsoft.Quantum.Simulation.Core;
- using Microsoft.Quantum.Simulation.Simulators;
-
- namespace Quantum.HelloQ
- {
-
- class Driver
- {
-
- static void Main(string[] args)
- {
- }
- }
- }
Listing 1.
The quantum code is in Operation.qs. See Listing 2.
- namespace Quantum.HelloQ
- {
- open Microsoft.Quantum.Primitive;
- open Microsoft.Quantum.Canon;
- operation Operation () : ()
- {
- body
- {
-
- }
- }
- }
Listing 2.
Step 4. Write a Q# Operation
Let’s write some Q# code that will do something. For the simplicity sake, I’ll create a simple operation in Q# that adds two integers and returns the total of the two.
Open Operation.qs and replace the code with Listing 3.
- namespace Quantum.HelloQ
- {
-
- open Microsoft.Quantum.Primitive;
-
-
- operation Add (a : Int, b : Int): (Int)
- {
- body
- {
- return (a + b);
- }
- }
- }
Listing 3.
In Listing 3, first of all, we import the Microsoft.Quantum.Primitive namespace.
open Microsoft.Quantum.Primitive;
Next, we write an operation. The basic unit of quantum execution is an operation. It is equivalent to a C/C++ function or a static method in C# or Java. The code snippet in Listing 4 is an operation.
-
- operation Add (a : Int, b : Int): (Int)
- {
- body
- {
- return (a + b);
- }
- }
Listing 4.
An operation starts with the keyword “operation”. An operation can be with or without arguments and can return nothing or a value. The arguments are a form of a tuple. If you’re not familiar with tuples, check out Tuples in C#. The type of an argument is defined using a colon. The return value is also separated from the arguments using a colon.
The operation Add declared in Listing 4 takes two arguments of int type and returns the sum of the two values. Each operation has a body section that contains the implementation of the operation.
Step 5. Execute a Q# Operation
The Main method of the Driver class is the gateway to the program that executes Q# code. Since there is no real quantum computer on my laptop, the way to execute a Q# program is using a quantum simulator. The quantum simulator is installed as a part of the QDK.
The QuantumSimulator class defined in the Microsoft.Quantum.Simulation.Simulators
namespace represents a simulator. The following code snippet creates a quantum simulator.
using (var sim = new QuantumSimulator())
An operation is executed by using a call operation.Run(simulator, arguments). The following code snippet executes the Add operation.
var res = Add.Run(sim, 20, 10).Result;
The complete code of Driver class is listed in Listing 4. The code calls the Add operation by passing a simulator, two arguments of integer type, and the results are returned in a var.
- using System;
-
- using Microsoft.Quantum.Simulation.Core;
- using Microsoft.Quantum.Simulation.Simulators;
-
- namespace Quantum.HelloQ
- {
- class Driver
- {
- static void Main(string[] args)
- {
- using (var sim = new QuantumSimulator())
- {
- var res = Add.Run(sim, 20, 10).Result;
- Console.WriteLine(res);
- }
- Console.WriteLine("Press any key to continue...");
- Console.ReadKey();
- }
- }
- }
Listing 5.
Step 6. Build and Run
If you build the project, you will get a bunch of errors. To fix that, you need to target a specific framework and platform.
Right click on project name in Solution Explorer and click on Properties. On Application settings, change Target framework to 4.6.1 and on Build settings, change Platform target from Any CPU to x64. See Figure 5.
Now Build and Run the application and you should see result 30 printed on the console i.e. total of the two values passed to the Q# operation.
Summary
Q# is the newest programming language introduced by Microsoft to write a quantum computing based application. In this article, you learned how to install Quantum Development Kit, setup up Visual Studio 2017 for a Q# project, write our first Q# code, and build and execute it.
If you’re new to quantum computing, I recommend reading A Beginner’s Guide to Quantum Computing. Learn more Q# Programming here >
References
https://docs.microsoft.com/en-us/quantum/quantum-writeaquantumprogram?view=qsharp-preview
Elvis Oswaldo Mirón MoralesPosted Jun 24, 2021, 11:51 PM
Excuse me, is there anyone who can recommend or suggest me that they know the answer to my question?
Elvis Oswaldo Mirón MoralesPosted Jun 21, 2021, 5:18 PM
Considering that the Q# language is for quantum computers, on a conventional computer yes does support this Q# language. Can I create an operating system with the Q# quantum programming language without a graphical interface and another with a graphical interface for the conventional computer?
Zhehan JiangPosted Dec 28, 2019, 11:54 PM
Thank you for sharing this! Do you also have an example that, say we want to optimize a logistic regression model to get its parameters?
Vipin BijalwanPosted Nov 28, 2018, 6:58 AM
Hi Mahesh is there any solution for vehicle routing problem in q#
Gozde UstunPosted Jul 30, 2018, 8:21 AM
I have a problem When I write Add.Run I have an error :Severity Code Description Project File Line Suppression StateError:CS0103 The name 'Add' does not exist in the current context I am sure that I wrote correctly
Gozde UstunPosted Jul 30, 2018, 8:19 AM
Thank you foryour beatiful blog
Kent PaulPosted Jan 27, 2018, 2:01 PM
I'm a math student and I'm really excited and interested to lean more of this. Where can I find more resources? Anything similar to this page would suffice.
Sashank RamarajuPosted Jan 8, 2018, 4:47 AM
Is there any course / Certification offered on this language by Microsoft. As part of my bachelors I have done my thesis on Quantum Computing , since then I always wanted to explore more on this subject through an authorized medium.
Mridul JainPosted Jan 2, 2018, 9:50 AM
What visual studio products should be installed ?
Aakash MauryaPosted Jan 2, 2018, 3:32 AM
Hi, In the summary section the URL "A Beginner’s Guide to Quantum Computing" is not working. Can you please check it again?
Ahsan SiddiquePosted Jan 1, 2018, 12:52 PM
Thanks for shearing...
Ahsan SiddiquePosted Jan 1, 2018, 12:52 PM
Wao Mahesh great article...