Merge branch 'hipo-ci' into readme-links

Author: galabovaa

.github/workflows/hipo-fetch.yml

@@ -115,7 +115,8 @@ jobs:
             -DCMAKE_CXX_COMPILER=g++ \
             -DCMAKE_C_FLAGS="-m32" \
             -DCMAKE_CXX_FLAGS="-m32" \
-            -DCMAKE_SHARED_LINKER_FLAGS="-m32"
+            -DCMAKE_SHARED_LINKER_FLAGS="-m32" \
+            -DALL_TESTS=${{ matrix.all_tests }}
 
       - name: Build
         working-directory: ${{runner.workspace}}/build
@@ -207,7 +208,8 @@ jobs:
         run: |
           export CC=arm-linux-gnueabihf-gcc
           export CXX=arm-linux-gnueabihf-g++
-          cmake $GITHUB_WORKSPACE
+          cmake $GITHUB_WORKSPACE \
+            -DALL_TESTS=${{ matrix.all_tests }}
 
       - name: Build
         working-directory: ${{runner.workspace}}/build

check/CMakeLists.txt

@@ -286,9 +286,16 @@ if ((NOT FAST_BUILD OR ALL_TESTS) AND NOT (BUILD_EXTRA_UNIT_ONLY))
   #   "--parallel=on"
       )
 
+  if(CMAKE_SIZEOF_VOID_P EQUAL 4) OR if(CMAKE_C_FLAGS MATCHES "-m32" OR CMAKE_CXX_FLAGS MATCHES "-m32")
+    set(IS_32 ON)
+  else()
+    set(IS_32 OFF)
+  endif()
+
   if (UNIX AND NOT APPLE AND
         NOT CMAKE_CXX_COMPILER_ID STREQUAL "IntelLLVM"
-        AND CMAKE_SYSTEM_PROCESSOR MATCHES "x86_64|amd64")
+        AND CMAKE_SYSTEM_PROCESSOR MATCHES "x86_64|amd64"
+        AND NOT IS_32)
     if (CUPDLP_GPU)
         set(pdlpInstances
             "25fv47\; 5.501847\;"
@@ -442,7 +449,7 @@ if ((NOT FAST_BUILD OR ALL_TESTS) AND NOT (BUILD_EXTRA_UNIT_ONLY))
         add_instancetests(successRiscVInstances "Optimal")
     endif()
   elseif(NOT (CMAKE_SYSTEM_PROCESSOR MATCHES "arm|aarch64") AND
-             NOT (CMAKE_SIZEOF_VOID_P EQUAL 4))
+             NOT IS_32)
     add_instancetests(successInstances "Optimal")
   endif()
 

docs/src/installation.md

@@ -7,43 +7,63 @@ HiGHS uses CMake as build system, and requires at least version
 
 ## HiGHS with HiPO
 
-HiGHS does not have any external dependencies, however, the new interior point solver HiPO uses BLAS. At the moment HiPO is optional and can be enabled via CMake. To build HiPO, you need to have BLAS installed on your machine. Please follow the instructions below.
+HiGHS does not have any external dependencies, however, the new interior point solver HiPO uses BLAS. At the moment HiPO is optional and can be enabled via CMake.
 
-#### BLAS
+### External ordering heuristics
 
-On Linux, libblas and libopenblas are supported. We recomment libopenblas for its better performance, and it is found by default if available on the system. Install with
+HiPO also relies on a fill-reducing ordering heuristic. HiGHS includes the source code of Metis, AMD and RCM, three open-source ordering heuristics. Their source code is already part of the HiGHS library, so there is no need to link them. In particular, there is no need to have Metis installed separately, as in previous versions of HiPO. These source codes can be found in extern/metis, extern/amd, extern/rcm, together with the respective license files. Notice that the HiGHS source code is MIT licensed. However, if you build HiGHS with HiPO support, then libhighs and the HiGHS executables are licensed Apache 2.0, due to the presence of Metis and AMD.
 
