Building on Windows VS22

[zoharl3]

I'd like to share my experience, which wasn't smooth.

I used Intel Fortran compiler.

I commented out from CMakeLists.txt: #add_subdirectory(test).
It had a problem with backslashes in the path.

My batch for running cmake:

@echo off
cls

@SETLOCAL

mkdir build

call c:/oneAPI/setvars.bat
rem Replace foreslashes with backslashes
set "MKLROOT=%MKLROOT:\=/%"

cmake ^
-Dintsize64=on ^
-DBUILD_SINGLE=no ^
-DBUILD_DOUBLE=yes ^
-DBUILD_COMPLEX=no ^
-DBUILD_COMPLEX16=no ^
-DMUMPS_parallel=no ^
-DCMAKE_BUILD_TYPE=Release ^
-DCMAKE_Fortran_COMPILER=ifx ^
-DCMAKE_C_COMPILER=cl ^
-DCMAKE_CXX_COMPILER=cl ^
-DCMAKE_TOOLCHAIN_FILE=d:/vcpkg/scripts/buildsystems/vcpkg.cmake ^ -DVCPKG_TARGET_TRIPLET=x64-windows ^
-Wno-dev -G Ninja -B build

pause

After installation, I removed from FindMUMPS.cmake the check for a fortran compiler (line 138). A fortran compiler isn't needed at this point, and tests didn't pass successfully.

To add it to a project's cmake file:

set( MUMPS_ROOT c:/prj-external-libs/mumps/build/local/ )
find_package( MUMPS REQUIRED )
message( "MUMPS_INCLUDE_DIRS: " ${MUMPS_INCLUDE_DIRS} )
message( "MUMPS_LIBRARIES: " ${MUMPS_LIBRARIES} )

target_include_directories( ${PRJ_NAME} PRIVATE ${MUMPS_INCLUDE_DIRS} )
target_link_libraries( ${PRJ_NAME} ${MUMPS_LIBRARIES} )

# ?? it wrongly puts c:/oneAPI/compiler/latest/lib/$(Configuration)
target_link_directories( ${PRJ_NAME} PRIVATE c:/oneAPI/compiler/latest/lib/ )
# ?? mpiseq.lib is missing
target_link_libraries( ${PRJ_NAME} ${MUMPS_ROOT}/lib/mpiseq.lib )

---

There's also a convenient mumps package in msys2 pacman, which should be compatible with vs22. However, it doesn't have FindMUMPS.cmake, and linking libs manually seems a hassle.

---

MUMPS isn't a great name. Every time I google it, I need to add solver, else all the results are on the disease.

---

Currently, I'm looking for a video lecture that explains the basic algorithm, e.g., pivoting and blocks:

https://mumps-solver.org/doc/EMS_ECMI_LanczosPrize_MUMPS.pdf

[scivision]

I think you want to use find_package(MUMPS CONFIG) when using our CMake MUMPS. The FindMUMPS.cmake is not used with our project--I moved it to the archive/ directory.

Example: https://gist.github.com/scivision/1ea2d19011c165b39b15ccb95d54f451

[scivision]

When using option MUMPS_parallel=false, among the installed files with cmake --install are <prefix>/lib/libmpiseq.a

[scivision]

With regard to forward slashes, I haven't experienced problems on Windows. I test manually with Windows Intel oneAPI because GitHub Actions takes like an hour to setup the WIndows oneAPI compiler.
I just tested the project today (2025-02-11) with Windows oneAPI 2025.0 and it all works, including the example/ directory after building MUMPS.

[zoharl3]

1. Using your code, FindMUMPS.cmake isn't necessary and libmpiseq isn't missing.

2. Forward slashes. My MKLROOT is set to c:\oneAPI\mkl\latest. If I don't convert the slashes, then I get an error:

