Skip to content

Commit 772741e

Browse files
authored
Merge pull request #5586 from martin-frbg/issue5337
Update instructions for setting up a conda-based build environment on Windows
2 parents 54f7b76 + 579eda3 commit 772741e

File tree

1 file changed

+12
-8
lines changed

1 file changed

+12
-8
lines changed

docs/install.md

Lines changed: 12 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -217,30 +217,34 @@ in this section, since the process for each is quite different.
217217
For Visual Studio, you can use CMake to generate Visual Studio solution files;
218218
note that you will need at least CMake 3.11 for linking to work correctly).
219219

220-
Note that you need a Fortran compiler if you plan to build and use the LAPACK
221-
functions included with OpenBLAS. The sections below describe using either
220+
Note that you need a Fortran compiler if you plan to build and use the latest version
221+
of the LAPACK functions included with OpenBLAS. (If you do not have a Fortran compiler
222+
installed, you can build an older version of the LAPACK sources that has been converted
223+
to C - but its performance will likely be slower and accuracy may be poorer too.)
224+
The sections below describe using either
222225
`flang` as an add-on to clang/LLVM or `gfortran` as part of MinGW for this
223226
purpose. If you want to use the Intel Fortran compiler (`ifort` or `ifx`) for
224227
this, be sure to also use the Intel C compiler (`icc` or `icx`) for building
225228
the C parts, as the ABI imposed by `ifort` is incompatible with MSVC
226229

227230
A fully-optimized OpenBLAS that can be statically or dynamically linked to your
228231
application can currently be built for the 64-bit architecture with the LLVM
229-
compiler infrastructure. We're going to use [Miniconda3](https://docs.anaconda.com/miniconda/)
232+
compiler infrastructure. We're going to use [Miniforge3] the pre-configured
233+
and more versatile alternative to [Miniconda](https://docs.anaconda.com/miniconda/)
230234
to grab all of the tools we need, since some of them are in an experimental
231235
status. Before you begin, you'll need to have Microsoft Visual Studio 2015 or
232236
newer installed.
233237

234-
1. Install Miniconda3 for 64-bit Windows using `winget install --id Anaconda.Miniconda3`,
235-
or easily download from [conda.io](https://docs.conda.io/en/latest/miniconda.html).
236-
2. Open the "Anaconda Command Prompt" now available in the Start Menu, or at `%USERPROFILE%\miniconda3\shell\condabin\conda-hook.ps1`.
238+
1. Install Miniforge for 64-bit Windows with the latest version of the installer Miniforge3-Windows-x86_64.exe
239+
available on [github.com](https://github.com/conda-forge/miniforge/releases/)
240+
2. Open the "Miniforge Command Prompt" now available in the Start Menu, or at `%USERPROFILE%\miniforge3\shell\condabin\conda-hook.ps1`.
237241
3. In that command prompt window, use `cd` to change to the directory where you want to build OpenBLAS.
238242
4. Now install all of the tools we need:
239243
```
240244
conda update -n base conda
241-
conda config --add channels conda-forge
242-
conda install -y cmake flang clangdev perl libflang ninja
245+
conda install -y cmake flang_win-64 clangdev perl libflang ninja
243246
```
247+
(if you want to build with OpenMP support, add `llvm-openmp` and `llvm-openmp-fortran`)
244248
5. Still in the Anaconda Command Prompt window, activate the 64-bit MSVC environment with `vcvarsall x64`.
245249
On Windows 11 with Visual Studio 2022, this would be done by invoking:
246250

0 commit comments

Comments
 (0)