-```
-sudo apt update
-sudo apt install libopenblas-dev
-```
+### BLAS
 
 On MacOS no BLAS installation is required because HiPO uses [Apple Accelerate](https://developer.apple.com/accelerate/) by default.
 
-On Windows, OpenBLAS is required. It could be installed via [vcpkg](https://learn.microsoft.com/en-us/vcpkg/get_started/overview) with
+On Windows and Linux, you can either compile OpenBLAS at configure time using the option `-DBUILD_OPENBLAS=ON` (`OFF` by default) or compile BLAS using the instructions below.
+
+#### MacOS
 
+To build HiPO on MacOS, run
 ```
-vcpkg install openblas[threads]
+cmake -S. -B build -DHIPO=ON
 ```
-Note, that `[threads]` is required for HiPO.
 
-To specify explicitly which BLAS vendor to look for, `BLA_VENDOR` coud be set in CMake, e.g. `-DBLA_VENDOR=Apple` or `-DBLA_VENDOR=OpenBLAS`. Alternatively, to specify which BLAS library to use, set `BLAS_LIBRARIES` to the full path of the library e.g. `-DBLAS_LIBRARIES=/path_to/libopenblas.so`.
+#### Linux and Windows: Compile OpenBLAS at configure time
 
-#### External ordering heuristics
+```
+cmake -S. -B build -DHIPO=ON -DBUILD_OPENBLAS=ON
+```
 
-HiPO also relies on a fill-reducing ordering heuristic. HiGHS includes the source code of Metis, AMD and RCM, three open-source ordering heuristics. Their source code is already part of the HiGHS library, so there is no need to link them. In particular, there is no need to have Metis installed separately, as in previous versions of HiPO. These source codes can be found in extern/metis, extern/amd, extern/rcm, together with the respective license files. Notice that the HiGHS source code is MIT licensed. However, if you build HiGHS with HiPO support, then libhighs and the HiGHS executables are licensed Apache 2.0, due to the presence of Metis and AMD. 
+#### Linux and Windows: Link with BLAS installatied on your machine
 
-### HiPO
+On Linux, libblas and libopenblas are supported. We recommend libopenblas for its better performance, and it is found by default if available on the system. Install with
+
+```
+sudo apt update
+sudo apt install libopenblas-dev
+```
 
-To install HiPO, on Linux and MacOS, run
+To build HiPO, run
 ```
 cmake -S. -B build -DHIPO=ON
 ```
+
+On Windows, OpenBLAS is required. It could be installed via [vcpkg](https://learn.microsoft.com/en-us/vcpkg/get_started/overview) with
+
+```
+vcpkg install openblas[threads]
+```
+
+Note, that `[threads]` is required for HiPO.
+
 On Windows, you also need to specify the path to OpenBLAS. If it was installed with vcpkg as suggested above, add the path to `vcpkg.cmake` to the CMake flags, e.g.
 ```
--DCMAKE_TOOLCHAIN_FILE="C:/vcpkg/scripts/buildsystems/vcpkg.cmake"
+cmake -S. -B build -DHIPO=ON -DCMAKE_TOOLCHAIN_FILE="C:/vcpkg/scripts/buildsystems/vcpkg.cmake"
 ```
 
+##### Path to BLAS
+
+To specify explicitly which BLAS vendor to look for, `BLA_VENDOR` coud be set in CMake, e.g. `-DBLA_VENDOR=Apple` or `-DBLA_VENDOR=OpenBLAS`. Alternatively, to specify which BLAS library to use, set `BLAS_LIBRARIES` to the full path of the library e.g. `-DBLAS_LIBRARIES=/path_to/libopenblas.so`.
+
+
 ## Bazel build
 
 Alternatively, building with Bazel is supported for Bazel-based projects. To build HiGHS, from the root directory, run