Skip to content

Commit 1014d09

Browse files
authored
DOC: Update instructions to build NumPy on WoA
1 parent e6a7657 commit 1014d09

File tree

1 file changed

+18
-10
lines changed

1 file changed

+18
-10
lines changed

doc/source/building/index.rst

Lines changed: 18 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -226,21 +226,21 @@ your system.
226226
In Windows on ARM64, the set of a compiler options that are available for
227227
building NumPy are limited. Compilers such as GCC and GFortran are not yet
228228
supported for Windows on ARM64. Currently, the NumPy build for Windows on ARM64
229-
is supported with MSVC toolchain only. The use of a Fortran compiler is more
230-
tricky than on other platforms, because MSVC does not support Fortran, and
229+
is supported with MSVC and LLVM toolchains. The use of a Fortran compiler is
230+
more tricky than on other platforms, because MSVC does not support Fortran, and
231231
gfortran and MSVC can't be used together. If you don't need to run the ``f2py``
232232
tests, simply using MSVC is easiest. Otherwise, you will need the following
233233
set of compilers:
234234

235-
1. MSVC + Flang-new (``flang-new``)
235+
1. MSVC + flang (``cl``, ``flang``)
236+
2. LLVM + flang (``clang-cl``, ``flang``)
236237

237238
First, install Microsoft Visual Studio - the 2022 Community Edition will
238-
work(see the `Visual Studio download site <https://visualstudio.microsoft.com/downloads/>`__).
239-
In order to ensure you have the Windows Universal C Runtime (the other components
240-
of Visual Studio can be deselected if desired, to save disk space). The
241-
recommended version of the UCRT is >= 10.0.22621.0.
239+
work (see the `Visual Studio download site <https://visualstudio.microsoft.com/downloads/>`__).
240+
Ensure that you have installed necessary Visual Studio components for building NumPy
241+
on WoA from `here <https://gist.github.com/Mugundanmcw/c3bb93018d5da9311fb2b222f205ba19>`__.
242242

243-
To use flang-new fortran compiler for Windows on ARM64, install Latest LLVM
243+
To use the flang compiler for Windows on ARM64, install Latest LLVM
244244
toolchain for WoA from `here <https://github.com/llvm/llvm-project/releases>`__.
245245

246246
.. tab-set::
@@ -257,6 +257,14 @@ your system.
257257
For detailed guidance, see `Use the Microsoft C++ toolset from the command line
258258
<https://learn.microsoft.com/en-us/cpp/build/building-on-the-command-line?view=msvc-170>`__.
259259

260+
.. tab-item:: LLVM
261+
262+
Similar to MSVC, LLVM does not put the compilers on the system path.
263+
To set system path for LLVM compilers, users may need to use ``set``
264+
command to put compilers on the system path. To check compiler's path
265+
for LLVM's clang-cl, try invoking LLVM's clang-cl compiler in the shell you use
266+
(``clang-cl --version``).
267+
260268
.. note::
261269

262270
Compilers should be on the system path (i.e., the ``PATH`` environment
@@ -265,7 +273,7 @@ your system.
265273
will be found automatically if and only if there are no other compilers
266274
on the ``PATH``. You can use any shell (e.g., Powershell, ``cmd`` or
267275
Git Bash) to invoke a build. To check that this is the case, try
268-
invoking a Fortran compiler in the shell you use (e.g., ``flang-new
276+
invoking a Fortran compiler in the shell you use (e.g., ``flang
269277
--version``).
270278

271279
.. warning::
@@ -428,7 +436,7 @@ virtual environments:
428436
Building NumPy with BLAS and LAPACK functions requires OpenBLAS
429437
library at Runtime. In Windows on ARM64, this can be done by setting
430438
up pkg-config for OpenBLAS dependency. The build steps for OpenBLAS
431-
for Windows on ARM64 can be found `here <https://github.com/OpenMathLib/OpenBLAS/blob/develop/docs/install.md#windows-on-arm>`__.
439+
for Windows on ARM64 can be found `here <http://www.openmathlib.org/OpenBLAS/docs/install/#windows-on-arm>`__.
432440

433441

434442
Then install the Python-level dependencies from PyPI with::

0 commit comments

Comments
 (0)