From 1599db9d143e3644c1d1366bb257e3c05b6d8678 Mon Sep 17 00:00:00 2001 From: Robin Kuzmin Date: Fri, 10 Dec 2021 11:32:20 -0800 Subject: [PATCH 1/5] Updated the doc from `libgomp` to `libomp`. --- articles/install-command-line-qdk.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/articles/install-command-line-qdk.md b/articles/install-command-line-qdk.md index ec78543d7..b4247df63 100644 --- a/articles/install-command-line-qdk.md +++ b/articles/install-command-line-qdk.md @@ -52,7 +52,7 @@ Jupyter Notebooks allows running code in-place alongside instructions, notes, an While you can build Q# applications in any IDE, we recommend using Visual Studio Code (VS Code) or Visual Studio IDE for developing your Q# applications if you are running them via a .NET console. Developing in these environments leverages the rich functionality of the Quantum Development Kit (QDK) extension, which includes warnings, syntax highlighting, project templates, and more. > [!IMPORTANT] -> If you are working on Linux, you may encounter a missing dependency depending on your particular distribution and installation method (such as certain Docker images). Please make sure that the `libgomp` library is installed on your system, as the GNU OpenMP support library is required by the quantum simulator of the QDK. On Ubuntu, you can do so by running `sudo apt install libgomp1`, or `yum install libgomp` on CentOS. For other distributions, please refer to your particular package manager. +> If you are working on Linux, you may encounter a missing dependency depending on your particular distribution and installation method (such as certain Docker images). Please make sure that the `libomp` library is installed on your system, as the OpenMP support library is required by the quantum simulator of the QDK. On Ubuntu, you can do so by running `sudo apt install libomp5-11`, or `yum install libomp` on CentOS. For other distributions, please refer to your particular package manager. ### Prerequisite From 6ef5cf6c0e2bba61f75a5517fc59ada537189f39 Mon Sep 17 00:00:00 2001 From: Robin Kuzmin Date: Fri, 10 Dec 2021 13:03:57 -0800 Subject: [PATCH 2/5] Added MacOS instructions for libomp. --- articles/install-command-line-qdk.md | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/articles/install-command-line-qdk.md b/articles/install-command-line-qdk.md index b4247df63..7ac203de8 100644 --- a/articles/install-command-line-qdk.md +++ b/articles/install-command-line-qdk.md @@ -52,7 +52,8 @@ Jupyter Notebooks allows running code in-place alongside instructions, notes, an While you can build Q# applications in any IDE, we recommend using Visual Studio Code (VS Code) or Visual Studio IDE for developing your Q# applications if you are running them via a .NET console. Developing in these environments leverages the rich functionality of the Quantum Development Kit (QDK) extension, which includes warnings, syntax highlighting, project templates, and more. > [!IMPORTANT] -> If you are working on Linux, you may encounter a missing dependency depending on your particular distribution and installation method (such as certain Docker images). Please make sure that the `libomp` library is installed on your system, as the OpenMP support library is required by the quantum simulator of the QDK. On Ubuntu, you can do so by running `sudo apt install libomp5-11`, or `yum install libomp` on CentOS. For other distributions, please refer to your particular package manager. +> If you are working on Linux, you may encounter a missing dependency depending on your particular distribution and installation method (such as certain Docker images). Please make sure that the `libomp` library is installed on your system, as the OpenMP support library is required by the quantum simulator of the QDK. On Ubuntu, you can do so by running `sudo apt install libomp5-11`, or `yum install libomp` on CentOS. For other distributions, please refer to your particular package manager. +On MacOS you can install `libomp` by running `brew install libomp`. ### Prerequisite From 19ab54a1d9fc5d4612113112a65e6edbd687be3f Mon Sep 17 00:00:00 2001 From: Robin Kuzmin Date: Mon, 13 Dec 2021 10:25:35 -0800 Subject: [PATCH 3/5] CR changes. --- articles/install-command-line-qdk.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/articles/install-command-line-qdk.md b/articles/install-command-line-qdk.md index 7ac203de8..b6555664a 100644 --- a/articles/install-command-line-qdk.md +++ b/articles/install-command-line-qdk.md @@ -53,7 +53,7 @@ While you can build Q# applications in any IDE, we recommend using Visual Studio > [!IMPORTANT] > If you are working on Linux, you may encounter a missing dependency depending on your particular distribution and installation method (such as certain Docker images). Please make sure that the `libomp` library is installed on your system, as the OpenMP support library is required by the quantum simulator of the QDK. On Ubuntu, you can do so by running `sudo apt install libomp5-11`, or `yum install libomp` on CentOS. For other distributions, please refer to your particular package manager. -On MacOS you can install `libomp` by running `brew install libomp`. +On macOS you can install `libomp` by running `brew install libomp`. ### Prerequisite From 6840e5900840808c6e50bf0fa8fbfdd4f572a1a4 Mon Sep 17 00:00:00 2001 From: Robin Kuzmin Date: Fri, 17 Dec 2021 10:50:08 -0800 Subject: [PATCH 4/5] Added some more instructions about `libomp`. --- articles/how-to-python-qdk-local.md | 6 +++++- 1 file changed, 5 insertions(+), 1 deletion(-) diff --git a/articles/how-to-python-qdk-local.md b/articles/how-to-python-qdk-local.md index 8656267a8..bbd1cdd23 100644 --- a/articles/how-to-python-qdk-local.md +++ b/articles/how-to-python-qdk-local.md @@ -77,7 +77,11 @@ Once imported, the `qsharp` package allows Q# namespaces to appear as Python mod ```output Hello, quantum world! ``` - + +> [!NOTE] +> If you hit an error `Unable to load shared library 'Microsoft.Quantum.Simulator.Runtime' or one of its dependencies`, then you need to install the `libomp` library, as the OpenMP support library is required by the quantum simulator of the QDK. On Ubuntu, you can do so by running `sudo apt install libomp5-11`, or `yum install libomp` on CentOS. For other distributions, please refer to your particular package manager. +On macOS you can install `libomp` by running `brew install libomp`. + > [!NOTE] > If you are running your operations in Jupyter Notebooks, the `%%qsharp` magic command allows you to define new Q# operations within the same Jupyter notebook as the Python code, eluding the use of a host program. For more information, see [Q# and Jupyter Notebooks](/azure/quantum/user-guide/host-programs?tabs=tabid-python#q-jupyter-notebooks). From 19518a3484c4c9dba8a7042f977bc6e226f8b870 Mon Sep 17 00:00:00 2001 From: Robin Kuzmin Date: Tue, 4 Jan 2022 14:33:11 -0800 Subject: [PATCH 5/5] CR changes. --- articles/how-to-python-qdk-local.md | 3 +-- articles/install-command-line-qdk.md | 3 +-- 2 files changed, 2 insertions(+), 4 deletions(-) diff --git a/articles/how-to-python-qdk-local.md b/articles/how-to-python-qdk-local.md index bbd1cdd23..ec46343a0 100644 --- a/articles/how-to-python-qdk-local.md +++ b/articles/how-to-python-qdk-local.md @@ -79,8 +79,7 @@ Once imported, the `qsharp` package allows Q# namespaces to appear as Python mod ``` > [!NOTE] -> If you hit an error `Unable to load shared library 'Microsoft.Quantum.Simulator.Runtime' or one of its dependencies`, then you need to install the `libomp` library, as the OpenMP support library is required by the quantum simulator of the QDK. On Ubuntu, you can do so by running `sudo apt install libomp5-11`, or `yum install libomp` on CentOS. For other distributions, please refer to your particular package manager. -On macOS you can install `libomp` by running `brew install libomp`. +> If you hit an error `Unable to load shared library 'Microsoft.Quantum.Simulator.Runtime' or one of its dependencies`, then you may be missing the `libomp` library, as the OpenMP support library is required by the quantum simulator of the QDK. You can install `libomp` by running `sudo apt install libomp5-11` on Ubuntu, `brew install libomp` on macOS. For other distributions/OSs, please refer to your particular package manager. > [!NOTE] > If you are running your operations in Jupyter Notebooks, the `%%qsharp` magic command allows you to define new Q# operations within the same Jupyter notebook as the Python code, eluding the use of a host program. For more information, see [Q# and Jupyter Notebooks](/azure/quantum/user-guide/host-programs?tabs=tabid-python#q-jupyter-notebooks). diff --git a/articles/install-command-line-qdk.md b/articles/install-command-line-qdk.md index b6555664a..7730dd99a 100644 --- a/articles/install-command-line-qdk.md +++ b/articles/install-command-line-qdk.md @@ -52,8 +52,7 @@ Jupyter Notebooks allows running code in-place alongside instructions, notes, an While you can build Q# applications in any IDE, we recommend using Visual Studio Code (VS Code) or Visual Studio IDE for developing your Q# applications if you are running them via a .NET console. Developing in these environments leverages the rich functionality of the Quantum Development Kit (QDK) extension, which includes warnings, syntax highlighting, project templates, and more. > [!IMPORTANT] -> If you are working on Linux, you may encounter a missing dependency depending on your particular distribution and installation method (such as certain Docker images). Please make sure that the `libomp` library is installed on your system, as the OpenMP support library is required by the quantum simulator of the QDK. On Ubuntu, you can do so by running `sudo apt install libomp5-11`, or `yum install libomp` on CentOS. For other distributions, please refer to your particular package manager. -On macOS you can install `libomp` by running `brew install libomp`. +> If you encounter a missing dependency then please make sure that the `libomp` library is installed on your system, as the OpenMP support library is required by the quantum simulator of the QDK. You can install `libomp` by running `sudo apt install libomp5-11` on Ubuntu, `brew install libomp` on macOS. For other distributions/OSs, please refer to your particular package manager. ### Prerequisite