Skip to content

Conversation

@kuzminrobin
Copy link
Contributor

A complement to the set of 3 PRs: Q#RT, QDK, IQ# repos.

@kuzminrobin
Copy link
Contributor Author

Please review.

Copy link
Contributor

@cgranade cgranade left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Just to make sure that this doesn't get accidentally merged in before the other PRs are ready, leaving as a comment rather than approving for now.

> [!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.
On MacOS you can install `libomp` by running `brew install libomp`.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Is it OK to assume that macOS users have brew available?

[nit] Apple uses the capitalization "macOS."

Suggested change
On MacOS you can install `libomp` by running `brew install libomp`.
On macOS you can install `libomp` by running `brew install libomp`.

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Is it OK to assume that macOS users have brew available?

I'm not very experienced in macOS but I would expect that "Yes", since anything that gets installed on macOS is mostly installed with brew (same as on some distros of Linux everything is mostly installed with apt).

Apple uses the capitalization "macOS."

Fixing...

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I guess the difference is that apt is an official part of most Linux distributions, while brew is a very popular third-party tool for macOS. I have no objection to listing brew, but we may want to give context around what it is, or at least to have fallback for users without brew. By analogy, we give conda-based instructions as well as pip+dotnet instructions as a fallback.

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

To move forward I plan to leave the change as is for now. Feel free to provide a desired change and I'll update this PR.

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@cgranade Do you want to suggest an edit to add a sentence?

@davidpeterh davidpeterh requested a review from cgranade December 15, 2021 20:59
@davidpeterh
Copy link
Contributor

@cgranade Please review this PR again and merge it if it looks good. Thank you.

@kuzminrobin kuzminrobin force-pushed the kuzminrobin/gcc-version-fix6 branch from 3393065 to 6840e59 Compare January 4, 2022 00:59
@kuzminrobin
Copy link
Contributor Author

Please review again and/or approve.

> [!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.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

'then you need to install' - I'd think that this is only one of the possible reasons for getting 'Unable to load'. So I suggest something like "then you may be missing libomp, as the OpenMP..."

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thanks, changed.

> [!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`.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This seems to be one of the possibilities along with Ubuntu and CentOS, yet it's a separate sentence. I suggest saying something like:
You can install 'libomp' by running '...' on Ubuntu, '...' on Cent OS, '..' on macOS. For other distributions...

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Changed.

> [!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.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Same suggestions here.

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Changed.

@kuzminrobin
Copy link
Contributor Author

Please review and/or approve.

@kuzminrobin kuzminrobin merged commit 78ff34e into main Jan 5, 2022
@kuzminrobin kuzminrobin deleted the kuzminrobin/gcc-version-fix6 branch January 5, 2022 07:23
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

6 participants