You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@singa.apache.org by wa...@apache.org on 2018/05/15 05:39:57 UTC
svn commit: r1831607 [1/4] - in /incubator/singa/site/trunk: en/
en/_sources/ en/_sources/community/ en/_sources/docs/ en/community/
en/develop/ en/docs/ en/docs/model_zoo/ en/docs/model_zoo/caffe/
en/docs/model_zoo/char-rnn/ en/docs/model_zoo/cifar10/...
Author: wangwei
Date: Tue May 15 05:39:56 2018
New Revision: 1831607
URL: http://svn.apache.org/viewvc?rev=1831607&view=rev
Log:
update the docs by jenkins for commit 9c0e0af
Added:
incubator/singa/site/trunk/en/_sources/community/source-repository.rst.txt
Modified:
incubator/singa/site/trunk/en/_sources/community/team-list.rst.txt
incubator/singa/site/trunk/en/_sources/docs/install_win.rst.txt
incubator/singa/site/trunk/en/_sources/docs/installation.md.txt
incubator/singa/site/trunk/en/_sources/index.rst.txt
incubator/singa/site/trunk/en/community/issue-tracking.html
incubator/singa/site/trunk/en/community/mail-lists.html
incubator/singa/site/trunk/en/community/source-repository.html
incubator/singa/site/trunk/en/community/team-list.html
incubator/singa/site/trunk/en/develop/contribute-code.html
incubator/singa/site/trunk/en/develop/contribute-docs.html
incubator/singa/site/trunk/en/develop/how-contribute.html
incubator/singa/site/trunk/en/develop/schedule.html
incubator/singa/site/trunk/en/docs.html
incubator/singa/site/trunk/en/docs/cnn.html
incubator/singa/site/trunk/en/docs/converter.html
incubator/singa/site/trunk/en/docs/data.html
incubator/singa/site/trunk/en/docs/dependencies.html
incubator/singa/site/trunk/en/docs/device.html
incubator/singa/site/trunk/en/docs/docker.html
incubator/singa/site/trunk/en/docs/image_tool.html
incubator/singa/site/trunk/en/docs/index.html
incubator/singa/site/trunk/en/docs/initializer.html
incubator/singa/site/trunk/en/docs/install_macos1013.html
incubator/singa/site/trunk/en/docs/install_win.html
incubator/singa/site/trunk/en/docs/installation.html
incubator/singa/site/trunk/en/docs/layer.html
incubator/singa/site/trunk/en/docs/loss.html
incubator/singa/site/trunk/en/docs/metric.html
incubator/singa/site/trunk/en/docs/model_zoo/caffe/README.html
incubator/singa/site/trunk/en/docs/model_zoo/char-rnn/README.html
incubator/singa/site/trunk/en/docs/model_zoo/cifar10/README.html
incubator/singa/site/trunk/en/docs/model_zoo/imagenet/alexnet/README.html
incubator/singa/site/trunk/en/docs/model_zoo/imagenet/googlenet/README.html
incubator/singa/site/trunk/en/docs/model_zoo/imagenet/inception/README.html
incubator/singa/site/trunk/en/docs/model_zoo/imagenet/resnet/README.html
incubator/singa/site/trunk/en/docs/model_zoo/imagenet/vgg/README.html
incubator/singa/site/trunk/en/docs/model_zoo/index.html
incubator/singa/site/trunk/en/docs/model_zoo/mnist/README.html
incubator/singa/site/trunk/en/docs/net.html
incubator/singa/site/trunk/en/docs/neural-net.html
incubator/singa/site/trunk/en/docs/notebook/README.html
incubator/singa/site/trunk/en/docs/optimizer.html
incubator/singa/site/trunk/en/docs/snapshot.html
incubator/singa/site/trunk/en/docs/software_stack.html
incubator/singa/site/trunk/en/docs/tensor.html
incubator/singa/site/trunk/en/docs/utils.html
incubator/singa/site/trunk/en/downloads.html
incubator/singa/site/trunk/en/genindex.html
incubator/singa/site/trunk/en/index.html
incubator/singa/site/trunk/en/py-modindex.html
incubator/singa/site/trunk/en/releases/RELEASE_NOTES_0.1.0.html
incubator/singa/site/trunk/en/releases/RELEASE_NOTES_0.2.0.html
incubator/singa/site/trunk/en/releases/RELEASE_NOTES_0.3.0.html
incubator/singa/site/trunk/en/releases/RELEASE_NOTES_1.0.0.html
incubator/singa/site/trunk/en/releases/RELEASE_NOTES_1.1.0.html
incubator/singa/site/trunk/en/search.html
incubator/singa/site/trunk/en/searchindex.js
incubator/singa/site/trunk/zh/_sources/community/team-list.rst.txt
incubator/singa/site/trunk/zh/_sources/index.rst.txt
incubator/singa/site/trunk/zh/community/issue-tracking.html
incubator/singa/site/trunk/zh/community/mail-lists.html
incubator/singa/site/trunk/zh/community/source-repository.html
incubator/singa/site/trunk/zh/community/team-list.html
incubator/singa/site/trunk/zh/develop/contribute-code.html
incubator/singa/site/trunk/zh/develop/how-contribute.html
incubator/singa/site/trunk/zh/develop/schedule.html
incubator/singa/site/trunk/zh/docs.html
incubator/singa/site/trunk/zh/downloads.html
incubator/singa/site/trunk/zh/genindex.html
incubator/singa/site/trunk/zh/index.html
incubator/singa/site/trunk/zh/search.html
incubator/singa/site/trunk/zh/searchindex.js
Added: incubator/singa/site/trunk/en/_sources/community/source-repository.rst.txt
URL: http://svn.apache.org/viewvc/incubator/singa/site/trunk/en/_sources/community/source-repository.rst.txt?rev=1831607&view=auto
==============================================================================
--- incubator/singa/site/trunk/en/_sources/community/source-repository.rst.txt (added)
+++ incubator/singa/site/trunk/en/_sources/community/source-repository.rst.txt Tue May 15 05:39:56 2018
@@ -0,0 +1,56 @@
+.. Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+
+Source Repository
+=================
+
+This project uses `Git <http://git-scm.com/>`_ to manage its source code. Instructions on Git use can be found at http://git-scm.com/documentation .
+
+Web Access
+----------
+
+The following is a link to the online source repository.
+
+* https://git-wip-us.apache.org/repos/asf?p=incubator-singa.git;a=summary
+
+Contributors
+------------
+
+Contributors are encouraged to rebase their commits onto the latest master before sending the pull requests to make the git history clean. The following git instructors should be executed after committing the current work:
+
+.. code-block:: bash
+
+ git checkout master
+ git pull <apache/incubator-singa upstream> master:master
+ git checkout <new feature branch>
+ git rebase master
+
+Committers
+----------
+
+To merge pull request https://github.com/apache/incubator-singa/pull/xxx, the following instructions should be executed,
+
+.. code-block:: bash
+
+ git clone https://github.com/apache/incubator-singa.git
+ git remote add asf https://git-wip-us.apache.org/repos/asf/incubator-singa.git
+ # optional
+ git pull asf master:master
+ git fetch origin pull/xxx/head:prxxx
+ git merge prxxx
+ git push asf master:master
+
Modified: incubator/singa/site/trunk/en/_sources/community/team-list.rst.txt
URL: http://svn.apache.org/viewvc/incubator/singa/site/trunk/en/_sources/community/team-list.rst.txt?rev=1831607&r1=1831606&r2=1831607&view=diff
==============================================================================
--- incubator/singa/site/trunk/en/_sources/community/team-list.rst.txt (original)
+++ incubator/singa/site/trunk/en/_sources/community/team-list.rst.txt Tue May 15 05:39:56 2018
@@ -50,7 +50,7 @@ The SINGA community has developers mainl
+--------------------+--------------------------------+-----------------------------------------------+
| Jinyang Gao | jinyang@apache.org | National University of Singapore |
+--------------------+--------------------------------+-----------------------------------------------+
-| Xing Ji | jixin@comp.nus.edu.sg | National University of Singapore |
+| Xin Ji | jixin@comp.nus.edu.sg | National University of Singapore |
+--------------------+--------------------------------+-----------------------------------------------+
| Chonho Lee | chonho@gmail.com | Osaka University |
+--------------------+--------------------------------+-----------------------------------------------+
@@ -78,7 +78,7 @@ The SINGA community has developers mainl
+--------------------+--------------------------------+-----------------------------------------------+
| Kaiping Zheng | kaiping@apache.org | National University of Singapore |
+--------------------+--------------------------------+-----------------------------------------------+
-| Moaz Reyad | moazreyad@gmail.com | National University of Singapore |
+| Moaz Reyad | moaz@apache.org | National University of Singapore |
+--------------------+--------------------------------+-----------------------------------------------+
| Chang Yao | yaochang2009@gmail.com | yzBigdata |
+--------------------+--------------------------------+-----------------------------------------------+
Modified: incubator/singa/site/trunk/en/_sources/docs/install_win.rst.txt
URL: http://svn.apache.org/viewvc/incubator/singa/site/trunk/en/_sources/docs/install_win.rst.txt?rev=1831607&r1=1831606&r2=1831607&view=diff
==============================================================================
--- incubator/singa/site/trunk/en/_sources/docs/install_win.rst.txt (original)
+++ incubator/singa/site/trunk/en/_sources/docs/install_win.rst.txt Tue May 15 05:39:56 2018
@@ -19,10 +19,10 @@
Building SINGA on Windows
=========================
-The process of building SINGA from source on Microsoft Windows has three parts: install dependencies, build SINGA source, and (optionally) install the python module.
+The process of building SINGA from source on Microsoft Windows has four parts: install dependencies, build SINGA source, (optionally) install the python module and (optionally) run the unit tests.
1. Install Dependencies
-----------------------
+-----------------------
You may create a folder for building the dependencies.
@@ -167,12 +167,202 @@ A video tutorial for the build process c
+---------+
+4. Run Unit Tests
+-----------------
+
+* In the test folder, generate the Visual Studio solution:
+
+.. code-block:: bash
+
+ cmake -G "Visual Studio 15 2017 Win64"
+
+* Open the generated solution in Visual Studio.
+
+* Change the build settings to Release and x64.
+
+* Build glog project.
+
+* In test_singa project:
+
+ * Add USE_GLOG to the Preprocessor Definitions.
+ * In Additional Include Directories, add path of GLOG_INCLUDE_DIR, CBLAS_INCLUDE_DIR and Protobuf_INCLUDE_DIR which were used in step 2 above. Add also build and build/include folders.
+ * Goto Additional Library Directories and add the path to openblas, protobuf and glog libraries. Add also build/src/singa_objects.dir/Release.
+ * Goto Additional Dependencies and add libopenblas.lib, libglog.lib and libprotobuf.lib. Fix the names of the two libraries: gtest.lib and singa_objects.lib.
+
+* Build test_singa project.
+
+* Make libglog.dll and libopenblas.dll available by adding them to the path or by copying them to test/release folder
+
+* The unit tests can be executed
+
+ * From the command line:
+
+ .. code-block:: bash
+
+ test_singa.exe
+
+ * From Visual Studio:
+ * right click on the test_singa project and choose 'Set as StartUp Project'.
+ * from the Debug menu, choose 'Start Without Debugging'
+
+A video tutorial for running the unit tests can be found here:
+
+
+.. |video| image:: https://img.youtube.com/vi/393gPtzMN1k/0.jpg
+ :scale: 100%
+ :align: middle
+ :target: https://www.youtube.com/watch?v=393gPtzMN1k
+
++---------+
+| |video| |
++---------+
+
+
+5. Build GPU support with CUDA
+------------------------------
+
+In this section, we will extend the previous steps to enable GPU.
+
+5.1 Install Dependencies
+------------------------
+
+In addition to the dependencies in section 1 above, we will need the following:
+
+* CUDA
+
+ Download a suitable version such as 9.1 from https://developer.nvidia.com/cuda-downloads . Make sure to install the Visual Studio integration module.
+
+* cuDNN
+
+ Download a suitable version such as 7.1 from https://developer.nvidia.com/cudnn
+
+* cnmem:
+
+ * Download the latest version from https://github.com/NVIDIA/cnmem
+ * Build the Visual Studio solution:
+ .. code-block:: bash
+ cmake -G "Visual Studio 15 2017 Win64"
+
+ * Open the generated solution in Visual Studio.
+ * Change the build settings to Release and x64.
+ * Build the cnmem project.
+
+5.2 Build SINGA source
+----------------------
+
+* Call cmake and add the paths in your system similar to the following example:
+
+ .. code-block:: bash
+
+ cmake -G "Visual Studio 15 2017 Win64" ^
+ -DGLOG_INCLUDE_DIR="D:/WinSinga/dependencies/glog-0.3.5/src/windows" ^
+ -DGLOG_LIBRARIES="D:/WinSinga/dependencies/glog-0.3.5/x64/Release" ^
+ -DCBLAS_INCLUDE_DIR="D:/WinSinga/dependencies/openblas-0.2.20/lapack-netlib/CBLAS/include" ^
+ -DCBLAS_LIBRARIES="D:/WinSinga/dependencies/openblas-0.2.20/lib/RELEASE" ^
+ -DProtobuf_INCLUDE_DIR="D:/WinSinga/dependencies/protobuf-2.6.1/src" ^
+ -DProtobuf_LIBRARIES="D:\WinSinga/dependencies/protobuf-2.6.1/vsprojects/x64/Release" ^
+ -DProtobuf_PROTOC_EXECUTABLE="D:/WinSinga/dependencies/protoc-2.6.1-win32/protoc.exe" ^
+ -DCUDNN_INCLUDE_DIR=D:\WinSinga\dependencies\cudnn-9.1-windows10-x64-v7.1\cuda\include ^
+ -DCUDNN_LIBRARIES=D:\WinSinga\dependencies\cudnn-9.1-windows10-x64-v7.1\cuda\lib\x64 ^
+ -DSWIG_DIR=D:\WinSinga\dependencies\swigwin-3.0.12 ^
+ -DSWIG_EXECUTABLE=D:\WinSinga\dependencies\swigwin-3.0.12\swig.exe ^
+ -DUSE_CUDA=YES ^
+ -DCUDNN_VERSION=7 ^
+ ..
+
+
+* Generate swig interfaces for C++ and Python:
+ Goto src/api
+
+ .. code-block:: bash
+
+ swig -python -c++ singa.i
+
+* Open the generated solution in Visual Studio
+
+* Change the build settings to Release and x64
+
+5.2.1 Building singa_objects
+----------------------------
+
+* Add the singa_wrap.cxx file from src/api to the singa_objects project
+* In the singa_objects project, open Additional Include Directories.
+* Add Python include path
+* Add numpy include path
+* Add protobuf include path
+* Add include path for CUDA, cuDNN and cnmem
+* In the preprocessor definitions of the singa_objects project, add USE_GLOG, USE_CUDA and USE_CUDNN. Remove DISABLE_WARNINGS.
+* Build singa_objects project
+5.2.2 Building singa-kernel
+---------------------------
+
+* Create a new Visual Studio projcet of type "CUDA 9.1 Runtime". Give it a name such as singa-kernel.
+* The project comes with an initial file called kernel.cu. Remove this file from the project.
+* Add this file: src/core/tensor/math_kernel.cu
+* In the project settings:
+
+ * Set Platfrom Toolset to "Visual Studio 2015 (v140)"
+ * Set Configuration Type to " Static Library (.lib)"
+ * In the Include Directories, add build/include.
+
+* Build singa-kernel project
+
+
+5.2.3 Building singa
+--------------------
+* In singa project:
+ * add singa_wrap.obj to Object Libraries
+ * change target name to _singa_wrap
+ * change target extension to .pyd
+ * change configuration type to Dynamic Library (.dll)
+ * goto Additional Library Directories and add the path to python, openblas, protobuf and glog libraries
+ * Add also the library path to singa-kernel, cnmem, cuda and cudnn.
+ * goto Additional Dependencies and add libopenblas.lib, libglog.lib and libprotobuf.lib.
+ * Add also: singa-kernel.lib, cnmem.lib, cudnn.lib, cuda.lib , cublas.lib, curand.lib and cudart.lib.
+* build singa project
+
+5.3. Install Python module
+--------------------------
+
+* Change _singa_wrap.so to _singa_wrap.pyd in build/python/setup.py
+* Copy the files in src/proto/python_out to build/python/singa/proto
+
+* Optionally create and activate a virtual environment:
+
+.. code-block:: bash
+
+ mkdir SingaEnv
+ virtualenv SingaEnv
+ SingaEnv\Scripts\activate
+* goto build/python folder and run:
+
+.. code-block:: bash
+
+ python setup.py install
+
+* Make _singa_wrap.pyd, libglog.dll, libopenblas.dll, cnmem.dll, CUDA Runtime (e.g. cudart64_91.dll) and cuDNN (e.g. cudnn64_7.dll) available by adding them to the path or by copying them to singa package folder in the python site-packages
+* Verify that SINGA is installed by running:
+
+.. code-block:: bash
+
+ python -c "from singa import device; dev = device.create_cuda_gpu()"
+
+A video tutorial for this part can be found here:
+
+.. |video| image:: https://img.youtube.com/vi/YasKVjRtuDs/0.jpg
+ :scale: 100%
+ :align: middle
+ :target: https://www.youtube.com/watch?v=YasKVjRtuDs
+
++---------+
+| |video| |
++---------+
Modified: incubator/singa/site/trunk/en/_sources/docs/installation.md.txt
URL: http://svn.apache.org/viewvc/incubator/singa/site/trunk/en/_sources/docs/installation.md.txt?rev=1831607&r1=1831606&r2=1831607&view=diff
==============================================================================
--- incubator/singa/site/trunk/en/_sources/docs/installation.md.txt (original)
+++ incubator/singa/site/trunk/en/_sources/docs/installation.md.txt Tue May 15 05:39:56 2018
@@ -2,31 +2,31 @@
## From Conda
-Conda is a package manager provided by [Anaconda](https://www.continuum.io/downloads) or [Miniconda](https://conda.io/miniconda.html).
-Currently, SINGA has conda packages (Python 2.7 and Python 3.6) for Linux and MacOSX.
+Conda is a package manager for Python, CPP and other packages.
-### Linux
+Currently, SINGA has conda packages (Python 2.7 and Python 3.6) for Linux and MacOSX.
+[Miniconda3](https://conda.io/miniconda.html) is recommended to use with SINGA.
+After installing miniconda, execute the one of the following commands to install
+SINGA.
1. CPU only
- conda install -c nusdbsystem singa
+ conda install -c nusdbsystem singa-cpu
-2. GPU via CUDA+cuDNN
+2. GPU with CUDA and cuDNN
- conda install -c nusdbsystem singa-cudax.y-cudnnz
+ conda install -c nusdbsystem singa-gpu
- where `x.y,z` is one of <8.0, 5>, <7.5, 5> and <7.5, 4>.
- Users need to install CUDA and cuDNN before installing SINGA.
- If cuDNN is not in system folders (e.g., /usr/local), export the folder of libcudnn.so to LD_LIBRARY_PATH
+ It is equivalent to
-### Mac OSX
+ conda install -c nusdbsystem singa=1.1.1=py36_cuda9.0-cudnn7.1.2
-Only the CPU version is available,
-
- conda config --add channels conda-forge
- conda install -c nusdbsystem singa
+ CUDA 9.0 must be installed before executing the above command. Singa
+ packages for other CUDA versions are also available. The following instruction
+ lists all the available Singa packages.
+ conda search -c nusdbsystem singa
If there is no error message from
@@ -34,72 +34,62 @@ If there is no error message from
then SINGA is installed successfully.
-## From Debian Package
-The following Debian packages (on architecture: amd64) are available
+## From source
-<table border="1">
- <tr>
- <th>OS</th>
- <th>Device</th>
- <th>CUDA/cuDNN</th>
- <th>Link</th>
- </tr>
- <tr>
- <td>Ubuntu14.04</td>
- <td>CPU</td>
- <td>-</td>
- <td><a href="http://comp.nus.edu.sg/~dbsystem/singa/assets/file/debian/latest/ubuntu14.04-cpp/python-singa.deb">latest</a>, <a href="http://www.comp.nus.edu.sg/~dbsystem/singa/assets/file/debian">history</a></td>
- </tr>
- <tr>
- <td>Ubuntu14.04</td>
- <td>GPU</td>
- <td>CUDA7.5+cuDNN4</td>
- <td>-</td>
- </tr>
- <tr>
- <td>Ubuntu14.04</td>
- <td>GPU</td>
- <td>CUDA7.5+cuDNN5</td>
- <td>-</td>
- </tr>
- <tr>
- <td>Ubuntu14.04</td>
- <td>GPU</td>
- <td>CUDA8.0+cuDNN5</td>
- <td>-</td>
- </tr>
-</table>
+The source files could be downloaded either as a
+[tar.gz file](https://dist.apache.org/repos/dist/dev/incubator/singa/), or as a git repo
-Download the deb file and install it via
+ $ git clone https://github.com/apache/incubator-singa.git
+ $ cd incubator-singa/
- apt-get install <path to the deb file, e.g., ./python-singa.deb>
+### Use Conda to build SINGA
-Note that the path must include `./` if the file in inside the current folder.
+Conda-build is a building tool that installs the dependent libraries from anaconda cloud and
+executes the building scripts. The generated package can be uploaded to anaconda
+cloud for others to download and install.
-## From source
+To install conda-build (after installing miniconda)
-The source files could be downloaded either as a [tar.gz file](https://dist.apache.org/repos/dist/dev/incubator/singa/), or as a git repo
+ conda install conda-build
- $ git clone https://github.com/apache/incubator-singa.git
- $ cd incubator-singa/
+To build the CPU version of SINGA
+
+ export BUILD_STR=cpu
+ conda build tool/conda/singa/ --python3.6 (or --python2.7)
+
+The above commands have been tested on Ubuntu 16.04 and Mac OSX.
+Refer to the [Travis-CI page](https://travis-ci.org/apache/incubator-singa) for more information.
+
+
+To build the GPU version of SINGA
-### Pre-requisite
+ export BUILD_STR=cudax.y-cudnna.b.c (e.g. cuda9.0-cudnn7.1.2)
+ export CUDNN_PATH=<path to cudnn folder>
+ conda build tool/conda/singa/ --python3.6 (or --python2.7)
+
+The commands for building on GPU platforms have been tested on Ubuntu 16.04 (cuDNN>=7 and CUDA>=9).
+[Nvidia's Docker image](https://hub.docker.com/r/nvidia/cuda/) provides the building
+environment with cuDNN and CUDA.
+
+The location of the generated package file is shown on the screen.
+Refer to [conda install](https://conda.io/docs/commands/conda-install.html) for
+the instructions of installing the package from the local file.
+
+
+### Use native tools to build SINGA on Ubuntu
+
+The following libraries are required to compile and run SINGA.
+Refer to SINGA [Dockerfiles](https://github.com/apache/incubator-singa/blob/master/tool/docker/)
+for the instructions of installing them on Ubuntu 16.04.
-The following libraries are required
* cmake (>=2.8)
-* gcc (>=4.8.1) or Clang
+* gcc (>=4.8.1)
* google protobuf (>=2.5)
* blas (tested with openblas >=0.2.10)
* swig(>=3.0.10) for compiling PySINGA
* numpy(>=1.11.0) for compiling PySINGA
-The following libraries are optional
-* opencv (tested with 2.4.8)
-* lmdb (tested with 0.9)
-* glog
-
-### Instructions
1. create a `build` folder inside incubator-singa and go into that folder
2. run `cmake [options] ..`
@@ -108,59 +98,32 @@ The following libraries are optional
* `USE_MODULES=ON`, used if protobuf and blas are not installed a prior
* `USE_CUDA=ON`, used if CUDA and cuDNN is available
* `USE_PYTHON=ON`, used for compiling PySINGA
- * `USE_OPENCL=ON`, used for compiling with OpenCL support
* `USE_PYTHON3=ON`, used for compiling with Python 3 support. (The default is Python 2)
+ * `USE_OPENCL=ON`, used for compiling with OpenCL support
* `PACKAGE=ON`, used for building the Debian package
+ * `ENABLE_TEST`, used for compiling unit test cases
-3. compile the code, e.g., `make`
+3. compile the code, `make`
4. goto python folder
-5. run `pip install .`
-6. [optional] run `python setup.py bdist_wheel` to generate the wheel file
-
-Step 4 and 5 are to install PySINGA.
-Details on the installation of dependent libraries and the instructions for each OS are given in the following sections.
-
-### Linux and Mac OS
-
-Most of the dependent libraries could be installed from source or via package mangers like
-apt-get, yum, and homebrew. Please refer to FAQ for problems caused by the path setting of the dependent libraries.
-
-The following instructions are tested on Ubuntu 14.04 and 16.04for installing dependent libraries.
-
- # required libraries
- $ sudo apt-get install libprotobuf-dev libopenblas-dev protobuf-compiler
+5. run `pip install .` or `pip install -e .` The second command creates symlinks instead of copying files into python site-package folder.
- # optional libraries.
- $ sudo apt-get install python2.7-dev python-pip python-numpy
- # for Python 3
- $ sudo apt-get install python3-dev python3-numpy, python3-pip
- $ sudo apt-get install libopencv-dev libgoogle-glog-dev liblmdb-dev
+Execute step 4 and 5 are to install PySINGA when USE_PYTHON=ON.
-The following instructions are tested on Mac OS X Yosemite (10.11 and 10.12) for installing dependent libraries. Instructions for installing on macOS 10.13 (High Sierra) can be found [here](install_macos1013.html).
+After compiling SINGA with ENABLE_TEST=ON, you can run the unit tests by
- # required libraries
- $ brew tap homebrew/science
- $ brew install openblas
- $ brew install protobuf260
-
- # optional libraries
- $ brew tap homebrew/python
- $ brew install python
- $ brew install opencv
- $ brew install -vd glog lmdb
+ $ ./bin/test_singa
-By default, openblas is installed into /usr/local/opt/openblas. To let the compiler (and cmake) know the openblas
-path,
+You can see all the testing cases with testing results. If SINGA passes all
+tests, then you have successfully installed SINGA.
- $ export CMAKE_INCLUDE_PATH=/usr/local/opt/openblas/include:$CMAKE_INCLUDE_PATH
- $ export CMAKE_LIBRARY_PATH=/usr/local/opt/openblas/lib:$CMAKE_LIBRARY_PATH
-To let the runtime know the openblas path,
+### Compile SINGA on Windows
- $ export LD_LIBRARY_PATH=/usr/local/opt/openblas/library:$LD_LIBRARY_PATH
+Instructions for building on Windows with Python support can be found [here](install_win.html).
+### More details about the compilation options
-#### Compile with USE_MODULES=ON
+### USE_MODULES
If protobuf and openblas are not installed, you can compile SINGA together with them
@@ -173,13 +136,6 @@ If protobuf and openblas are not install
cmake would download OpenBlas and Protobuf (2.6.1) and compile them together
with SINGA.
-After compiling SINGA, you can run the unit tests by
-
- $ ./bin/test_singa
-
-You can see all the testing cases with testing results. If SINGA passes all
-tests, then you have successfully installed SINGA.
-
You can use `ccmake ..` to configure the compilation options.
If some dependent libraries are not in the system default paths, you need to export
the following environment variables
@@ -187,18 +143,7 @@ the following environment variables
export CMAKE_INCLUDE_PATH=<path to the header file folder>
export CMAKE_LIBRARY_PATH=<path to the lib file folder>
-#### Compile with USE_PYTHON=ON
-swig and numpy can be install by
-
- $ Ubuntu 14.04 and 16.04
- $ sudo apt-get install python-numpy
- # Ubuntu 16.04
- $ sudo apt-get install swig
-
-Note that swig has to be installed from source on Ubuntu 14.04.
-After installing numpy, export the header path of numpy.i as
-
- $ export CPLUS_INCLUDE_PATH=`python -c "import numpy; print numpy.get_include()"`:$CPLUS_INCLUDE_PATH
+#### USE_PYTHON
Similar to compile CPP code, PySINGA is compiled by
@@ -207,22 +152,15 @@ Similar to compile CPP code, PySINGA is
$ cd python
$ pip install .
-Developers can build the wheel file via
-
- # under the build directory
- $ cd python
-The generated wheel file is under "dist" directory.
-
-
-#### Compile SINGA with USE_CUDA=ON
+#### USE_CUDA
Users are encouraged to install the CUDA and
[cuDNN](https://developer.nvidia.com/cudnn) for running SINGA on GPUs to
get better performance.
-SINGA has been tested over CUDA (7, 7.5, 8), and cuDNN (4 and 5). If cuDNN is
-decompressed into non-system folder, e.g. /home/bob/local/cudnn/, the following
+SINGA has been tested over CUDA 9, and cuDNN 7. If cuDNN is
+installed into non-system folder, e.g. /home/bob/local/cudnn/, the following
commands should be executed for cmake and the runtime to find it
$ export CMAKE_INCLUDE_PATH=/home/bob/local/cudnn/include:$CMAKE_INCLUDE_PATH
@@ -233,8 +171,9 @@ The cmake options for CUDA and cuDNN sho
# Dependent libs are install already
$ cmake -DUSE_CUDA=ON ..
+ $ make
-#### Compile SINGA with USE_OPENCL=ON
+#### USE_OPENCL
SINGA uses opencl-headers and viennacl (version 1.7.1 or newer) for OpenCL support, which
can be installed using via
@@ -250,7 +189,8 @@ Additionally, you will need the OpenCL I
* For Intel CPUs and/or GPUs, get the driver from the [Intel website.](https://software.intel.com/en-us/articles/opencl-drivers) Note that the drivers provided on that website only supports recent CPUs and Iris GPUs.
* For older Intel CPUs, you can use the `beignet-opencl-icd` package.
-Note that running OpenCL on CPUs is not currently recommended because it is slow. Memory transfer is on the order of whole seconds (1000's of ms on CPUs as compared to 1's of ms on GPUs).
+Note that running OpenCL on CPUs is not currently recommended because it is slow.
+Memory transfer is on the order of whole seconds (1000's of ms on CPUs as compared to 1's of ms on GPUs).
More information on setting up a working OpenCL environment may be found [here](https://wiki.tiker.net/OpenCLHowTo).
@@ -259,24 +199,18 @@ If the package version of ViennaCL is no
Clone [the repository from here](https://github.com/viennacl/viennacl-dev), checkout the `release-1.7.1` tag and build it.
Remember to add its directory to `PATH` and the built libraries to `LD_LIBRARY_PATH`.
-To build SINGA with OpenCL support, you need to pass the flag during cmake:
+To build SINGA with OpenCL support (tested on SINGA 1.1):
- cmake -DUSE_OPENCL=ON ..
-
-#### Compile SINGA with PYTHON2=ON
-
-The default Python version for SINGA is 3. SINGA can be built for Python 2 by setting PYTHON2=ON.
+ $ cmake -DUSE_OPENCL=ON ..
+ $ make
-#### Compile SINGA with PACKAGE=ON
+#### PACKAGE
This setting is used to build the Debian package. Set PACKAGE=ON and build the package with make command like this:
$ cmake -DPACKAGE=ON
$ make package
-### Compile SINGA on Windows
-
-Instructions for building on Windows with Python support can be found [here](install_win.html).
## FAQ
Modified: incubator/singa/site/trunk/en/_sources/index.rst.txt
URL: http://svn.apache.org/viewvc/incubator/singa/site/trunk/en/_sources/index.rst.txt?rev=1831607&r1=1831606&r2=1831607&view=diff
==============================================================================
--- incubator/singa/site/trunk/en/_sources/index.rst.txt (original)
+++ incubator/singa/site/trunk/en/_sources/index.rst.txt Tue May 15 05:39:56 2018
@@ -15,11 +15,6 @@
specific language governing permissions and limitations
under the License.
-
-.. SINGA documentation master file, created by
- sphinx-quickstart on Sat Jul 9 20:36:57 2016.
- You can adapt this file completely to your liking, but it should at least
- contain the root `toctree` directive.
Welcome to Apache SINGA
=======================
Modified: incubator/singa/site/trunk/en/community/issue-tracking.html
URL: http://svn.apache.org/viewvc/incubator/singa/site/trunk/en/community/issue-tracking.html?rev=1831607&r1=1831606&r2=1831607&view=diff
==============================================================================
--- incubator/singa/site/trunk/en/community/issue-tracking.html (original)
+++ incubator/singa/site/trunk/en/community/issue-tracking.html Tue May 15 05:39:56 2018
@@ -245,7 +245,7 @@
});
</script>
-<div class="rst-versions shift-up" data-toggle="rst-versions" role="note" aria-label="versions">
+<div class="rst-versions" data-toggle="rst-versions" role="note" aria-label="versions">
<span class="rst-current-version" data-toggle="rst-current-version">
<span class="fa fa-book"> incubator-singa </span>
v: latest
Modified: incubator/singa/site/trunk/en/community/mail-lists.html
URL: http://svn.apache.org/viewvc/incubator/singa/site/trunk/en/community/mail-lists.html?rev=1831607&r1=1831606&r2=1831607&view=diff
==============================================================================
--- incubator/singa/site/trunk/en/community/mail-lists.html (original)
+++ incubator/singa/site/trunk/en/community/mail-lists.html Tue May 15 05:39:56 2018
@@ -272,7 +272,7 @@
});
</script>
-<div class="rst-versions shift-up" data-toggle="rst-versions" role="note" aria-label="versions">
+<div class="rst-versions" data-toggle="rst-versions" role="note" aria-label="versions">
<span class="rst-current-version" data-toggle="rst-current-version">
<span class="fa fa-book"> incubator-singa </span>
v: latest
Modified: incubator/singa/site/trunk/en/community/source-repository.html
URL: http://svn.apache.org/viewvc/incubator/singa/site/trunk/en/community/source-repository.html?rev=1831607&r1=1831606&r2=1831607&view=diff
==============================================================================
--- incubator/singa/site/trunk/en/community/source-repository.html (original)
+++ incubator/singa/site/trunk/en/community/source-repository.html Tue May 15 05:39:56 2018
@@ -104,7 +104,8 @@
<ul class="current">
<li class="toctree-l1 current"><a class="current reference internal" href="#">Source Repository</a><ul>
<li class="toctree-l2"><a class="reference internal" href="#web-access">Web Access</a></li>
-<li class="toctree-l2"><a class="reference internal" href="#upstream-for-committers">Upstream for committers</a></li>
+<li class="toctree-l2"><a class="reference internal" href="#contributors">Contributors</a></li>
+<li class="toctree-l2"><a class="reference internal" href="#committers">Committers</a></li>
</ul>
</li>
<li class="toctree-l1"><a class="reference internal" href="mail-lists.html">Project Mailing Lists</a></li>
@@ -173,24 +174,35 @@
<div itemprop="articleBody">
<div class="section" id="source-repository">
-<span id="source-repository"></span><h1>Source Repository<a class="headerlink" href="#source-repository" title="Permalink to this headline">¶</a></h1>
-<hr class="docutils" />
-<p>This project uses <a class="reference external" href="http://git-scm.com/">Git</a> to manage its source code. Instructions on Git use can be found at <a class="reference external" href="http://git-scm.com/documentation">http://git-scm.com/documentation</a>.</p>
+<h1>Source Repository<a class="headerlink" href="#source-repository" title="Permalink to this headline">¶</a></h1>
+<p>This project uses <a class="reference external" href="http://git-scm.com/">Git</a> to manage its source code. Instructions on Git use can be found at <a class="reference external" href="http://git-scm.com/documentation">http://git-scm.com/documentation</a> .</p>
<div class="section" id="web-access">
-<span id="web-access"></span><h2>Web Access<a class="headerlink" href="#web-access" title="Permalink to this headline">¶</a></h2>
+<h2>Web Access<a class="headerlink" href="#web-access" title="Permalink to this headline">¶</a></h2>
<p>The following is a link to the online source repository.</p>
<ul class="simple">
<li><a class="reference external" href="https://git-wip-us.apache.org/repos/asf?p=incubator-singa.git;a=summary">https://git-wip-us.apache.org/repos/asf?p=incubator-singa.git;a=summary</a></li>
</ul>
</div>
-<div class="section" id="upstream-for-committers">
-<span id="upstream-for-committers"></span><h2>Upstream for committers<a class="headerlink" href="#upstream-for-committers" title="Permalink to this headline">¶</a></h2>
-<p>Committers need to set the upstream endpoint to the Apache git (not github) repo address, e.g.,</p>
-<div class="highlight-default notranslate"><div class="highlight"><pre><span></span>$ git remote add asf https://git-wip-us.apache.org/repos/asf/incubator-singa.git
+<div class="section" id="contributors">
+<h2>Contributors<a class="headerlink" href="#contributors" title="Permalink to this headline">¶</a></h2>
+<p>Contributors are encouraged to rebase their commits onto the latest master before sending the pull requests to make the git history clean. The following git instructors should be executed after committing the current work:</p>
+<div class="highlight-bash notranslate"><div class="highlight"><pre><span></span>git checkout master
+git pull <apache/incubator-singa upstream> master:master
+git checkout <new feature branch>
+git rebase master
</pre></div>
</div>
-<p>Then you (committer) can push your code in this way,</p>
-<div class="highlight-default notranslate"><div class="highlight"><pre><span></span>$ git push asf <local-branch>:<remote-branch>
+</div>
+<div class="section" id="committers">
+<h2>Committers<a class="headerlink" href="#committers" title="Permalink to this headline">¶</a></h2>
+<p>To merge pull request <a class="reference external" href="https://github.com/apache/incubator-singa/pull/xxx">https://github.com/apache/incubator-singa/pull/xxx</a>, the following instructions should be executed,</p>
+<div class="highlight-bash notranslate"><div class="highlight"><pre><span></span>git clone https://github.com/apache/incubator-singa.git
+git remote add asf https://git-wip-us.apache.org/repos/asf/incubator-singa.git
+<span class="c1"># optional</span>
+git pull asf master:master
+git fetch origin pull/xxx/head:prxxx
+git merge prxxx
+git push asf master:master
</pre></div>
</div>
</div>
@@ -263,7 +275,7 @@
});
</script>
-<div class="rst-versions shift-up" data-toggle="rst-versions" role="note" aria-label="versions">
+<div class="rst-versions" data-toggle="rst-versions" role="note" aria-label="versions">
<span class="rst-current-version" data-toggle="rst-current-version">
<span class="fa fa-book"> incubator-singa </span>
v: latest
Modified: incubator/singa/site/trunk/en/community/team-list.html
URL: http://svn.apache.org/viewvc/incubator/singa/site/trunk/en/community/team-list.html?rev=1831607&r1=1831606&r2=1831607&view=diff
==============================================================================
--- incubator/singa/site/trunk/en/community/team-list.html (original)
+++ incubator/singa/site/trunk/en/community/team-list.html Tue May 15 05:39:56 2018
@@ -234,7 +234,7 @@
<td><a class="reference external" href="mailto:jinyang%40apache.org">jinyang<span>@</span>apache<span>.</span>org</a></td>
<td>National University of Singapore</td>
</tr>
-<tr class="row-even"><td>Xing Ji</td>
+<tr class="row-even"><td>Xin Ji</td>
<td><a class="reference external" href="mailto:jixin%40comp.nus.edu.sg">jixin<span>@</span>comp<span>.</span>nus<span>.</span>edu<span>.</span>sg</a></td>
<td>National University of Singapore</td>
</tr>
@@ -291,7 +291,7 @@
<td>National University of Singapore</td>
</tr>
<tr class="row-even"><td>Moaz Reyad</td>
-<td><a class="reference external" href="mailto:moazreyad%40gmail.com">moazreyad<span>@</span>gmail<span>.</span>com</a></td>
+<td><a class="reference external" href="mailto:moaz%40apache.org">moaz<span>@</span>apache<span>.</span>org</a></td>
<td>National University of Singapore</td>
</tr>
<tr class="row-odd"><td>Chang Yao</td>
@@ -368,7 +368,7 @@
});
</script>
-<div class="rst-versions shift-up" data-toggle="rst-versions" role="note" aria-label="versions">
+<div class="rst-versions" data-toggle="rst-versions" role="note" aria-label="versions">
<span class="rst-current-version" data-toggle="rst-current-version">
<span class="fa fa-book"> incubator-singa </span>
v: latest
Modified: incubator/singa/site/trunk/en/develop/contribute-code.html
URL: http://svn.apache.org/viewvc/incubator/singa/site/trunk/en/develop/contribute-code.html?rev=1831607&r1=1831606&r2=1831607&view=diff
==============================================================================
--- incubator/singa/site/trunk/en/develop/contribute-code.html (original)
+++ incubator/singa/site/trunk/en/develop/contribute-code.html Tue May 15 05:39:56 2018
@@ -298,7 +298,7 @@ will be automatically updated. For detai
});
</script>
-<div class="rst-versions shift-up" data-toggle="rst-versions" role="note" aria-label="versions">
+<div class="rst-versions" data-toggle="rst-versions" role="note" aria-label="versions">
<span class="rst-current-version" data-toggle="rst-current-version">
<span class="fa fa-book"> incubator-singa </span>
v: latest
Modified: incubator/singa/site/trunk/en/develop/contribute-docs.html
URL: http://svn.apache.org/viewvc/incubator/singa/site/trunk/en/develop/contribute-docs.html?rev=1831607&r1=1831606&r2=1831607&view=diff
==============================================================================
--- incubator/singa/site/trunk/en/develop/contribute-docs.html (original)
+++ incubator/singa/site/trunk/en/develop/contribute-docs.html Tue May 15 05:39:56 2018
@@ -276,7 +276,7 @@ $ svn commit -m "commit messages&qu
});
</script>
-<div class="rst-versions shift-up" data-toggle="rst-versions" role="note" aria-label="versions">
+<div class="rst-versions" data-toggle="rst-versions" role="note" aria-label="versions">
<span class="rst-current-version" data-toggle="rst-current-version">
<span class="fa fa-book"> incubator-singa </span>
v: latest
Modified: incubator/singa/site/trunk/en/develop/how-contribute.html
URL: http://svn.apache.org/viewvc/incubator/singa/site/trunk/en/develop/how-contribute.html?rev=1831607&r1=1831606&r2=1831607&view=diff
==============================================================================
--- incubator/singa/site/trunk/en/develop/how-contribute.html (original)
+++ incubator/singa/site/trunk/en/develop/how-contribute.html Tue May 15 05:39:56 2018
@@ -247,7 +247,7 @@
});
</script>
-<div class="rst-versions shift-up" data-toggle="rst-versions" role="note" aria-label="versions">
+<div class="rst-versions" data-toggle="rst-versions" role="note" aria-label="versions">
<span class="rst-current-version" data-toggle="rst-current-version">
<span class="fa fa-book"> incubator-singa </span>
v: latest
Modified: incubator/singa/site/trunk/en/develop/schedule.html
URL: http://svn.apache.org/viewvc/incubator/singa/site/trunk/en/develop/schedule.html?rev=1831607&r1=1831606&r2=1831607&view=diff
==============================================================================
--- incubator/singa/site/trunk/en/develop/schedule.html (original)
+++ incubator/singa/site/trunk/en/develop/schedule.html Tue May 15 05:39:56 2018
@@ -422,7 +422,7 @@
});
</script>
-<div class="rst-versions shift-up" data-toggle="rst-versions" role="note" aria-label="versions">
+<div class="rst-versions" data-toggle="rst-versions" role="note" aria-label="versions">
<span class="rst-current-version" data-toggle="rst-current-version">
<span class="fa fa-book"> incubator-singa </span>
v: latest
Modified: incubator/singa/site/trunk/en/docs.html
URL: http://svn.apache.org/viewvc/incubator/singa/site/trunk/en/docs.html?rev=1831607&r1=1831606&r2=1831607&view=diff
==============================================================================
--- incubator/singa/site/trunk/en/docs.html (original)
+++ incubator/singa/site/trunk/en/docs.html Tue May 15 05:39:56 2018
@@ -172,25 +172,19 @@
<ul>
<li class="toctree-l1"><a class="reference internal" href="docs/index.html">Documentation</a><ul>
<li class="toctree-l2"><a class="reference internal" href="docs/installation.html">Installation</a><ul>
-<li class="toctree-l3"><a class="reference internal" href="docs/installation.html#from-conda">From Conda</a><ul>
-<li class="toctree-l4"><a class="reference internal" href="docs/installation.html#linux">Linux</a></li>
-<li class="toctree-l4"><a class="reference internal" href="docs/installation.html#mac-osx">Mac OSX</a></li>
-</ul>
-</li>
-<li class="toctree-l3"><a class="reference internal" href="docs/installation.html#from-debian-package">From Debian Package</a></li>
+<li class="toctree-l3"><a class="reference internal" href="docs/installation.html#from-conda">From Conda</a></li>
<li class="toctree-l3"><a class="reference internal" href="docs/installation.html#from-source">From source</a><ul>
-<li class="toctree-l4"><a class="reference internal" href="docs/installation.html#pre-requisite">Pre-requisite</a></li>
-<li class="toctree-l4"><a class="reference internal" href="docs/installation.html#instructions">Instructions</a></li>
-<li class="toctree-l4"><a class="reference internal" href="docs/installation.html#linux-and-mac-os">Linux and Mac OS</a><ul>
-<li class="toctree-l5"><a class="reference internal" href="docs/installation.html#compile-with-use-modules-on">Compile with USE_MODULES=ON</a></li>
-<li class="toctree-l5"><a class="reference internal" href="docs/installation.html#compile-with-use-python-on">Compile with USE_PYTHON=ON</a></li>
-<li class="toctree-l5"><a class="reference internal" href="docs/installation.html#compile-singa-with-use-cuda-on">Compile SINGA with USE_CUDA=ON</a></li>
-<li class="toctree-l5"><a class="reference internal" href="docs/installation.html#compile-singa-with-use-opencl-on">Compile SINGA with USE_OPENCL=ON</a></li>
-<li class="toctree-l5"><a class="reference internal" href="docs/installation.html#compile-singa-with-python2-on">Compile SINGA with PYTHON2=ON</a></li>
-<li class="toctree-l5"><a class="reference internal" href="docs/installation.html#compile-singa-with-package-on">Compile SINGA with PACKAGE=ON</a></li>
+<li class="toctree-l4"><a class="reference internal" href="docs/installation.html#use-conda-to-build-singa">Use Conda to build SINGA</a></li>
+<li class="toctree-l4"><a class="reference internal" href="docs/installation.html#use-native-tools-to-build-singa-on-ubuntu">Use native tools to build SINGA on Ubuntu</a></li>
+<li class="toctree-l4"><a class="reference internal" href="docs/installation.html#compile-singa-on-windows">Compile SINGA on Windows</a></li>
+<li class="toctree-l4"><a class="reference internal" href="docs/installation.html#more-details-about-the-compilation-options">More details about the compilation options</a></li>
+<li class="toctree-l4"><a class="reference internal" href="docs/installation.html#use-modules">USE_MODULES</a><ul>
+<li class="toctree-l5"><a class="reference internal" href="docs/installation.html#use-python">USE_PYTHON</a></li>
+<li class="toctree-l5"><a class="reference internal" href="docs/installation.html#use-cuda">USE_CUDA</a></li>
+<li class="toctree-l5"><a class="reference internal" href="docs/installation.html#use-opencl">USE_OPENCL</a></li>
+<li class="toctree-l5"><a class="reference internal" href="docs/installation.html#package">PACKAGE</a></li>
</ul>
</li>
-<li class="toctree-l4"><a class="reference internal" href="docs/installation.html#compile-singa-on-windows">Compile SINGA on Windows</a></li>
</ul>
</li>
<li class="toctree-l3"><a class="reference internal" href="docs/installation.html#faq">FAQ</a></li>
@@ -329,7 +323,7 @@
});
</script>
-<div class="rst-versions shift-up" data-toggle="rst-versions" role="note" aria-label="versions">
+<div class="rst-versions" data-toggle="rst-versions" role="note" aria-label="versions">
<span class="rst-current-version" data-toggle="rst-current-version">
<span class="fa fa-book"> incubator-singa </span>
v: latest
Modified: incubator/singa/site/trunk/en/docs/cnn.html
URL: http://svn.apache.org/viewvc/incubator/singa/site/trunk/en/docs/cnn.html?rev=1831607&r1=1831606&r2=1831607&view=diff
==============================================================================
--- incubator/singa/site/trunk/en/docs/cnn.html (original)
+++ incubator/singa/site/trunk/en/docs/cnn.html Tue May 15 05:39:56 2018
@@ -368,7 +368,7 @@ $ python download_data.py py
});
</script>
-<div class="rst-versions shift-up" data-toggle="rst-versions" role="note" aria-label="versions">
+<div class="rst-versions" data-toggle="rst-versions" role="note" aria-label="versions">
<span class="rst-current-version" data-toggle="rst-current-version">
<span class="fa fa-book"> incubator-singa </span>
v: latest
Modified: incubator/singa/site/trunk/en/docs/converter.html
URL: http://svn.apache.org/viewvc/incubator/singa/site/trunk/en/docs/converter.html?rev=1831607&r1=1831606&r2=1831607&view=diff
==============================================================================
--- incubator/singa/site/trunk/en/docs/converter.html (original)
+++ incubator/singa/site/trunk/en/docs/converter.html Tue May 15 05:39:56 2018
@@ -259,7 +259,7 @@
});
</script>
-<div class="rst-versions shift-up" data-toggle="rst-versions" role="note" aria-label="versions">
+<div class="rst-versions" data-toggle="rst-versions" role="note" aria-label="versions">
<span class="rst-current-version" data-toggle="rst-current-version">
<span class="fa fa-book"> incubator-singa </span>
v: latest
Modified: incubator/singa/site/trunk/en/docs/data.html
URL: http://svn.apache.org/viewvc/incubator/singa/site/trunk/en/docs/data.html?rev=1831607&r1=1831606&r2=1831607&view=diff
==============================================================================
--- incubator/singa/site/trunk/en/docs/data.html (original)
+++ incubator/singa/site/trunk/en/docs/data.html Tue May 15 05:39:56 2018
@@ -321,7 +321,7 @@ space or comma</li>
});
</script>
-<div class="rst-versions shift-up" data-toggle="rst-versions" role="note" aria-label="versions">
+<div class="rst-versions" data-toggle="rst-versions" role="note" aria-label="versions">
<span class="rst-current-version" data-toggle="rst-current-version">
<span class="fa fa-book"> incubator-singa </span>
v: latest
Modified: incubator/singa/site/trunk/en/docs/dependencies.html
URL: http://svn.apache.org/viewvc/incubator/singa/site/trunk/en/docs/dependencies.html?rev=1831607&r1=1831606&r2=1831607&view=diff
==============================================================================
--- incubator/singa/site/trunk/en/docs/dependencies.html (original)
+++ incubator/singa/site/trunk/en/docs/dependencies.html Tue May 15 05:39:56 2018
@@ -302,7 +302,7 @@ folders).</p>
});
</script>
-<div class="rst-versions shift-up" data-toggle="rst-versions" role="note" aria-label="versions">
+<div class="rst-versions" data-toggle="rst-versions" role="note" aria-label="versions">
<span class="rst-current-version" data-toggle="rst-current-version">
<span class="fa fa-book"> incubator-singa </span>
v: latest
Modified: incubator/singa/site/trunk/en/docs/device.html
URL: http://svn.apache.org/viewvc/incubator/singa/site/trunk/en/docs/device.html?rev=1831607&r1=1831606&r2=1831607&view=diff
==============================================================================
--- incubator/singa/site/trunk/en/docs/device.html (original)
+++ incubator/singa/site/trunk/en/docs/device.html Tue May 15 05:39:56 2018
@@ -332,7 +332,7 @@ to call singa::Device and its methods.</
});
</script>
-<div class="rst-versions shift-up" data-toggle="rst-versions" role="note" aria-label="versions">
+<div class="rst-versions" data-toggle="rst-versions" role="note" aria-label="versions">
<span class="rst-current-version" data-toggle="rst-current-version">
<span class="fa fa-book"> incubator-singa </span>
v: latest
Modified: incubator/singa/site/trunk/en/docs/docker.html
URL: http://svn.apache.org/viewvc/incubator/singa/site/trunk/en/docs/docker.html?rev=1831607&r1=1831606&r2=1831607&view=diff
==============================================================================
--- incubator/singa/site/trunk/en/docs/docker.html (original)
+++ incubator/singa/site/trunk/en/docs/docker.html Tue May 15 05:39:56 2018
@@ -284,7 +284,7 @@ The folder structure is like</p>
});
</script>
-<div class="rst-versions shift-up" data-toggle="rst-versions" role="note" aria-label="versions">
+<div class="rst-versions" data-toggle="rst-versions" role="note" aria-label="versions">
<span class="rst-current-version" data-toggle="rst-current-version">
<span class="fa fa-book"> incubator-singa </span>
v: latest
Modified: incubator/singa/site/trunk/en/docs/image_tool.html
URL: http://svn.apache.org/viewvc/incubator/singa/site/trunk/en/docs/image_tool.html?rev=1831607&r1=1831606&r2=1831607&view=diff
==============================================================================
--- incubator/singa/site/trunk/en/docs/image_tool.html (original)
+++ incubator/singa/site/trunk/en/docs/image_tool.html Tue May 15 05:39:56 2018
@@ -589,7 +589,7 @@ it into given size.</p>
});
</script>
-<div class="rst-versions shift-up" data-toggle="rst-versions" role="note" aria-label="versions">
+<div class="rst-versions" data-toggle="rst-versions" role="note" aria-label="versions">
<span class="rst-current-version" data-toggle="rst-current-version">
<span class="fa fa-book"> incubator-singa </span>
v: latest
Modified: incubator/singa/site/trunk/en/docs/index.html
URL: http://svn.apache.org/viewvc/incubator/singa/site/trunk/en/docs/index.html?rev=1831607&r1=1831606&r2=1831607&view=diff
==============================================================================
--- incubator/singa/site/trunk/en/docs/index.html (original)
+++ incubator/singa/site/trunk/en/docs/index.html Tue May 15 05:39:56 2018
@@ -191,25 +191,19 @@
<div class="toctree-wrapper compound">
<ul>
<li class="toctree-l1"><a class="reference internal" href="installation.html">Installation</a><ul>
-<li class="toctree-l2"><a class="reference internal" href="installation.html#from-conda">From Conda</a><ul>
-<li class="toctree-l3"><a class="reference internal" href="installation.html#linux">Linux</a></li>
-<li class="toctree-l3"><a class="reference internal" href="installation.html#mac-osx">Mac OSX</a></li>
-</ul>
-</li>
-<li class="toctree-l2"><a class="reference internal" href="installation.html#from-debian-package">From Debian Package</a></li>
+<li class="toctree-l2"><a class="reference internal" href="installation.html#from-conda">From Conda</a></li>
<li class="toctree-l2"><a class="reference internal" href="installation.html#from-source">From source</a><ul>
-<li class="toctree-l3"><a class="reference internal" href="installation.html#pre-requisite">Pre-requisite</a></li>
-<li class="toctree-l3"><a class="reference internal" href="installation.html#instructions">Instructions</a></li>
-<li class="toctree-l3"><a class="reference internal" href="installation.html#linux-and-mac-os">Linux and Mac OS</a><ul>
-<li class="toctree-l4"><a class="reference internal" href="installation.html#compile-with-use-modules-on">Compile with USE_MODULES=ON</a></li>
-<li class="toctree-l4"><a class="reference internal" href="installation.html#compile-with-use-python-on">Compile with USE_PYTHON=ON</a></li>
-<li class="toctree-l4"><a class="reference internal" href="installation.html#compile-singa-with-use-cuda-on">Compile SINGA with USE_CUDA=ON</a></li>
-<li class="toctree-l4"><a class="reference internal" href="installation.html#compile-singa-with-use-opencl-on">Compile SINGA with USE_OPENCL=ON</a></li>
-<li class="toctree-l4"><a class="reference internal" href="installation.html#compile-singa-with-python2-on">Compile SINGA with PYTHON2=ON</a></li>
-<li class="toctree-l4"><a class="reference internal" href="installation.html#compile-singa-with-package-on">Compile SINGA with PACKAGE=ON</a></li>
+<li class="toctree-l3"><a class="reference internal" href="installation.html#use-conda-to-build-singa">Use Conda to build SINGA</a></li>
+<li class="toctree-l3"><a class="reference internal" href="installation.html#use-native-tools-to-build-singa-on-ubuntu">Use native tools to build SINGA on Ubuntu</a></li>
+<li class="toctree-l3"><a class="reference internal" href="installation.html#compile-singa-on-windows">Compile SINGA on Windows</a></li>
+<li class="toctree-l3"><a class="reference internal" href="installation.html#more-details-about-the-compilation-options">More details about the compilation options</a></li>
+<li class="toctree-l3"><a class="reference internal" href="installation.html#use-modules">USE_MODULES</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="installation.html#use-python">USE_PYTHON</a></li>
+<li class="toctree-l4"><a class="reference internal" href="installation.html#use-cuda">USE_CUDA</a></li>
+<li class="toctree-l4"><a class="reference internal" href="installation.html#use-opencl">USE_OPENCL</a></li>
+<li class="toctree-l4"><a class="reference internal" href="installation.html#package">PACKAGE</a></li>
</ul>
</li>
-<li class="toctree-l3"><a class="reference internal" href="installation.html#compile-singa-on-windows">Compile SINGA on Windows</a></li>
</ul>
</li>
<li class="toctree-l2"><a class="reference internal" href="installation.html#faq">FAQ</a></li>
@@ -355,7 +349,7 @@
});
</script>
-<div class="rst-versions shift-up" data-toggle="rst-versions" role="note" aria-label="versions">
+<div class="rst-versions" data-toggle="rst-versions" role="note" aria-label="versions">
<span class="rst-current-version" data-toggle="rst-current-version">
<span class="fa fa-book"> incubator-singa </span>
v: latest
Modified: incubator/singa/site/trunk/en/docs/initializer.html
URL: http://svn.apache.org/viewvc/incubator/singa/site/trunk/en/docs/initializer.html?rev=1831607&r1=1831606&r2=1831607&view=diff
==============================================================================
--- incubator/singa/site/trunk/en/docs/initializer.html (original)
+++ incubator/singa/site/trunk/en/docs/initializer.html Tue May 15 05:39:56 2018
@@ -329,7 +329,7 @@ Rectifiers: Surpassing Human-Level Perfo
});
</script>
-<div class="rst-versions shift-up" data-toggle="rst-versions" role="note" aria-label="versions">
+<div class="rst-versions" data-toggle="rst-versions" role="note" aria-label="versions">
<span class="rst-current-version" data-toggle="rst-current-version">
<span class="fa fa-book"> incubator-singa </span>
v: latest
Modified: incubator/singa/site/trunk/en/docs/install_macos1013.html
URL: http://svn.apache.org/viewvc/incubator/singa/site/trunk/en/docs/install_macos1013.html?rev=1831607&r1=1831606&r2=1831607&view=diff
==============================================================================
--- incubator/singa/site/trunk/en/docs/install_macos1013.html (original)
+++ incubator/singa/site/trunk/en/docs/install_macos1013.html Tue May 15 05:39:56 2018
@@ -348,7 +348,7 @@ jupyter notebook
});
</script>
-<div class="rst-versions shift-up" data-toggle="rst-versions" role="note" aria-label="versions">
+<div class="rst-versions" data-toggle="rst-versions" role="note" aria-label="versions">
<span class="rst-current-version" data-toggle="rst-current-version">
<span class="fa fa-book"> incubator-singa </span>
v: latest
Modified: incubator/singa/site/trunk/en/docs/install_win.html
URL: http://svn.apache.org/viewvc/incubator/singa/site/trunk/en/docs/install_win.html?rev=1831607&r1=1831606&r2=1831607&view=diff
==============================================================================
--- incubator/singa/site/trunk/en/docs/install_win.html (original)
+++ incubator/singa/site/trunk/en/docs/install_win.html Tue May 15 05:39:56 2018
@@ -168,7 +168,7 @@
<div class="section" id="building-singa-on-windows">
<h1>Building SINGA on Windows<a class="headerlink" href="#building-singa-on-windows" title="Permalink to this headline">¶</a></h1>
-<p>The process of building SINGA from source on Microsoft Windows has three parts: install dependencies, build SINGA source, and (optionally) install the python module.</p>
+<p>The process of building SINGA from source on Microsoft Windows has four parts: install dependencies, build SINGA source, (optionally) install the python module and (optionally) run the unit tests.</p>
<div class="section" id="install-dependencies">
<h2>1. Install Dependencies<a class="headerlink" href="#install-dependencies" title="Permalink to this headline">¶</a></h2>
<p>You may create a folder for building the dependencies.</p>
@@ -354,7 +354,242 @@ SingaEnv<span class="se">\S</span>cripts
<col width="100%" />
</colgroup>
<tbody valign="top">
-<tr class="row-odd"><td><a class="reference external" href="https://www.youtube.com/watch?v=cteER7WeiGk"><img alt="video" class="align-middle" src="https://img.youtube.com/vi/cteER7WeiGk/0.jpg" /></a></td>
+<tr class="row-odd"><td><a class="reference external" href="https://www.youtube.com/watch?v=YasKVjRtuDs"><img alt="video" class="align-middle" src="https://img.youtube.com/vi/YasKVjRtuDs/0.jpg" /></a></td>
+</tr>
+</tbody>
+</table>
+</div>
+<div class="section" id="run-unit-tests">
+<h2>4. Run Unit Tests<a class="headerlink" href="#run-unit-tests" title="Permalink to this headline">¶</a></h2>
+<ul class="simple">
+<li>In the test folder, generate the Visual Studio solution:</li>
+</ul>
+<div class="highlight-bash notranslate"><div class="highlight"><pre><span></span>cmake -G <span class="s2">"Visual Studio 15 2017 Win64"</span>
+</pre></div>
+</div>
+<ul>
+<li><p class="first">Open the generated solution in Visual Studio.</p>
+</li>
+<li><p class="first">Change the build settings to Release and x64.</p>
+</li>
+<li><p class="first">Build glog project.</p>
+</li>
+<li><p class="first">In test_singa project:</p>
+<blockquote>
+<div><ul class="simple">
+<li>Add USE_GLOG to the Preprocessor Definitions.</li>
+<li>In Additional Include Directories, add path of GLOG_INCLUDE_DIR, CBLAS_INCLUDE_DIR and Protobuf_INCLUDE_DIR which were used in step 2 above. Add also build and build/include folders.</li>
+<li>Goto Additional Library Directories and add the path to openblas, protobuf and glog libraries. Add also build/src/singa_objects.dir/Release.</li>
+<li>Goto Additional Dependencies and add libopenblas.lib, libglog.lib and libprotobuf.lib. Fix the names of the two libraries: gtest.lib and singa_objects.lib.</li>
+</ul>
+</div></blockquote>
+</li>
+<li><p class="first">Build test_singa project.</p>
+</li>
+<li><p class="first">Make libglog.dll and libopenblas.dll available by adding them to the path or by copying them to test/release folder</p>
+</li>
+<li><p class="first">The unit tests can be executed</p>
+<blockquote>
+<div><ul>
+<li><p class="first">From the command line:</p>
+<blockquote>
+<div><div class="highlight-bash notranslate"><div class="highlight"><pre><span></span>test_singa.exe
+</pre></div>
+</div>
+</div></blockquote>
+</li>
+<li><dl class="first docutils">
+<dt>From Visual Studio:</dt>
+<dd><ul class="first last simple">
+<li>right click on the test_singa project and choose âSet as StartUp Projectâ.</li>
+<li>from the Debug menu, choose âStart Without Debuggingâ</li>
+</ul>
+</dd>
+</dl>
+</li>
+</ul>
+</div></blockquote>
+</li>
+</ul>
+<p>A video tutorial for running the unit tests can be found here:</p>
+<table border="1" class="docutils">
+<colgroup>
+<col width="100%" />
+</colgroup>
+<tbody valign="top">
+<tr class="row-odd"><td><a class="reference external" href="https://www.youtube.com/watch?v=YasKVjRtuDs"><img alt="video" class="align-middle" src="https://img.youtube.com/vi/YasKVjRtuDs/0.jpg" /></a></td>
+</tr>
+</tbody>
+</table>
+</div>
+<div class="section" id="build-gpu-support-with-cuda">
+<h2>5. Build GPU support with CUDA<a class="headerlink" href="#build-gpu-support-with-cuda" title="Permalink to this headline">¶</a></h2>
+<p>In this section, we will extend the previous steps to enable GPU.</p>
+</div>
+<div class="section" id="id1">
+<h2>5.1 Install Dependencies<a class="headerlink" href="#id1" title="Permalink to this headline">¶</a></h2>
+<p>In addition to the dependencies in section 1 above, we will need the following:</p>
+<ul>
+<li><p class="first">CUDA</p>
+<blockquote>
+<div><p>Download a suitable version such as 9.1 from <a class="reference external" href="https://developer.nvidia.com/cuda-downloads">https://developer.nvidia.com/cuda-downloads</a> . Make sure to install the Visual Studio integration module.</p>
+</div></blockquote>
+</li>
+<li><p class="first">cuDNN</p>
+<blockquote>
+<div><p>Download a suitable version such as 7.1 from <a class="reference external" href="https://developer.nvidia.com/cudnn">https://developer.nvidia.com/cudnn</a></p>
+</div></blockquote>
+</li>
+<li><p class="first">cnmem:</p>
+<blockquote>
+<div><ul>
+<li><p class="first">Download the latest version from <a class="reference external" href="https://github.com/NVIDIA/cnmem">https://github.com/NVIDIA/cnmem</a></p>
+</li>
+<li><p class="first">Build the Visual Studio solution:</p>
+<blockquote>
+<div><div class="highlight-bash notranslate"><div class="highlight"><pre><span></span>cmake -G <span class="s2">"Visual Studio 15 2017 Win64"</span>
+</pre></div>
+</div>
+</div></blockquote>
+</li>
+<li><p class="first">Open the generated solution in Visual Studio.</p>
+</li>
+<li><p class="first">Change the build settings to Release and x64.</p>
+</li>
+<li><p class="first">Build the cnmem project.</p>
+</li>
+</ul>
+</div></blockquote>
+</li>
+</ul>
+</div>
+<div class="section" id="id2">
+<h2>5.2 Build SINGA source<a class="headerlink" href="#id2" title="Permalink to this headline">¶</a></h2>
+<ul>
+<li><p class="first">Call cmake and add the paths in your system similar to the following example:</p>
+<blockquote>
+<div><div class="highlight-bash notranslate"><div class="highlight"><pre><span></span>cmake -G <span class="s2">"Visual Studio 15 2017 Win64"</span> ^
+ -DGLOG_INCLUDE_DIR<span class="o">=</span><span class="s2">"D:/WinSinga/dependencies/glog-0.3.5/src/windows"</span> ^
+ -DGLOG_LIBRARIES<span class="o">=</span><span class="s2">"D:/WinSinga/dependencies/glog-0.3.5/x64/Release"</span> ^
+ -DCBLAS_INCLUDE_DIR<span class="o">=</span><span class="s2">"D:/WinSinga/dependencies/openblas-0.2.20/lapack-netlib/CBLAS/include"</span> ^
+ -DCBLAS_LIBRARIES<span class="o">=</span><span class="s2">"D:/WinSinga/dependencies/openblas-0.2.20/lib/RELEASE"</span> ^
+ -DProtobuf_INCLUDE_DIR<span class="o">=</span><span class="s2">"D:/WinSinga/dependencies/protobuf-2.6.1/src"</span> ^
+ -DProtobuf_LIBRARIES<span class="o">=</span><span class="s2">"D:\WinSinga/dependencies/protobuf-2.6.1/vsprojects/x64/Release"</span> ^
+ -DProtobuf_PROTOC_EXECUTABLE<span class="o">=</span><span class="s2">"D:/WinSinga/dependencies/protoc-2.6.1-win32/protoc.exe"</span> ^
+ -DCUDNN_INCLUDE_DIR<span class="o">=</span>D:<span class="se">\W</span>inSinga<span class="se">\d</span>ependencies<span class="se">\c</span>udnn-9.1-windows10-x64-v7.1<span class="se">\c</span>uda<span class="se">\i</span>nclude ^
+ -DCUDNN_LIBRARIES<span class="o">=</span>D:<span class="se">\W</span>inSinga<span class="se">\d</span>ependencies<span class="se">\c</span>udnn-9.1-windows10-x64-v7.1<span class="se">\c</span>uda<span class="se">\l</span>ib<span class="se">\x</span><span class="m">64</span> ^
+ -DSWIG_DIR<span class="o">=</span>D:<span class="se">\W</span>inSinga<span class="se">\d</span>ependencies<span class="se">\s</span>wigwin-3.0.12 ^
+ -DSWIG_EXECUTABLE<span class="o">=</span>D:<span class="se">\W</span>inSinga<span class="se">\d</span>ependencies<span class="se">\s</span>wigwin-3.0.12<span class="se">\s</span>wig.exe ^
+ -DUSE_CUDA<span class="o">=</span>YES ^
+ -DCUDNN_VERSION<span class="o">=</span><span class="m">7</span> ^
+ ..
+</pre></div>
+</div>
+</div></blockquote>
+</li>
+<li><dl class="first docutils">
+<dt>Generate swig interfaces for C++ and Python:</dt>
+<dd><p class="first">Goto src/api</p>
+<div class="last highlight-bash notranslate"><div class="highlight"><pre><span></span>swig -python -c++ singa.i
+</pre></div>
+</div>
+</dd>
+</dl>
+</li>
+<li><p class="first">Open the generated solution in Visual Studio</p>
+</li>
+<li><p class="first">Change the build settings to Release and x64</p>
+</li>
+</ul>
+</div>
+<div class="section" id="building-singa-objects">
+<h2>5.2.1 Building singa_objects<a class="headerlink" href="#building-singa-objects" title="Permalink to this headline">¶</a></h2>
+<ul class="simple">
+<li>Add the singa_wrap.cxx file from src/api to the singa_objects project</li>
+<li>In the singa_objects project, open Additional Include Directories.</li>
+<li>Add Python include path</li>
+<li>Add numpy include path</li>
+<li>Add protobuf include path</li>
+<li>Add include path for CUDA, cuDNN and cnmem</li>
+<li>In the preprocessor definitions of the singa_objects project, add USE_GLOG, USE_CUDA and USE_CUDNN. Remove DISABLE_WARNINGS.</li>
+<li>Build singa_objects project</li>
+</ul>
+</div>
+<div class="section" id="building-singa-kernel">
+<h2>5.2.2 Building singa-kernel<a class="headerlink" href="#building-singa-kernel" title="Permalink to this headline">¶</a></h2>
+<ul>
+<li><p class="first">Create a new Visual Studio projcet of type âCUDA 9.1 Runtimeâ. Give it a name such as singa-kernel.</p>
+</li>
+<li><p class="first">The project comes with an initial file called kernel.cu. Remove this file from the project.</p>
+</li>
+<li><p class="first">Add this file: src/core/tensor/math_kernel.cu</p>
+</li>
+<li><p class="first">In the project settings:</p>
+<blockquote>
+<div><ul class="simple">
+<li>Set Platfrom Toolset to âVisual Studio 2015 (v140)â</li>
+<li>Set Configuration Type to â Static Library (.lib)â</li>
+<li>In the Include Directories, add build/include.</li>
+</ul>
+</div></blockquote>
+</li>
+<li><p class="first">Build singa-kernel project</p>
+</li>
+</ul>
+</div>
+<div class="section" id="building-singa">
+<h2>5.2.3 Building singa<a class="headerlink" href="#building-singa" title="Permalink to this headline">¶</a></h2>
+<ul class="simple">
+<li><dl class="first docutils">
+<dt>In singa project:</dt>
+<dd><ul class="first last">
+<li>add singa_wrap.obj to Object Libraries</li>
+<li>change target name to _singa_wrap</li>
+<li>change target extension to .pyd</li>
+<li>change configuration type to Dynamic Library (.dll)</li>
+<li>goto Additional Library Directories and add the path to python, openblas, protobuf and glog libraries</li>
+<li>Add also the library path to singa-kernel, cnmem, cuda and cudnn.</li>
+<li>goto Additional Dependencies and add libopenblas.lib, libglog.lib and libprotobuf.lib.</li>
+<li>Add also: singa-kernel.lib, cnmem.lib, cudnn.lib, cuda.lib , cublas.lib, curand.lib and cudart.lib.</li>
+</ul>
+</dd>
+</dl>
+</li>
+<li>build singa project</li>
+</ul>
+</div>
+<div class="section" id="id3">
+<h2>5.3. Install Python module<a class="headerlink" href="#id3" title="Permalink to this headline">¶</a></h2>
+<ul class="simple">
+<li>Change _singa_wrap.so to _singa_wrap.pyd in build/python/setup.py</li>
+<li>Copy the files in src/proto/python_out to build/python/singa/proto</li>
+<li>Optionally create and activate a virtual environment:</li>
+</ul>
+<div class="highlight-bash notranslate"><div class="highlight"><pre><span></span>mkdir SingaEnv
+virtualenv SingaEnv
+SingaEnv<span class="se">\S</span>cripts<span class="se">\a</span>ctivate
+</pre></div>
+</div>
+<ul class="simple">
+<li>goto build/python folder and run:</li>
+</ul>
+<div class="highlight-bash notranslate"><div class="highlight"><pre><span></span>python setup.py install
+</pre></div>
+</div>
+<ul class="simple">
+<li>Make _singa_wrap.pyd, libglog.dll, libopenblas.dll, cnmem.dll, CUDA Runtime (e.g. cudart64_91.dll) and cuDNN (e.g. cudnn64_7.dll) available by adding them to the path or by copying them to singa package folder in the python site-packages</li>
+<li>Verify that SINGA is installed by running:</li>
+</ul>
+<div class="highlight-bash notranslate"><div class="highlight"><pre><span></span>python -c <span class="s2">"from singa import device; dev = device.create_cuda_gpu()"</span>
+</pre></div>
+</div>
+<p>A video tutorial for this part can be found here:</p>
+<table border="1" class="docutils">
+<colgroup>
+<col width="100%" />
+</colgroup>
+<tbody valign="top">
+<tr class="row-odd"><td><a class="reference external" href="https://www.youtube.com/watch?v=YasKVjRtuDs"><img alt="video" class="align-middle" src="https://img.youtube.com/vi/YasKVjRtuDs/0.jpg" /></a></td>
</tr>
</tbody>
</table>
@@ -419,7 +654,7 @@ SingaEnv<span class="se">\S</span>cripts
});
</script>
-<div class="rst-versions shift-up" data-toggle="rst-versions" role="note" aria-label="versions">
+<div class="rst-versions" data-toggle="rst-versions" role="note" aria-label="versions">
<span class="rst-current-version" data-toggle="rst-current-version">
<span class="fa fa-book"> incubator-singa </span>
v: latest