CMake Error at D:/vcpkg/scripts/buildsystems/vcpkg.cmake:784 (set):
  Syntax error in cmake code at

    D:/vcpkg/scripts/buildsystems/vcpkg.cmake:784

  when parsing string

    CONFIG;HINTS;c:\oneAPI\mkl\latest

  Invalid character escape '\o'.
Call Stack (most recent call first):
  cmake/FindLAPACK.cmake:403 (find_package)
  cmake/FindLAPACK.cmake:454 (lapack_mkl)
  D:/vcpkg/scripts/buildsystems/vcpkg.cmake:859 (_find_package)
  cmake/lapack.cmake:11 (find_package)
  CMakeLists.txt:71 (include)

3. When building the project, I get a linking error that ifconsol.lib is missing. This requires

# ?? it wrongly puts c:/oneAPI/compiler/latest/lib/$(Configuration)
target_link_directories( ${PRJ_NAME} PRIVATE c:/oneAPI/compiler/latest/lib/ )

4. Does your example work on msys2 (the previous questions aren't related to msys2)?
   When I run cmake with (outside msys2 shell for vs22)

-DMUMPS_ROOT=c:/msys64/mingw64/ ^

It tells me

CMake Error at D:/vcpkg/scripts/buildsystems/vcpkg.cmake:859 (_find_package):
  Could not find a package configuration file provided by "MUMPS" with any of
  the following names:

    MUMPSConfig.cmake
    mumps-config.cmake

  Add the installation prefix of "MUMPS" to CMAKE_PREFIX_PATH or set
  "MUMPS_DIR" to a directory containing one of the above files.  If "MUMPS"
  provides a separate development package or SDK, be sure it has been
  installed.
Call Stack (most recent call first):
  CMakeLists.txt:73 (find_package)

[scivision]

1. OK good to hear
2. That's a vcpkg.cmake problem, nothing to do with this MUMPS CMake package. Microsoft needs to fix their vcpkg.cmake to handle native \ slashes.
3. Is your project on GitHub so that I could try it out? I haven't seen this missing ifconsol.lib issue. I am wondering if your program mixes C and Fortran code in one target and the MUMPS examples don't do that. Also, I wonder if removing the command line for vcpkg.cmake might help some issues.
4. MSYS2 (and most other compliers) work if building MUMPS CMake. However, the obselete FindMUMPS.cmake doesn't work with MSYS2 distro package of MUMPS (nor Ubuntu, etc). It was too much of a maintenance burden. For computational performance, I simply build my own MUMPS wherever I use MUMPS.

[zoharl3]

2. Microsoft needs to fix a lot of things...
3. This is my project: test.zip. It's my basic test project. Working without vcpkg would be a hassle.

[zoharl3]

Further tips.

It worked fine for small matrices but failed for large ones. In turns out that it found the wrong mkl dlls in the path.

The performance with the optional ordering libs is better. scotch seems to run the same time as metis for fact&solve, but it's faster for analysis.
To install them, everything needs to be x64, and I built them from the source.

---

GKlib

I added #include <io.h> to io.c.

I commented out the code inside

#ifndef MACOS
...
#endif

in
C:\prj-external-libs\METIS\programs\gpmetis.c
C:\prj-external-libs\METIS\programs\ndmetis.c
C:\prj-external-libs\METIS\programs\mpmetis.c

run_cmake.bat

mkdir build

call c:/oneAPI/setvars.bat
set "MKLROOT=%MKLROOT:\=/%"

cmake ^
-DCMAKE_BUILD_TYPE=Release ^
-DCMAKE_C_COMPILER=icx ^
-Wno-dev -G Ninja -B build

---

metis

run_cmake.bat

mkdir build

MKDIR build\xinclude
COPY include\metis.h build\xinclude
COPY include\CMakeLists.txt build\xinclude

call c:/oneAPI/setvars.bat
set "MKLROOT=%MKLROOT:\=/%"

cmake ^
-DCMAKE_C_FLAGS="-DIDXTYPEWIDTH=64 -DREALTYPEWIDTH=64" ^
-DGKLIB_PATH=c:/prj-external-libs/GKlib/build/GKlib/ ^
-DCMAKE_BUILD_TYPE=Release ^
-Wno-dev -G Ninja -B build

ninja didn't build the .exe, and I copied metis.lib manually to /lib.
I also copied there c:\prj-external-libs\GKlib\build\GKlib\lib\GKlib.lib.

---

scotch

• ninja installed into
  C:/Program Files (x86)/SCOTCH
  which I moved to
  c:\prj-external-libs\scotch\build\

• I removed
  c:\prj-external-libs\scotch\build\local\include\metis.h
  It's just for compatibility, it makes trouble, and need to original.

run_cmake.bat

mkdir build

call c:/oneAPI/setvars.bat
set "MKLROOT=%MKLROOT:\=/%"

cmake ^
-DINTSIZE=64 ^
-DBUILD_PTSCOTCH=OFF ^
-DCMAKE_BUILD_TYPE=Release ^
-DCMAKE_Fortran_COMPILER=ifx ^
-DCMAKE_C_COMPILER=icx ^
-DCMAKE_TOOLCHAIN_FILE=d:/vcpkg/scripts/buildsystems/vcpkg.cmake ^ -DVCPKG_TARGET_TRIPLET=x64-windows ^
-Wno-dev -G Ninja -B build

---

mumps

run_cmake.bat

mkdir build

call c:/oneAPI/setvars.bat
rem Replace foreslashes with backslashes
set "MKLROOT=%MKLROOT:\=/%"

set METIS_ROOT=c:/prj-external-libs/METIS/
set SCOTCH_ROOT=c:/prj-external-libs/scotch/build/SCOTCH/

cmake ^
-Dintsize64=on ^
-Dmetis=on ^
-DCMAKE_C_FLAGS="-DIDXTYPEWIDTH=64 -DREALTYPEWIDTH=64" ^
-Dscotch=on ^
-DMUMPS_openmp=on ^
-DMUMPS_BUILD_TESTING=off ^
-DBUILD_SINGLE=no ^
-DBUILD_DOUBLE=yes ^
-DBUILD_COMPLEX=no ^
-DBUILD_COMPLEX16=no ^
-DMUMPS_parallel=no ^
-DCMAKE_BUILD_TYPE=Release ^
-DCMAKE_Fortran_COMPILER=ifx ^
-DCMAKE_C_COMPILER=icx ^
-DCMAKE_CXX_COMPILER=icx ^
-Wno-dev -G Ninja -B build

---

A project that uses mumps

run_cmake.bat

mkdir build

set MUMPS_ROOT=c:/prj-external-libs/mumps/build/local/
set SCOTCH_ROOT=c:/prj-external-libs/scotch/build/SCOTCH/
set METIS_ROOT=c:/prj-external-libs/METIS/

cmake ^
-DCMAKE_BUILD_TYPE=Release ^
-DCMAKE_TOOLCHAIN_FILE=d:/vcpkg/scripts/buildsystems/vcpkg.cmake ^ -DVCPKG_TARGET_TRIPLET=x64-windows ^
-Wno-dev -B build

CMakeLists.txt

    # needs -DMUMPS_ROOT=c:/prj-external-libs/mumps/build/local/
    find_package( MUMPS CONFIG REQUIRED )
    
    target_link_libraries( ${PRJ_NAME} PRIVATE MUMPS::MUMPS )
    
    # ?? it wrongly adds c:/oneAPI/compiler/latest/lib/$(Configuration)
    message( "MKLROOT=${MKLROOT}" )
    target_link_directories( ${PRJ_NAME} PRIVATE ${MKL_ROOT}/../../compiler/latest/lib/ )
    
    # for metis
    message( "METIS_ROOT=$ENV{METIS_ROOT}" )
    target_link_libraries( ${PRJ_NAME} PRIVATE $ENV{METIS_ROOT}/lib/GKlib.lib )