beacls: berkeley efficient api in c++ for level set
TRANSCRIPT
![Page 1: BEACLS: Berkeley Efficient API in C++ for Level Set](https://reader036.vdocuments.us/reader036/viewer/2022071219/62cc0e9d78a9fa52cb42af67/html5/thumbnails/1.jpg)
BEACLS: Berkeley Efficient API in C++ for Level Set methods
Installation GuideKen TANABE
2017/04/11
2017/4/11BEACLS: Berkeley Efficient API in C++ for Level Set methods
Installation Guide1
![Page 2: BEACLS: Berkeley Efficient API in C++ for Level Set](https://reader036.vdocuments.us/reader036/viewer/2022071219/62cc0e9d78a9fa52cb42af67/html5/thumbnails/2.jpg)
Table of contents
System requirement
Mac OS X
Ubuntu Linux without GPU
Ubuntu Linux with GPU
Windows without GPU
Windows with GPU
Bash on Ubuntu on Windows without GPU
2017/4/11BEACLS: Berkeley Efficient API in C++ for Level Set methods
Installation Guide2
![Page 3: BEACLS: Berkeley Efficient API in C++ for Level Set](https://reader036.vdocuments.us/reader036/viewer/2022071219/62cc0e9d78a9fa52cb42af67/html5/thumbnails/3.jpg)
Table of contents
System requirement
Mac OS X
Ubuntu Linux without GPU
Ubuntu Linux with GPU
Windows without GPU
Windows with GPU
Bash on Ubuntu on Windows without GPU
2017/4/11BEACLS: Berkeley Efficient API in C++ for Level Set methods
Installation Guide3
![Page 4: BEACLS: Berkeley Efficient API in C++ for Level Set](https://reader036.vdocuments.us/reader036/viewer/2022071219/62cc0e9d78a9fa52cb42af67/html5/thumbnails/4.jpg)
System requirements
Required OS
Mac OS X Sierra Ubuntu Linux 16.04 LTS (x86_64) Windows 7/8.1/10 (64bit)
Hardware CPU: Intel Core Processor CPU
Recommended Hardware
CPU: 4th Generation Intel Core Processor CPU (Haswell arch.) or later GPU: NVIDIA GeForce 900 Series GPU (Maxwell arch) or later
OS Windows 10 Creators Update (version 1703, Redstone 2)
Required for Bash on Ubuntu on Windows
2017/4/11BEACLS: Berkeley Efficient API in C++ for Level Set methods
Installation Guide4
![Page 5: BEACLS: Berkeley Efficient API in C++ for Level Set](https://reader036.vdocuments.us/reader036/viewer/2022071219/62cc0e9d78a9fa52cb42af67/html5/thumbnails/5.jpg)
Table of contents
System requirement
Mac OS X
Ubuntu Linux without GPU
Ubuntu Linux with GPU
Windows without GPU
Windows with GPU
Bash on Ubuntu on Windows without GPU
2017/4/11BEACLS: Berkeley Efficient API in C++ for Level Set methods
Installation Guide5
![Page 6: BEACLS: Berkeley Efficient API in C++ for Level Set](https://reader036.vdocuments.us/reader036/viewer/2022071219/62cc0e9d78a9fa52cb42af67/html5/thumbnails/6.jpg)
Install to Mac OS X Sierra
1. Install Homeberw$ export PATH=/usr/local:$PATH $ sudo mkdir -p /usr/local$ ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"
2. Install OpenMP, boost, OpenCV and hdf5$ brew update; brew upgrade$ brew install llvm boost hdf5$ brew install -with-ffmpeg -with-tbb opencv3$ brew link opencv3 --force
3. Download BEACLS$ mkdir ~/BEACLS; cd ~/BEACLS$ git clone https://github.com/HJReachability/beacls$ cd beacls
4. Build BEACLS$ cd beacls/sources$ make all
5. Test BEACLS$ cd samples/Plane_test$ make test
2017/4/11BEACLS: Berkeley Efficient API in C++ for Level Set methods
Installation Guide6
![Page 7: BEACLS: Berkeley Efficient API in C++ for Level Set](https://reader036.vdocuments.us/reader036/viewer/2022071219/62cc0e9d78a9fa52cb42af67/html5/thumbnails/7.jpg)
Table of contents
System requirement
Mac OS X
Ubuntu Linux without GPU
Ubuntu Linux with GPU
Windows without GPU
Windows with GPU
Bash on Ubuntu on Windows without GPU
2017/4/11BEACLS: Berkeley Efficient API in C++ for Level Set methods
Installation Guide7
![Page 8: BEACLS: Berkeley Efficient API in C++ for Level Set](https://reader036.vdocuments.us/reader036/viewer/2022071219/62cc0e9d78a9fa52cb42af67/html5/thumbnails/8.jpg)
Install to Ubuntu Linux 16.04 LTS(Without GPU)1. Install boost, OpenCV and hdf5
$ sudo apt update$ sudo apt upgrade$ sudo apt install libhdf5-dev libboost-dev libopencv-dev
2. Download BEACLS$ mkdir ~/BEACLS; cd ~/BEACLS$ git clone https://github.com/HJReachability/beacls$ cd beacls
3. Build BEACLS$ cd beacls/sources$ make all
4. Test BEACLS$ cd samples/Plane_test$ make test
2017/4/11BEACLS: Berkeley Efficient API in C++ for Level Set methods
Installation Guide8
These instructions only work for Ubuntu 16.04, not 18.04!
For Ubuntu 14.04, use branch 14.04.
![Page 9: BEACLS: Berkeley Efficient API in C++ for Level Set](https://reader036.vdocuments.us/reader036/viewer/2022071219/62cc0e9d78a9fa52cb42af67/html5/thumbnails/9.jpg)
Table of contents
System requirement
Mac OS X
Ubuntu Linux without GPU
Ubuntu Linux with GPU
Windows without GPU
Windows with GPU
Bash on Ubuntu on Windows without GPU
2017/4/11BEACLS: Berkeley Efficient API in C++ for Level Set methods
Installation Guide9
![Page 10: BEACLS: Berkeley Efficient API in C++ for Level Set](https://reader036.vdocuments.us/reader036/viewer/2022071219/62cc0e9d78a9fa52cb42af67/html5/thumbnails/10.jpg)
Install to Ubuntu Linux 16.04 LTS(With GPU)1. Install zlib, boost, OpenCV and hdf5
$ sudo apt-get update$ sudo apt-get upgrade$ sudo apt-get install zlib libhdf5-dev libboost-dev libopencv-dev
2. Download and install CUDA 8.0https://developer.nvidia.com/cuda-downloads
3. Download BEACLS$ mkdir ~/BEACLS; cd ~/BEACLS$ git clone https://github.com/HJReachability/beacls$ cd beacls
4. Build BEACLS$ cd beacls/sources$ make WITH_GPU=Y NVCC=/usr/local/cuda-8.0/bin/nvcc all
5. Test BEACLS$ cd samples/Plane_test$ make test
2017/4/11BEACLS: Berkeley Efficient API in C++ for Level Set methods
Installation Guide10
![Page 11: BEACLS: Berkeley Efficient API in C++ for Level Set](https://reader036.vdocuments.us/reader036/viewer/2022071219/62cc0e9d78a9fa52cb42af67/html5/thumbnails/11.jpg)
Table of contents
System requirement
Mac OS X
Ubuntu Linux without GPU
Ubuntu Linux with GPU
Windows without GPU
Windows with GPU
Bash on Ubuntu on Windows without GPU
2017/4/11BEACLS: Berkeley Efficient API in C++ for Level Set methods
Installation Guide11
![Page 12: BEACLS: Berkeley Efficient API in C++ for Level Set](https://reader036.vdocuments.us/reader036/viewer/2022071219/62cc0e9d78a9fa52cb42af67/html5/thumbnails/12.jpg)
Install to Windows 7/8.1/10 (Without GPU)
1. Download and install HDF5 Pre-built Binary Distributions1. Download binary distribution from HDF group site
https://www.hdfgroup.org/HDF5/release/obtain5.html 1.8.18-win64-vs2015: http://www.hdfgroup.org/ftp/HDF5/current/bin/windows/extra/hdf5-1.8.18-
win64-vs2015-shared.zip2. Extract a zip file and install it.
2. Download and install Boost1. Download binary distribution from the site: http://www.boost.org/users/download/
1.63.0: https://sourceforge.net/projects/boost/files/boost/1.63.0/boost_1_63_0.zip/download2. Extract a zip file to c:\Boost\Boost_1_63_0
3. Download and install OpenCV1. Download binary distribution from the site: http://opencv.org/
3.2.0: https://sourceforge.net/projects/opencvlibrary/files/opencv-win/3.2.0/opencv-3.2.0-vc14.exe/download
2. Execute installer and extract files to c:\OpenCV3\opencv3.2.0
2017/4/11BEACLS: Berkeley Efficient API in C++ for Level Set methods
Installation Guide12
![Page 13: BEACLS: Berkeley Efficient API in C++ for Level Set](https://reader036.vdocuments.us/reader036/viewer/2022071219/62cc0e9d78a9fa52cb42af67/html5/thumbnails/13.jpg)
Install to Windows 7/8.1/10 (Without GPU) (cont'd.)4. Download and install git for Windows
1. Download binary distribution from the site : https://git-for-windows.github.io/ 2.12.0-64bit: https://github.com/git-for-
windows/git/releases/download/v2.12.0.windows.1/Git-2.12.0-64-bit.exe
2. Execute installer
5. Download and install tortoisegit1. Download Boost from Boost site: https://tortoisegit.org/
2.4.0.2-64bit: https://download.tortoisegit.org/tgit/2.4.0.0/TortoiseGit-2.4.0.2-64bit.msi
2. Execute installer
6. Download and install Visual Studio 2015https://www.visualstudio.com/vs/older-downloads/
2017/4/11BEACLS: Berkeley Efficient API in C++ for Level Set methods
Installation Guide13
![Page 14: BEACLS: Berkeley Efficient API in C++ for Level Set](https://reader036.vdocuments.us/reader036/viewer/2022071219/62cc0e9d78a9fa52cb42af67/html5/thumbnails/14.jpg)
Install to Windows 7/8.1/10 (Without GPU) (cont'd.)7. Download BEACLS
1. Open Documents folder by explorer
2. Choose “Git clone…” from cotext memu.
3. Set repository information and push OKURL: https://github.com/HJReachability/beacls
4. Open beacls folder
2017/4/11BEACLS: Berkeley Efficient API in C++ for Level Set methods
Installation Guide14
![Page 15: BEACLS: Berkeley Efficient API in C++ for Level Set](https://reader036.vdocuments.us/reader036/viewer/2022071219/62cc0e9d78a9fa52cb42af67/html5/thumbnails/15.jpg)
Install to Windows 7/8.1/10 (Without GPU) (cont'd.)8. Build matio (Matlab file I/O library)
1. Run Visual Studio solution from the batch file sources\run_visualstudio14_matio.bat
It sets environmental variables for some libraries paths.
2. Choose “Release” as Solution Configuration and “x64” as Solution Platform
3. Build matio by pushing “F7” key.
2017/4/11BEACLS: Berkeley Efficient API in C++ for Level Set methods
Installation Guide15
![Page 16: BEACLS: Berkeley Efficient API in C++ for Level Set](https://reader036.vdocuments.us/reader036/viewer/2022071219/62cc0e9d78a9fa52cb42af67/html5/thumbnails/16.jpg)
Install to Windows 7/8.1/10 (Without GPU) (cont'd.)9. Build BEACLS
1. Run Visual Studio solution from the batch file sources\run_visualstudio14_beacls.bat
It sets environmental variables for some libraries paths.
2. Choose “Release” as Solution Configuration and “x64” as Solution Platform
3. Build all projects of beacls solution by pushing “F7” key.
2017/4/11BEACLS: Berkeley Efficient API in C++ for Level Set methods
Installation Guide16
![Page 17: BEACLS: Berkeley Efficient API in C++ for Level Set](https://reader036.vdocuments.us/reader036/viewer/2022071219/62cc0e9d78a9fa52cb42af67/html5/thumbnails/17.jpg)
Install to Windows 7/8.1/10 (Without GPU) (cont'd.)10. Execute Plane_test
1. Click “Set as StartUp Project” from a context menu of Plane_test in Solution Explorer
2. Execute Plane_test by pushing “F5” key.
2017/4/11BEACLS: Berkeley Efficient API in C++ for Level Set methods
Installation Guide17
![Page 18: BEACLS: Berkeley Efficient API in C++ for Level Set](https://reader036.vdocuments.us/reader036/viewer/2022071219/62cc0e9d78a9fa52cb42af67/html5/thumbnails/18.jpg)
Table of contents
System requirement
Mac OS X
Ubuntu Linux without GPU
Ubuntu Linux with GPU
Windows without GPU
Windows with GPU
Bash on Ubuntu on Windows without GPU
2017/4/11BEACLS: Berkeley Efficient API in C++ for Level Set methods
Installation Guide18
![Page 19: BEACLS: Berkeley Efficient API in C++ for Level Set](https://reader036.vdocuments.us/reader036/viewer/2022071219/62cc0e9d78a9fa52cb42af67/html5/thumbnails/19.jpg)
Install to Windows 7/8.1/10 (With GPU)
Install from step 1 to step 8 of Windows 7/8.1/10 (without GPU)
9. Download and install CUDA 8.0https://developer.nvidia.com/cuda-downloads
2017/4/11BEACLS: Berkeley Efficient API in C++ for Level Set methods
Installation Guide19
![Page 20: BEACLS: Berkeley Efficient API in C++ for Level Set](https://reader036.vdocuments.us/reader036/viewer/2022071219/62cc0e9d78a9fa52cb42af67/html5/thumbnails/20.jpg)
Install to Windows 7/8.1/10 (With GPU) (cont'd.)10. Build BEACLS
1. Run Visual Studio solution from the batch file sources\run_visualstudio14_beacls_cuda.bat
It sets environmental variables for some libraries paths.
2. Run Visual Studio solution from the batch file
2017/4/11BEACLS: Berkeley Efficient API in C++ for Level Set methods
Installation Guide20
![Page 21: BEACLS: Berkeley Efficient API in C++ for Level Set](https://reader036.vdocuments.us/reader036/viewer/2022071219/62cc0e9d78a9fa52cb42af67/html5/thumbnails/21.jpg)
Install to Windows 7/8.1/10 (With GPU) (cont'd.)
2017/4/11BEACLS: Berkeley Efficient API in C++ for Level Set methods
Installation Guide21
10. Build BEACLS (Cont’d)3. Enable CUDA build for levelset project.
1. Choose “levelset” in Solution Explorer
2. click “Builld Customizations…” from Project tab of tool bar.
3. Enable “CUDA 8.0(.targets, .props)”
4. Enable CUDA build for helperOC project.
![Page 22: BEACLS: Berkeley Efficient API in C++ for Level Set](https://reader036.vdocuments.us/reader036/viewer/2022071219/62cc0e9d78a9fa52cb42af67/html5/thumbnails/22.jpg)
Install to Windows 7/8.1/10 (With GPU) (cont'd.)10. Build BEACLS
5. Choose “Release” as Solution Configuration and “x64” as Solution Platform
6. Build all projects of beacls solution by pushing “F7” key.
2017/4/11BEACLS: Berkeley Efficient API in C++ for Level Set methods
Installation Guide22
![Page 23: BEACLS: Berkeley Efficient API in C++ for Level Set](https://reader036.vdocuments.us/reader036/viewer/2022071219/62cc0e9d78a9fa52cb42af67/html5/thumbnails/23.jpg)
Install to Windows 7/8.1/10 (With GPU) (cont'd.)11. Execute Plane_test
1. Click “Set as StartUp Project” from a context menu of Plane_test in Solution Explorer
2. Execute Plane_test by pushing “F5” key.
2017/4/11BEACLS: Berkeley Efficient API in C++ for Level Set methods
Installation Guide23
![Page 24: BEACLS: Berkeley Efficient API in C++ for Level Set](https://reader036.vdocuments.us/reader036/viewer/2022071219/62cc0e9d78a9fa52cb42af67/html5/thumbnails/24.jpg)
Table of contents
System requirement
Mac OS X
Ubuntu Linux without GPU
Ubuntu Linux with GPU
Windows without GPU
Windows with GPU
Bash on Ubuntu on Windows without GPU
2017/4/11BEACLS: Berkeley Efficient API in C++ for Level Set methods
Installation Guide24
![Page 25: BEACLS: Berkeley Efficient API in C++ for Level Set](https://reader036.vdocuments.us/reader036/viewer/2022071219/62cc0e9d78a9fa52cb42af67/html5/thumbnails/25.jpg)
Install to Bash on Ubuntu on Windows (Without GPU)
1. Update Windows 10 to Windows 10 Creators Update (version 1703, Redstone 2)
2. Install X Window System Server for WindowsCf) Xming : http://www.straightrunning.com/XmingNotes/
3. Run X Windows System Server
4. Install Bash on Ubuntu on Windowshttps://msdn.microsoft.com/en-us/commandline/wsl/install_guide
5. Run bash
6. Set DISPLAY environment variable$ export DISPLAY=0:0
2017/4/11BEACLS: Berkeley Efficient API in C++ for Level Set methods
Installation Guide25
![Page 26: BEACLS: Berkeley Efficient API in C++ for Level Set](https://reader036.vdocuments.us/reader036/viewer/2022071219/62cc0e9d78a9fa52cb42af67/html5/thumbnails/26.jpg)
Install to Bash on Ubuntu on Windows (Without GPU)(cont’d)
7. Install boost, OpenCV and hdf5$ sudo apt-get update$ sudo apt-get upgrade$ sudo apt-get install libhdf5-dev libboost-dev libopencv-dev
8. Download BEACLS$ mkdir ~/BEACLS; cd ~/BEACLS$ git clone https://github.com/HJReachability/beacls$ cd beacls
9. Build BEACLS$ cd beacls/sources$ make all
10. Test BEACLS$ cd samples/Plane_test$ make test
2017/4/11BEACLS: Berkeley Efficient API in C++ for Level Set methods
Installation Guide26
![Page 27: BEACLS: Berkeley Efficient API in C++ for Level Set](https://reader036.vdocuments.us/reader036/viewer/2022071219/62cc0e9d78a9fa52cb42af67/html5/thumbnails/27.jpg)
2017/4/11BEACLS: Berkeley Efficient API in C++ for Level Set methods
Installation Guide27
Thank you!