Hendrik/xgboost
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

Update OSX build instructions (#2784)

Browse Source 
* Update xgboost build for OS X

* Add notes on gcc and brew

* Update build.md

* Update build.md

* Update build.md
This commit is contained in:
Dat Le 2017-11-06 04:07:10 -08:00 committed by Sergei Lebedev
parent 78d0bd6c9d
commit 77ae4c8701
1 changed files with 17 additions and 15 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

32
doc/build.md
View File

@ -57,21 +57,29 @@ git clone --recursive https://github.com/dmlc/xgboost
cd xgboost; make -j4 cd xgboost; make -j4
``` ```
### Building on OSX ### Building on Mac OS X
On OSX, one builds xgboost by **Install with pip - simple method**
First, make sure you obtained *gcc-5* (newer version does not work with this method yet). Note: installation of `gcc` can take a while (~ 30 minutes)
```bash ```bash
git clone --recursive https://github.com/dmlc/xgboost brew install gcc5
cd xgboost; cp make/minimum.mk ./config.mk; make -j4
``` ```
This builds xgboost without multi-threading, because by default clang in OSX does not come with open-mp. You might need to run the following command with `sudo` if you run into some permission errors:
See the following paragraph for OpenMP enabled xgboost.
```bash
pip install xgboost
```
Here is the complete solution to use OpenMP-enabled compilers to install XGBoost. **Build from the source code - advanced method**
Obtain gcc-6.x.x with openmp support by `brew install gcc --without-multilib`. (`brew` is the de facto standard of `apt-get` on OS X. So installing [HPC](http://hpc.sourceforge.net/) separately is not recommended, but it should work.). Installation of `gcc` can take a while (~ 30 minutes)
First, obtain gcc-7.x.x with brew (https://brew.sh/) if you want multi-threaded version, otherwise, Clang is ok if OpenMP / multi-threaded is not required. Note: installation of `gcc` can take a while (~ 30 minutes)
```bash
brew install gcc
```
Now, clone the repository Now, clone the repository
@ -84,13 +92,7 @@ and build using the following commands
```bash ```bash
cd xgboost; cp make/config.mk ./config.mk; make -j4 cd xgboost; cp make/config.mk ./config.mk; make -j4
``` ```
head over to `Python Package Installation` for the next steps
NOTE:
If you use OSX El Capitan, brew installs gcc the latest version gcc-6. So you may need to modify Makefile#L46 and change gcc-5 to gcc-6. After that change gcc-5/g++-5 to gcc-6/g++-6 in make/config.mk then build using the following commands
```bash
cd xgboost; cp make/config.mk ./config.mk; make -j4
```
### Building on Windows ### Building on Windows
You need to first clone the xgboost repo with recursive option clone the submodules. You need to first clone the xgboost repo with recursive option clone the submodules.