GPBoost Python Package
This is the Python package implementation of the GPBoost library. See https://github.com/fabsig/GPBoost for more information on the modeling background and the software implementation.
Table of Contents
Examples and documentation
- Python examples
- GPBoost / LaGaBoost algorithm for Gaussian ("regression") and non-Gaussian likelihoods (e.g., "classification", etc.)
- Generalized linear Gaussian process and mixed effects models
- The documentation at https://gpboost.readthedocs.io
Installation
Before you install
-
setuptools is needed. You can install this using
pip install setuptools -U -
32-bit Python is not supported. Please install the 64-bit version. See build 32-bit version with 32-bit Python section.
Installation from PyPI using precompiled binaries
pip install gpboost -U
Requirements
-
For Windows users, VC runtime is needed if Visual Studio (2015 or newer) is not installed.
-
For Linux users, glibc >= 2.14 is required.
-
If you get an error message
version `GLIBC_2.27' not found, you need to install from source. -
In rare cases, when you get the
OSError: libgomp.so.1: cannot open shared object file: No such file or directoryerror when importing GPBoost, you need to install the OpenMP runtime library separately (use your package manager and search forlib[g|i]ompfor doing this).
-
-
For macOS users:
-
The library file in distribution wheels is built by the Apple Clang compiler. You need to install the OpenMP library. You can install the OpenMP library by the following command:
brew install libomp. -
If you have an arm64 Apple silicon processor (e.g., M1 or M2) and experience problems, try the following steps:
- uninstall homebrew (in case you have migrated from an older non-arm64 Mac)
- install homebrew (to make sure that you have an arm64 version of libomp)
- install OpenMP (
brew install libomp) - remove existing python environments and install Miniforge (
brew install miniforgeandconda init "$(basename "${SHELL}")")
-
Installation from source
Installation from source can be either done from PyPI or GitHub.
Requirements for installation from source
-
Installation from source requires that you have installed CMake.
-
For Linux users, glibc >= 2.14 is required.
- In rare cases, you may need to install the OpenMP runtime library separately (use your package manager and search for
lib[g|i]ompfor doing this).
- In rare cases, you may need to install the OpenMP runtime library separately (use your package manager and search for
-
For macOS users, you can perform installation either with Apple Clang or gcc.
-
In case you prefer Apple Clang, you should install OpenMP (details for installation can be found in the Installation Guide) first and CMake version 3.16 or higher is required. Only Apple Clang version 8.1 or higher is supported.
-
In case you prefer gcc, you need to install it (details for installation can be found in the Installation Guide) and specify compilers by running
export CXX=g++-7 CC=gcc-7(replace "7" with the version of gcc installed on your machine) first.
-
-
For Windows users, Visual Studio (or VS Build Tools) is needed.
Installation from source from PyPI
pip install --no-binary :all: gpboost
Build with MinGW-w64 on Windows
set GPBOOST_MINGW=1
pip install --no-binary :all: gpboost
(in PowerShell, use $env:GPBOOST_MINGW = "1" instead of set GPBOOST_MINGW=1)
Installation from source from GitHub
git clone --recursive https://github.com/fabsig/GPBoost.git
cd GPBoost/python-package
# export CXX=g++-7 CC=gcc-7 # macOS users, if you decided to compile with gcc, don't forget to specify compilers (replace "7" with version of gcc installed on your machine)
python -m pip install .
Build with MinGW-w64 on Windows
set GPBOOST_MINGW=1
python -m pip install .
(in PowerShell, use $env:GPBOOST_MINGW = "1" instead of set GPBOOST_MINGW=1)
Build options
Build options are set via environment variables of the form GPBOOST_<OPTION>, e.g. GPBOOST_MINGW=1 or GPBOOST_CUDAGP=1. Note that python setup.py install --<option> and pip install --install-option=--<option> do not work anymore since these mechanisms have been removed from setuptools and pip.
Build CUDA Version
git clone --recursive https://github.com/fabsig/GPBoost.git
cd GPBoost/python-package
GPBOOST_CUDAGP=1 python -m pip install .
GPBOOST_CUDAGP=1 (CMake option USE_CUDA_GP) enables CUDA acceleration for the Gaussian process and mixed effects model parts, which is what the GPU_use = True argument of GPModel requires. This is different from GPBOOST_CUDA=1 (CMake option USE_CUDA), which enables the experimental CUDA version of the tree boosting part inherited from LightGBM.
For macOS and Windows users, the CUDA version is not supported.
CUDA library is needed: details for installation can be found in Installation Guide.
1 maintainer
Metadata
1 maintainer
Release files for gpboost 1.7.4
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| gpboost-1.7.4.tar.gz | 2.3 MB | Details |
Built distributions (wheels)
| File | Reset | |||
|---|---|---|---|---|
| gpboost-1.7.4-py3-none-win_amd64.whl | Python 3 | none | Windows x86-64 | Details |
| gpboost-1.7.4-py3-none-manylinux_2_27_x86_64.whl | Python 3 | none | Linux glibc 2.27+ x86-64 | Details |
| gpboost-1.7.4-py3-none-macosx_12_0_arm64.whl | Python 3 | none | macOS 12.0+ ARM64 | Details |
| gpboost-1.7.4-py3-none-macosx_10_9_x86_64.whl | Python 3 | none | macOS 10.9+ x86-64 | Details |
Total release size: 23.8 MB
Release files / gpboost-1.7.4.tar.gz
| Download URL | gpboost-1.7.4.tar.gz |
|---|---|
| Size | 2.3 MB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
e980890ce1904d7ec795cfd62efd5cac6e1d8e3a2ab7c7c86f6076c0b9541fbd
|
|
BLAKE2b-256 checksum How to use checksums |
44d2eba1b2087a07f270e6ca337c8c4811d4a055220d4dfde5202a46b86f014c
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.14.6
|
Release files / gpboost-1.7.4-py3-none-win_amd64.whl
| Download URL | gpboost-1.7.4-py3-none-win_amd64.whl |
|---|---|
| Size | 3.1 MB |
| Tags | Python 3 Windows x86-64 |
|
SHA-256 checksum How to use checksums |
6d282d0ce620a5456f646a0edebe826f2e2030427a8ffc5f44d66f93f4dce552
|
|
BLAKE2b-256 checksum How to use checksums |
dd0b0d7866b67596581eef26c4ae7be761dd03d69a63bd2f57db72116e4a7d8d
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.14.6
|
Release files / gpboost-1.7.4-py3-none-manylinux_2_27_x86_64.whl
| Download URL | gpboost-1.7.4-py3-none-manylinux_2_27_x86_64.whl |
|---|---|
| Size | 6.4 MB |
| Tags | Linux glibc 2.27+ x86-64 Python 3 |
|
SHA-256 checksum How to use checksums |
0008756995cbf772cf9ed0ef38673fbd8497a7a566dfdced7942c200d471e144
|
|
BLAKE2b-256 checksum How to use checksums |
5aaad40e919601f1fdaff4f5bd624bf87882d471986b5ebffdf863df2359c5b0
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.14.6
|
Release files / gpboost-1.7.4-py3-none-macosx_12_0_arm64.whl
| Download URL | gpboost-1.7.4-py3-none-macosx_12_0_arm64.whl |
|---|---|
| Size | 5.7 MB |
| Tags | Python 3 macOS 12.0+ ARM64 |
|
SHA-256 checksum How to use checksums |
6fc3cdcf43c625121ec113c6e02863f401b098f64b3c23a974aae6d89b1f8982
|
|
BLAKE2b-256 checksum How to use checksums |
ef25b965984b71487b278170b91ad4e2b6b9f802903963304667e6efc16637e3
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.14.6
|
Release files / gpboost-1.7.4-py3-none-macosx_10_9_x86_64.whl
| Download URL | gpboost-1.7.4-py3-none-macosx_10_9_x86_64.whl |
|---|---|
| Size | 6.3 MB |
| Tags | Python 3 macOS 10.9+ x86-64 |
|
SHA-256 checksum How to use checksums |
8933255798f8aec44e8fbe8387ca995bda5be2008665bdf66bdbbc6718165d82
|
|
BLAKE2b-256 checksum How to use checksums |
d8f11ae619a0f7795fe968a4d2338481d621011795fb806dc747dda016113936
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.14.6
|
