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 2017/08/27 13:42:12 UTC
svn commit: r1806365 [1/2] - in /incubator/singa/site/trunk/en: ./
_sources/community/ _sources/docs/
_sources/docs/model_zoo/examples/imagenet/inception/
_sources/docs/model_zoo/examples/imagenet/vgg/ community/ docs/
docs/model_zoo/examples/imagenet/...
Author: wangwei
Date: Sun Aug 27 13:42:12 2017
New Revision: 1806365
URL: http://svn.apache.org/viewvc?rev=1806365&view=rev
Log:
update the docs by jenkins for commit 074c551
Added:
incubator/singa/site/trunk/en/_sources/docs/model_zoo/examples/imagenet/inception/
incubator/singa/site/trunk/en/_sources/docs/model_zoo/examples/imagenet/inception/README.md.txt
incubator/singa/site/trunk/en/_sources/docs/model_zoo/examples/imagenet/vgg/
incubator/singa/site/trunk/en/_sources/docs/model_zoo/examples/imagenet/vgg/README.md.txt
incubator/singa/site/trunk/en/docs/model_zoo/examples/imagenet/inception/
incubator/singa/site/trunk/en/docs/model_zoo/examples/imagenet/inception/README.html
incubator/singa/site/trunk/en/docs/model_zoo/examples/imagenet/vgg/
incubator/singa/site/trunk/en/docs/model_zoo/examples/imagenet/vgg/README.html
Modified:
incubator/singa/site/trunk/en/_sources/community/team-list.rst.txt
incubator/singa/site/trunk/en/_sources/docs/installation.md.txt
incubator/singa/site/trunk/en/community/team-list.html
incubator/singa/site/trunk/en/docs.html
incubator/singa/site/trunk/en/docs/index.html
incubator/singa/site/trunk/en/docs/installation.html
incubator/singa/site/trunk/en/objects.inv
incubator/singa/site/trunk/en/searchindex.js
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=1806365&r1=1806364&r2=1806365&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 Sun Aug 27 13:42:12 2017
@@ -76,4 +76,7 @@ Developers
+--------------------+--------------------------------+-----------------------------------------------+
| Kaiping Zheng | kaiping@apache.org | National University of Singapore |
+--------------------+--------------------------------+-----------------------------------------------+
-
+| Moaz Reyad | moazreyad@gmail.com | National University of Singapore |
++--------------------+--------------------------------+-----------------------------------------------+
+| Chang Yao | yaochang2009@gmail.com | yzBigdata |
++--------------------+--------------------------------+-----------------------------------------------+
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=1806365&r1=1806364&r2=1806365&view=diff
==============================================================================
--- incubator/singa/site/trunk/en/_sources/docs/installation.md.txt (original)
+++ incubator/singa/site/trunk/en/_sources/docs/installation.md.txt Sun Aug 27 13:42:12 2017
@@ -3,7 +3,7 @@
## 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 (Python2.7) for Linux and MacOSX.
+Currently, SINGA has conda packages (Python 2.7 and Python 3.6) for Linux and MacOSX.
### Linux
@@ -105,10 +105,13 @@ The following libraries are optional
2. run `cmake [options] ..`
by default all options are OFF except `USE_PYTHON`
- * `USE_MODUELS=ON`, used if protobuf and blas are not installed a prior
+ * `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
+ * `PYTHON3=ON`, used for compiling with Python 3 support. (The default is Python 2)
+ * `PACKAGE=ON`, used for building the Debian package
+
3. compile the code, e.g., `make`
4. goto python folder
5. run `pip install .`
@@ -127,8 +130,10 @@ The following instructions are tested on
# required libraries
$ sudo apt-get install libprotobuf-dev libopenblas-dev protobuf-compiler
- # optional libraries
+ # 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
The following instructions are tested on Mac OS X Yosemite (10.11 and 10.12) for installing dependent libraries.
@@ -258,6 +263,17 @@ To build SINGA with OpenCL support, you
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.
+
+#### Compile SINGA with PACKAGE=ON
+
+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
For the dependent library installation, please refer to [Dependencies](dependencies.md).
@@ -299,7 +315,7 @@ just copy the dll files into the same fo
* Q: Error from 'import singa' using PySINGA installed from wheel.
A: Please check the detailed error from `python -c "from singa import _singa_wrap"`. Sometimes it is
- caused by the dependent libraries, e.g. there are multiple versions of protobuf or missing of cudnn. Following
+ caused by the dependent libraries, e.g. there are multiple versions of protobuf, missing of cudnn, numpy version mismatch. Following
steps show the solutions for different cases
1. Check the cudnn and cuda and gcc versions, cudnn5 and cuda7.5 and gcc4.8/4.9 are preferred. if gcc is 5.0, then downgrade it.
If cudnn is missing or not match with the wheel version, you can download the correct version of cudnn into ~/local/cudnn/ and
@@ -316,9 +332,18 @@ just copy the dll files into the same fo
$ source ~/.bashrc
3. If it cannot find other libs including python, then create virtual env using pip or conda;
- and then install SINGA via
- $ pip install --upgrade <url of singa wheel>
+ 4. If it is not caused by the above reasons, go to the folder of `_singa_wrap.so`,
+
+ $ python
+ >> import importlib
+ >> importlib.import_module('_singa_wrap')
+
+ Check the error message. For example, if the numpy version mismatches, the error message would be,
+
+ RuntimeError: module compiled against API version 0xb but this version of numpy is 0xa
+
+ Then you need to upgrade the numpy.
* Q: Error from running `cmake ..`, which cannot find the dependent libraries.
@@ -417,7 +442,7 @@ just copy the dll files into the same fo
* Q: When I run PySINGA in Mac OS X, I got the error "Fatal Python error: PyThreadState_Get: no current thread Abort trap: 6"
- A: This error happens typically when you have multiple version of Python on your system,
+ A: This error happens typically when you have multiple version of Python on your system and you installed SINGA via pip (this problem is resolved for installation via conda),
e.g, the one comes with the OS and the one installed by Homebrew. The Python linked by PySINGA must be the same as the Python interpreter.
You can check your interpreter by `which python` and check the Python linked by PySINGA via `otool -L <path to _singa_wrap.so>`.
To fix this error, compile SINGA with the correct version of Python.
Added: incubator/singa/site/trunk/en/_sources/docs/model_zoo/examples/imagenet/inception/README.md.txt
URL: http://svn.apache.org/viewvc/incubator/singa/site/trunk/en/_sources/docs/model_zoo/examples/imagenet/inception/README.md.txt?rev=1806365&view=auto
==============================================================================
--- incubator/singa/site/trunk/en/_sources/docs/model_zoo/examples/imagenet/inception/README.md.txt (added)
+++ incubator/singa/site/trunk/en/_sources/docs/model_zoo/examples/imagenet/inception/README.md.txt Sun Aug 27 13:42:12 2017
@@ -0,0 +1,43 @@
+---
+name: Inception V4 on ImageNet
+SINGA version: 1.1.1
+SINGA commit:
+parameter_url: https://s3-ap-southeast-1.amazonaws.com/dlfile/inception_v4.tar.gz
+parameter_sha1: 5fdd6f5d8af8fd10e7321d9b38bb87ef14e80d56
+license: https://github.com/tensorflow/models/tree/master/slim
+---
+
+# Image Classification using Inception V4
+
+In this example, we convert Inception V4 trained on Tensorflow to SINGA for image classification.
+
+## Instructions
+
+* Download the parameter checkpoint file
+
+ $ wget
+ $ tar xvf inception_v4.tar.gz
+
+* Download [synset_word.txt](https://github.com/BVLC/caffe/blob/master/data/ilsvrc12/get_ilsvrc_aux.sh) file.
+
+* Run the program
+
+ # use cpu
+ $ python serve.py -C &
+ # use gpu
+ $ python serve.py &
+
+* Submit images for classification
+
+ $ curl -i -F image=@image1.jpg http://localhost:9999/api
+ $ curl -i -F image=@image2.jpg http://localhost:9999/api
+ $ curl -i -F image=@image3.jpg http://localhost:9999/api
+
+image1.jpg, image2.jpg and image3.jpg should be downloaded before executing the above commands.
+
+## Details
+
+We first extract the parameter values from [Tensorflow's checkpoint file](http://download.tensorflow.org/models/inception_v4_2016_09_09.tar.gz) into a pickle version.
+After downloading and decompressing the checkpoint file, run the following script
+
+ $ python convert.py --file_name=inception_v4.ckpt
Added: incubator/singa/site/trunk/en/_sources/docs/model_zoo/examples/imagenet/vgg/README.md.txt
URL: http://svn.apache.org/viewvc/incubator/singa/site/trunk/en/_sources/docs/model_zoo/examples/imagenet/vgg/README.md.txt?rev=1806365&view=auto
==============================================================================
--- incubator/singa/site/trunk/en/_sources/docs/model_zoo/examples/imagenet/vgg/README.md.txt (added)
+++ incubator/singa/site/trunk/en/_sources/docs/model_zoo/examples/imagenet/vgg/README.md.txt Sun Aug 27 13:42:12 2017
@@ -0,0 +1,51 @@
+---
+name: VGG models on ImageNet
+SINGA version: 1.1.1
+SINGA commit:
+license: https://github.com/pytorch/vision/blob/master/torchvision/models/vgg.py
+---
+
+# Image Classification using VGG
+
+
+In this example, we convert VGG on [PyTorch](https://github.com/pytorch/vision/blob/master/torchvision/models/vgg.py)
+to SINGA for image classification.
+
+## Instructions
+
+* Download one parameter checkpoint file (see below) and the synset word file of ImageNet into this folder, e.g.,
+
+ $ wget https://s3-ap-southeast-1.amazonaws.com/dlfile/vgg/vgg11.tar.gz
+ $ wget https://s3-ap-southeast-1.amazonaws.com/dlfile/resnet/synset_words.txt
+ $ tar xvf vgg11.tar.gz
+
+* Usage
+
+ $ python serve.py -h
+
+* Example
+
+ # use cpu
+ $ python serve.py --use_cpu --parameter_file vgg11.pickle --depth 11 --use_cpu &
+ # use gpu
+ $ python serve.py --use_cpu --parameter_file vgg11.pickle --depth 11 &
+
+ The parameter files for the following model and depth configuration pairs are provided:
+ * Without batch-normalization, [11](https://s3-ap-southeast-1.amazonaws.com/dlfile/vgg/vgg11.tar.gz), [13](https://s3-ap-southeast-1.amazonaws.com/dlfile/vgg/vgg13.tar.gz), [16](https://s3-ap-southeast-1.amazonaws.com/dlfile/vgg/vgg16.tar.gz), [19](https://s3-ap-southeast-1.amazonaws.com/dlfile/vgg/vgg19.tar.gz)
+ * With batch-normalization, [11](https://s3-ap-southeast-1.amazonaws.com/dlfile/vgg/vgg11_bn.tar.gz), [13](https://s3-ap-southeast-1.amazonaws.com/dlfile/vgg/vgg13_bn.tar.gz), [16](https://s3-ap-southeast-1.amazonaws.com/dlfile/vgg/vgg16_bn.tar.gz), [19](https://s3-ap-southeast-1.amazonaws.com/dlfile/vgg/vgg19_bn.tar.gz)
+
+* Submit images for classification
+
+ $ curl -i -F image=@image1.jpg http://localhost:9999/api
+ $ curl -i -F image=@image2.jpg http://localhost:9999/api
+ $ curl -i -F image=@image3.jpg http://localhost:9999/api
+
+image1.jpg, image2.jpg and image3.jpg should be downloaded before executing the above commands.
+
+## Details
+
+The parameter files were converted from the pytorch via the convert.py program.
+
+Usage:
+
+ $ python convert.py -h
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=1806365&r1=1806364&r2=1806365&view=diff
==============================================================================
--- incubator/singa/site/trunk/en/community/team-list.html (original)
+++ incubator/singa/site/trunk/en/community/team-list.html Sun Aug 27 13:42:12 2017
@@ -270,6 +270,14 @@
<td><a class="reference external" href="mailto:kaiping%40apache.org">kaiping<span>@</span>apache<span>.</span>org</a></td>
<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>National University of Singapore</td>
+</tr>
+<tr class="row-odd"><td>Chang Yao</td>
+<td><a class="reference external" href="mailto:yaochang2009%40gmail.com">yaochang2009<span>@</span>gmail<span>.</span>com</a></td>
+<td>yzBigdata</td>
+</tr>
</tbody>
</table>
</div>
Modified: incubator/singa/site/trunk/en/docs.html
URL: http://svn.apache.org/viewvc/incubator/singa/site/trunk/en/docs.html?rev=1806365&r1=1806364&r2=1806365&view=diff
==============================================================================
--- incubator/singa/site/trunk/en/docs.html (original)
+++ incubator/singa/site/trunk/en/docs.html Sun Aug 27 13:42:12 2017
@@ -167,6 +167,8 @@
<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>
</ul>
</li>
<li class="toctree-l4"><a class="reference internal" href="docs/installation.html#compile-singa-on-windows">Compile SINGA on Windows</a></li>
Modified: incubator/singa/site/trunk/en/docs/index.html
URL: http://svn.apache.org/viewvc/incubator/singa/site/trunk/en/docs/index.html?rev=1806365&r1=1806364&r2=1806365&view=diff
==============================================================================
--- incubator/singa/site/trunk/en/docs/index.html (original)
+++ incubator/singa/site/trunk/en/docs/index.html Sun Aug 27 13:42:12 2017
@@ -186,6 +186,8 @@
<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>
</ul>
</li>
<li class="toctree-l3"><a class="reference internal" href="installation.html#compile-singa-on-windows">Compile SINGA on Windows</a></li>
Modified: incubator/singa/site/trunk/en/docs/installation.html
URL: http://svn.apache.org/viewvc/incubator/singa/site/trunk/en/docs/installation.html?rev=1806365&r1=1806364&r2=1806365&view=diff
==============================================================================
--- incubator/singa/site/trunk/en/docs/installation.html (original)
+++ incubator/singa/site/trunk/en/docs/installation.html Sun Aug 27 13:42:12 2017
@@ -191,7 +191,7 @@
<div class="section" id="from-conda">
<span id="from-conda"></span><h2>From Conda<a class="headerlink" href="#from-conda" title="Permalink to this headline">¶</a></h2>
<p>Conda is a package manager provided by <a class="reference external" href="https://www.continuum.io/downloads">Anaconda</a> or <a class="reference external" href="https://conda.io/miniconda.html">Miniconda</a>.
-Currently, SINGA has conda packages (Python2.7) for Linux and MacOSX.</p>
+Currently, SINGA has conda packages (Python 2.7 and Python 3.6) for Linux and MacOSX.</p>
<div class="section" id="linux">
<span id="linux"></span><h3>Linux<a class="headerlink" href="#linux" title="Permalink to this headline">¶</a></h3>
<ol>
@@ -295,10 +295,12 @@ $ cd incubator-singa/
<li>create a <code class="docutils literal"><span class="pre">build</span></code> folder inside incubator-singa and go into that folder</li>
<li>run <code class="docutils literal"><span class="pre">cmake</span> <span class="pre">[options]</span> <span class="pre">..</span></code>
by default all options are OFF except <code class="docutils literal"><span class="pre">USE_PYTHON</span></code><ul>
-<li><code class="docutils literal"><span class="pre">USE_MODUELS=ON</span></code>, used if protobuf and blas are not installed a prior</li>
+<li><code class="docutils literal"><span class="pre">USE_MODULES=ON</span></code>, used if protobuf and blas are not installed a prior</li>
<li><code class="docutils literal"><span class="pre">USE_CUDA=ON</span></code>, used if CUDA and cuDNN is available</li>
<li><code class="docutils literal"><span class="pre">USE_PYTHON=ON</span></code>, used for compiling PySINGA</li>
<li><code class="docutils literal"><span class="pre">USE_OPENCL=ON</span></code>, used for compiling with OpenCL support</li>
+<li><code class="docutils literal"><span class="pre">PYTHON3=ON</span></code>, used for compiling with Python 3 support. (The default is Python 2)</li>
+<li><code class="docutils literal"><span class="pre">PACKAGE=ON</span></code>, used for building the Debian package</li>
</ul>
</li>
<li>compile the code, e.g., <code class="docutils literal"><span class="pre">make</span></code></li>
@@ -317,8 +319,10 @@ apt-get, yum, and homebrew. Please refer
<div class="highlight-default"><div class="highlight"><pre><span></span># required libraries
$ sudo apt-get install libprotobuf-dev libopenblas-dev protobuf-compiler
-# optional libraries
+# 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
</pre></div>
</div>
@@ -444,6 +448,18 @@ Remember to add its directory to <code c
</pre></div>
</div>
</div>
+<div class="section" id="compile-singa-with-python2-on">
+<span id="compile-singa-with-python2-on"></span><h4>Compile SINGA with PYTHON2=ON<a class="headerlink" href="#compile-singa-with-python2-on" title="Permalink to this headline">¶</a></h4>
+<p>The default Python version for SINGA is 3. SINGA can be built for Python 2 by setting PYTHON2=ON.</p>
+</div>
+<div class="section" id="compile-singa-with-package-on">
+<span id="compile-singa-with-package-on"></span><h4>Compile SINGA with PACKAGE=ON<a class="headerlink" href="#compile-singa-with-package-on" title="Permalink to this headline">¶</a></h4>
+<p>This setting is used to build the Debian package. Set PACKAGE=ON and build the package with make command like this:</p>
+<div class="highlight-default"><div class="highlight"><pre><span></span>$ cmake -DPACKAGE=ON
+$ make package
+</pre></div>
+</div>
+</div>
</div>
<div class="section" id="compile-singa-on-windows">
<span id="compile-singa-on-windows"></span><h3>Compile SINGA on Windows<a class="headerlink" href="#compile-singa-on-windows" title="Permalink to this headline">¶</a></h3>
@@ -487,7 +503,7 @@ just copy the dll files into the same fo
<ul>
<li><p class="first">Q: Error from ‘import singa’ using PySINGA installed from wheel.</p>
<p>A: Please check the detailed error from <code class="docutils literal"><span class="pre">python</span> <span class="pre">-c</span> <span class="pre">"from</span> <span class="pre">singa</span> <span class="pre">import</span> <span class="pre">_singa_wrap"</span></code>. Sometimes it is
-caused by the dependent libraries, e.g. there are multiple versions of protobuf or missing of cudnn. Following
+caused by the dependent libraries, e.g. there are multiple versions of protobuf, missing of cudnn, numpy version mismatch. Following
steps show the solutions for different cases</p>
<ol>
<li><p class="first">Check the cudnn and cuda and gcc versions, cudnn5 and cuda7.5 and gcc4.8/4.9 are preferred. if gcc is 5.0, then downgrade it.
@@ -506,13 +522,23 @@ Decompress the tar file, and then</p>
</pre></div>
</div>
</li>
-<li><p class="first">If it cannot find other libs including python, then create virtual env using pip or conda;
-and then install SINGA via</p>
-<div class="highlight-default"><div class="highlight"><pre><span></span> $ pip install --upgrade <url of singa wheel>
+<li><p class="first">If it cannot find other libs including python, then create virtual env using pip or conda;</p>
+</li>
+<li><p class="first">If it is not caused by the above reasons, go to the folder of <code class="docutils literal"><span class="pre">_singa_wrap.so</span></code>,</p>
+<div class="highlight-default"><div class="highlight"><pre><span></span> $ python
+ >> import importlib
+ >> importlib.import_module('_singa_wrap')
</pre></div>
</div>
</li>
</ol>
+<div class="highlight-default"><div class="highlight"><pre><span></span><span class="n">Check</span> <span class="n">the</span> <span class="n">error</span> <span class="n">message</span><span class="o">.</span> <span class="n">For</span> <span class="n">example</span><span class="p">,</span> <span class="k">if</span> <span class="n">the</span> <span class="n">numpy</span> <span class="n">version</span> <span class="n">mismatches</span><span class="p">,</span> <span class="n">the</span> <span class="n">error</span> <span class="n">message</span> <span class="n">would</span> <span class="n">be</span><span class="p">,</span>
+
+ <span class="ne">RuntimeError</span><span class="p">:</span> <span class="n">module</span> <span class="n">compiled</span> <span class="n">against</span> <span class="n">API</span> <span class="n">version</span> <span class="mh">0xb</span> <span class="n">but</span> <span class="n">this</span> <span class="n">version</span> <span class="n">of</span> <span class="n">numpy</span> <span class="ow">is</span> <span class="mh">0xa</span>
+
+<span class="n">Then</span> <span class="n">you</span> <span class="n">need</span> <span class="n">to</span> <span class="n">upgrade</span> <span class="n">the</span> <span class="n">numpy</span><span class="o">.</span>
+</pre></div>
+</div>
</li>
</ul>
<ul>
@@ -611,7 +637,7 @@ the virtual environment.</p>
</div>
</li>
<li><p class="first">Q: When I run PySINGA in Mac OS X, I got the error “Fatal Python error: PyThreadState_Get: no current thread Abort trap: 6”</p>
-<p>A: This error happens typically when you have multiple version of Python on your system,
+<p>A: This error happens typically when you have multiple version of Python on your system and you installed SINGA via pip (this problem is resolved for installation via conda),
e.g, the one comes with the OS and the one installed by Homebrew. The Python linked by PySINGA must be the same as the Python interpreter.
You can check your interpreter by <code class="docutils literal"><span class="pre">which</span> <span class="pre">python</span></code> and check the Python linked by PySINGA via <code class="docutils literal"><span class="pre">otool</span> <span class="pre">-L</span> <span class="pre"><path</span> <span class="pre">to</span> <span class="pre">_singa_wrap.so></span></code>.
To fix this error, compile SINGA with the correct version of Python.
Added: incubator/singa/site/trunk/en/docs/model_zoo/examples/imagenet/inception/README.html
URL: http://svn.apache.org/viewvc/incubator/singa/site/trunk/en/docs/model_zoo/examples/imagenet/inception/README.html?rev=1806365&view=auto
==============================================================================
--- incubator/singa/site/trunk/en/docs/model_zoo/examples/imagenet/inception/README.html (added)
+++ incubator/singa/site/trunk/en/docs/model_zoo/examples/imagenet/inception/README.html Sun Aug 27 13:42:12 2017
@@ -0,0 +1,290 @@
+
+
+
+<!DOCTYPE html>
+<!--[if IE 8]><html class="no-js lt-ie9" lang="en" > <![endif]-->
+<!--[if gt IE 8]><!--> <html class="no-js" lang="en" > <!--<![endif]-->
+<head>
+ <meta charset="utf-8">
+
+ <meta name="viewport" content="width=device-width, initial-scale=1.0">
+
+ <title>Image Classification using Inception V4 — incubator-singa 1.1.0 documentation</title>
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ <link rel="stylesheet" href="../../../../../_static/css/theme.css" type="text/css" />
+
+
+
+
+
+ <link rel="index" title="Index"
+ href="../../../../../genindex.html"/>
+ <link rel="search" title="Search" href="../../../../../search.html"/>
+ <link rel="top" title="incubator-singa 1.1.0 documentation" href="../../../../../index.html"/>
+ <link href="../../../../../_static/style.css" rel="stylesheet" type="text/css">
+
+
+
+ <script src="../../../../../_static/js/modernizr.min.js"></script>
+
+</head>
+
+<body class="wy-body-for-nav" role="document">
+
+ <div class="wy-grid-for-nav">
+
+
+ <nav data-toggle="wy-nav-shift" class="wy-nav-side">
+ <div class="wy-side-scroll">
+ <div class="wy-side-nav-search">
+
+
+
+ <a href="../../../../../index.html" class="icon icon-home"> incubator-singa
+
+
+
+
+ <img src="../../../../../_static/singa.png" class="logo" />
+
+ </a>
+
+
+
+
+ <div class="version">
+ latest
+ </div>
+
+
+
+
+<div role="search">
+ <form id="rtd-search-form" class="wy-form" action="../../../../../search.html" method="get">
+ <input type="text" name="q" placeholder="Search docs" />
+ <input type="hidden" name="check_keywords" value="yes" />
+ <input type="hidden" name="area" value="default" />
+ </form>
+</div>
+
+
+ </div>
+
+ <div class="wy-menu wy-menu-vertical" data-spy="affix" role="navigation" aria-label="main navigation">
+
+
+
+ <ul>
+<li class="toctree-l1"><a class="reference internal" href="../../../../../downloads.html">Download SINGA</a></li>
+<li class="toctree-l1"><a class="reference internal" href="../../../../index.html">Documentation</a></li>
+</ul>
+<p class="caption"><span class="caption-text">Development</span></p>
+<ul>
+<li class="toctree-l1"><a class="reference internal" href="../../../../../develop/schedule.html">Development Schedule</a></li>
+<li class="toctree-l1"><a class="reference internal" href="../../../../../develop/how-contribute.html">How to Contribute to SINGA</a></li>
+<li class="toctree-l1"><a class="reference internal" href="../../../../../develop/contribute-code.html">How to Contribute Code</a></li>
+<li class="toctree-l1"><a class="reference internal" href="../../../../../develop/contribute-docs.html">How to Contribute to Documentation</a></li>
+</ul>
+<p class="caption"><span class="caption-text">Community</span></p>
+<ul>
+<li class="toctree-l1"><a class="reference internal" href="../../../../../community/source-repository.html">Source Repository</a></li>
+<li class="toctree-l1"><a class="reference internal" href="../../../../../community/mail-lists.html">Project Mailing Lists</a></li>
+<li class="toctree-l1"><a class="reference internal" href="../../../../../community/issue-tracking.html">Issue Tracking</a></li>
+<li class="toctree-l1"><a class="reference internal" href="../../../../../community/team-list.html">The SINGA Team</a></li>
+</ul>
+
+
+
+ </div>
+ </div>
+ </nav>
+
+ <section data-toggle="wy-nav-shift" class="wy-nav-content-wrap">
+
+
+ <nav class="wy-nav-top" role="navigation" aria-label="top navigation">
+ <i data-toggle="wy-nav-top" class="fa fa-bars"></i>
+ <a href="../../../../../index.html">incubator-singa</a>
+ </nav>
+
+
+
+ <div class="wy-nav-content">
+ <div class="rst-content">
+
+
+
+
+
+
+<div role="navigation" aria-label="breadcrumbs navigation">
+ <ul class="wy-breadcrumbs">
+ <li><a href="../../../../../index.html">Docs</a> »</li>
+
+ <li>Image Classification using Inception V4</li>
+ <li class="wy-breadcrumbs-aside">
+
+
+
+ </li>
+ </ul>
+ <hr/>
+</div>
+ <div role="main" class="document" itemscope="itemscope" itemtype="http://schema.org/Article">
+ <div itemprop="articleBody">
+
+ <hr class="docutils" />
+<p>name: Inception V4 on ImageNet
+SINGA version: 1.1.1
+SINGA commit:
+parameter_url: https://s3-ap-southeast-1.amazonaws.com/dlfile/inception_v4.tar.gz
+parameter_sha1: 5fdd6f5d8af8fd10e7321d9b38bb87ef14e80d56
+license: https://github.com/tensorflow/models/tree/master/slim</p>
+<hr class="docutils" />
+<div class="section" id="image-classification-using-inception-v4">
+<span id="image-classification-using-inception-v4"></span><h1>Image Classification using Inception V4<a class="headerlink" href="#image-classification-using-inception-v4" title="Permalink to this headline">¶</a></h1>
+<p>In this example, we convert Inception V4 trained on Tensorflow to SINGA for image classification.</p>
+<div class="section" id="instructions">
+<span id="instructions"></span><h2>Instructions<a class="headerlink" href="#instructions" title="Permalink to this headline">¶</a></h2>
+<ul>
+<li><p class="first">Download the parameter checkpoint file</p>
+<div class="highlight-default"><div class="highlight"><pre><span></span> $ wget
+ $ tar xvf inception_v4.tar.gz
+</pre></div>
+</div>
+</li>
+<li><p class="first">Download <a class="reference external" href="https://github.com/BVLC/caffe/blob/master/data/ilsvrc12/get_ilsvrc_aux.sh">synset_word.txt</a> file.</p>
+</li>
+<li><p class="first">Run the program</p>
+<div class="highlight-default"><div class="highlight"><pre><span></span> # use cpu
+ $ python serve.py -C &
+ # use gpu
+ $ python serve.py &
+</pre></div>
+</div>
+</li>
+<li><p class="first">Submit images for classification</p>
+<div class="highlight-default"><div class="highlight"><pre><span></span> $ curl -i -F image=@image1.jpg http://localhost:9999/api
+ $ curl -i -F image=@image2.jpg http://localhost:9999/api
+ $ curl -i -F image=@image3.jpg http://localhost:9999/api
+</pre></div>
+</div>
+</li>
+</ul>
+<p>image1.jpg, image2.jpg and image3.jpg should be downloaded before executing the above commands.</p>
+</div>
+<div class="section" id="details">
+<span id="details"></span><h2>Details<a class="headerlink" href="#details" title="Permalink to this headline">¶</a></h2>
+<p>We first extract the parameter values from <a class="reference external" href="http://download.tensorflow.org/models/inception_v4_2016_09_09.tar.gz">Tensorflow’s checkpoint file</a> into a pickle version.
+After downloading and decompressing the checkpoint file, run the following script</p>
+<div class="highlight-default"><div class="highlight"><pre><span></span>$ python convert.py --file_name=inception_v4.ckpt
+</pre></div>
+</div>
+</div>
+</div>
+
+
+ </div>
+ </div>
+ <footer>
+
+
+ <hr/>
+
+ <div role="contentinfo">
+ <p>
+ © Copyright 2017 The Apache Software Foundation. All rights reserved. Apache SINGA, Apache, the Apache feather logo, and the Apache SINGA project logos are trademarks of The Apache Software Foundation. All other marks mentioned may be trademarks or registered trademarks of their respective owners..
+
+ </p>
+ </div>
+ Built with <a href="http://sphinx-doc.org/">Sphinx</a> using a <a href="https://github.com/snide/sphinx_rtd_theme">theme</a> provided by <a href="https://readthedocs.org">Read the Docs</a>.
+
+</footer>
+
+ </div>
+ </div>
+
+ </section>
+
+ </div>
+
+
+
+
+
+ <script type="text/javascript">
+ var DOCUMENTATION_OPTIONS = {
+ URL_ROOT:'../../../../../',
+ VERSION:'1.1.0',
+ COLLAPSE_INDEX:false,
+ FILE_SUFFIX:'.html',
+ HAS_SOURCE: true
+ };
+ </script>
+ <script type="text/javascript" src="../../../../../_static/jquery.js"></script>
+ <script type="text/javascript" src="../../../../../_static/underscore.js"></script>
+ <script type="text/javascript" src="../../../../../_static/doctools.js"></script>
+
+
+
+
+
+ <script type="text/javascript" src="../../../../../_static/js/theme.js"></script>
+
+
+
+
+ <script type="text/javascript">
+ jQuery(function () {
+ SphinxRtdTheme.StickyNav.enable();
+ });
+ </script>
+
+
+<div class="rst-versions shift-up" 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
+ <span class="fa fa-caret-down"></span>
+ </span>
+ <div class="rst-other-versions">
+ <dl>
+ <dt>Languages</dt>
+ <dd><a href="../../../../../../en/index.html">English</a></dd>
+ <dd><a href="../../../../../../zh/index.html">ä¸æ</a></dd>
+ </dl>
+ <dl>
+ <dt>Versions</dt>
+ <dd><a href="http://singa.apache.org/v0.3.0/">0.3</a></dd>
+ <dd><a href="http://singa.apache.org/v1.1.0/">1.1</a></dd>
+ </dl>
+
+ </div>
+ <a href="http://incubator.apache.org/"> <img src= "../../../../../_static/apache.png" style="background-color:white;"> </a>
+</div>
+
+ <a href="https://github.com/apache/incubator-singa">
+ <img style="position: absolute; top: 0; right: 0; border: 0; z-index: 10000;"
+ src="https://s3.amazonaws.com/github/ribbons/forkme_right_orange_ff7600.png"
+ alt="Fork me on GitHub">
+</a>
+
+
+
+
+</body>
+</html>
\ No newline at end of file
Added: incubator/singa/site/trunk/en/docs/model_zoo/examples/imagenet/vgg/README.html
URL: http://svn.apache.org/viewvc/incubator/singa/site/trunk/en/docs/model_zoo/examples/imagenet/vgg/README.html?rev=1806365&view=auto
==============================================================================
--- incubator/singa/site/trunk/en/docs/model_zoo/examples/imagenet/vgg/README.html (added)
+++ incubator/singa/site/trunk/en/docs/model_zoo/examples/imagenet/vgg/README.html Sun Aug 27 13:42:12 2017
@@ -0,0 +1,298 @@
+
+
+
+<!DOCTYPE html>
+<!--[if IE 8]><html class="no-js lt-ie9" lang="en" > <![endif]-->
+<!--[if gt IE 8]><!--> <html class="no-js" lang="en" > <!--<![endif]-->
+<head>
+ <meta charset="utf-8">
+
+ <meta name="viewport" content="width=device-width, initial-scale=1.0">
+
+ <title>Image Classification using VGG — incubator-singa 1.1.0 documentation</title>
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ <link rel="stylesheet" href="../../../../../_static/css/theme.css" type="text/css" />
+
+
+
+
+
+ <link rel="index" title="Index"
+ href="../../../../../genindex.html"/>
+ <link rel="search" title="Search" href="../../../../../search.html"/>
+ <link rel="top" title="incubator-singa 1.1.0 documentation" href="../../../../../index.html"/>
+ <link href="../../../../../_static/style.css" rel="stylesheet" type="text/css">
+
+
+
+ <script src="../../../../../_static/js/modernizr.min.js"></script>
+
+</head>
+
+<body class="wy-body-for-nav" role="document">
+
+ <div class="wy-grid-for-nav">
+
+
+ <nav data-toggle="wy-nav-shift" class="wy-nav-side">
+ <div class="wy-side-scroll">
+ <div class="wy-side-nav-search">
+
+
+
+ <a href="../../../../../index.html" class="icon icon-home"> incubator-singa
+
+
+
+
+ <img src="../../../../../_static/singa.png" class="logo" />
+
+ </a>
+
+
+
+
+ <div class="version">
+ latest
+ </div>
+
+
+
+
+<div role="search">
+ <form id="rtd-search-form" class="wy-form" action="../../../../../search.html" method="get">
+ <input type="text" name="q" placeholder="Search docs" />
+ <input type="hidden" name="check_keywords" value="yes" />
+ <input type="hidden" name="area" value="default" />
+ </form>
+</div>
+
+
+ </div>
+
+ <div class="wy-menu wy-menu-vertical" data-spy="affix" role="navigation" aria-label="main navigation">
+
+
+
+ <ul>
+<li class="toctree-l1"><a class="reference internal" href="../../../../../downloads.html">Download SINGA</a></li>
+<li class="toctree-l1"><a class="reference internal" href="../../../../index.html">Documentation</a></li>
+</ul>
+<p class="caption"><span class="caption-text">Development</span></p>
+<ul>
+<li class="toctree-l1"><a class="reference internal" href="../../../../../develop/schedule.html">Development Schedule</a></li>
+<li class="toctree-l1"><a class="reference internal" href="../../../../../develop/how-contribute.html">How to Contribute to SINGA</a></li>
+<li class="toctree-l1"><a class="reference internal" href="../../../../../develop/contribute-code.html">How to Contribute Code</a></li>
+<li class="toctree-l1"><a class="reference internal" href="../../../../../develop/contribute-docs.html">How to Contribute to Documentation</a></li>
+</ul>
+<p class="caption"><span class="caption-text">Community</span></p>
+<ul>
+<li class="toctree-l1"><a class="reference internal" href="../../../../../community/source-repository.html">Source Repository</a></li>
+<li class="toctree-l1"><a class="reference internal" href="../../../../../community/mail-lists.html">Project Mailing Lists</a></li>
+<li class="toctree-l1"><a class="reference internal" href="../../../../../community/issue-tracking.html">Issue Tracking</a></li>
+<li class="toctree-l1"><a class="reference internal" href="../../../../../community/team-list.html">The SINGA Team</a></li>
+</ul>
+
+
+
+ </div>
+ </div>
+ </nav>
+
+ <section data-toggle="wy-nav-shift" class="wy-nav-content-wrap">
+
+
+ <nav class="wy-nav-top" role="navigation" aria-label="top navigation">
+ <i data-toggle="wy-nav-top" class="fa fa-bars"></i>
+ <a href="../../../../../index.html">incubator-singa</a>
+ </nav>
+
+
+
+ <div class="wy-nav-content">
+ <div class="rst-content">
+
+
+
+
+
+
+<div role="navigation" aria-label="breadcrumbs navigation">
+ <ul class="wy-breadcrumbs">
+ <li><a href="../../../../../index.html">Docs</a> »</li>
+
+ <li>Image Classification using VGG</li>
+ <li class="wy-breadcrumbs-aside">
+
+
+
+ </li>
+ </ul>
+ <hr/>
+</div>
+ <div role="main" class="document" itemscope="itemscope" itemtype="http://schema.org/Article">
+ <div itemprop="articleBody">
+
+ <hr class="docutils" />
+<p>name: VGG models on ImageNet
+SINGA version: 1.1.1
+SINGA commit:
+license: https://github.com/pytorch/vision/blob/master/torchvision/models/vgg.py</p>
+<hr class="docutils" />
+<div class="section" id="image-classification-using-vgg">
+<span id="image-classification-using-vgg"></span><h1>Image Classification using VGG<a class="headerlink" href="#image-classification-using-vgg" title="Permalink to this headline">¶</a></h1>
+<p>In this example, we convert VGG on <a class="reference external" href="https://github.com/pytorch/vision/blob/master/torchvision/models/vgg.py">PyTorch</a>
+to SINGA for image classification.</p>
+<div class="section" id="instructions">
+<span id="instructions"></span><h2>Instructions<a class="headerlink" href="#instructions" title="Permalink to this headline">¶</a></h2>
+<ul>
+<li><p class="first">Download one parameter checkpoint file (see below) and the synset word file of ImageNet into this folder, e.g.,</p>
+<div class="highlight-default"><div class="highlight"><pre><span></span> $ wget https://s3-ap-southeast-1.amazonaws.com/dlfile/vgg/vgg11.tar.gz
+ $ wget https://s3-ap-southeast-1.amazonaws.com/dlfile/resnet/synset_words.txt
+ $ tar xvf vgg11.tar.gz
+</pre></div>
+</div>
+</li>
+<li><p class="first">Usage</p>
+<div class="highlight-default"><div class="highlight"><pre><span></span> $ python serve.py -h
+</pre></div>
+</div>
+</li>
+<li><p class="first">Example</p>
+<div class="highlight-default"><div class="highlight"><pre><span></span> # use cpu
+ $ python serve.py --use_cpu --parameter_file vgg11.pickle --depth 11 --use_cpu &
+ # use gpu
+ $ python serve.py --use_cpu --parameter_file vgg11.pickle --depth 11 &
+</pre></div>
+</div>
+<p>The parameter files for the following model and depth configuration pairs are provided:</p>
+<ul class="simple">
+<li>Without batch-normalization, <a class="reference external" href="https://s3-ap-southeast-1.amazonaws.com/dlfile/vgg/vgg11.tar.gz">11</a>, <a class="reference external" href="https://s3-ap-southeast-1.amazonaws.com/dlfile/vgg/vgg13.tar.gz">13</a>, <a class="reference external" href="https://s3-ap-southeast-1.amazonaws.com/dlfile/vgg/vgg16.tar.gz">16</a>, <a class="reference external" href="https://s3-ap-southeast-1.amazonaws.com/dlfile/vgg/vgg19.tar.gz">19</a></li>
+<li>With batch-normalization, <a class="reference external" href="https://s3-ap-southeast-1.amazonaws.com/dlfile/vgg/vgg11_bn.tar.gz">11</a>, <a class="reference external" href="https://s3-ap-southeast-1.amazonaws.com/dlfile/vgg/vgg13_bn.tar.gz">13</a>, <a class="reference external" href="https://s3-ap-southeast-1.amazonaws.com/dlfile/vgg/vgg16_bn.tar.gz">16</a>, <a class="reference external" href="https://s3-ap-southeast-1.amazonaws.com/dlfile/vgg/vgg19_bn.tar.gz">19</a></li>
+</ul>
+</li>
+<li><p class="first">Submit images for classification</p>
+<div class="highlight-default"><div class="highlight"><pre><span></span> $ curl -i -F image=@image1.jpg http://localhost:9999/api
+ $ curl -i -F image=@image2.jpg http://localhost:9999/api
+ $ curl -i -F image=@image3.jpg http://localhost:9999/api
+</pre></div>
+</div>
+</li>
+</ul>
+<p>image1.jpg, image2.jpg and image3.jpg should be downloaded before executing the above commands.</p>
+</div>
+<div class="section" id="details">
+<span id="details"></span><h2>Details<a class="headerlink" href="#details" title="Permalink to this headline">¶</a></h2>
+<p>The parameter files were converted from the pytorch via the convert.py program.</p>
+<p>Usage:</p>
+<div class="highlight-default"><div class="highlight"><pre><span></span>$ python convert.py -h
+</pre></div>
+</div>
+</div>
+</div>
+
+
+ </div>
+ </div>
+ <footer>
+
+
+ <hr/>
+
+ <div role="contentinfo">
+ <p>
+ © Copyright 2017 The Apache Software Foundation. All rights reserved. Apache SINGA, Apache, the Apache feather logo, and the Apache SINGA project logos are trademarks of The Apache Software Foundation. All other marks mentioned may be trademarks or registered trademarks of their respective owners..
+
+ </p>
+ </div>
+ Built with <a href="http://sphinx-doc.org/">Sphinx</a> using a <a href="https://github.com/snide/sphinx_rtd_theme">theme</a> provided by <a href="https://readthedocs.org">Read the Docs</a>.
+
+</footer>
+
+ </div>
+ </div>
+
+ </section>
+
+ </div>
+
+
+
+
+
+ <script type="text/javascript">
+ var DOCUMENTATION_OPTIONS = {
+ URL_ROOT:'../../../../../',
+ VERSION:'1.1.0',
+ COLLAPSE_INDEX:false,
+ FILE_SUFFIX:'.html',
+ HAS_SOURCE: true
+ };
+ </script>
+ <script type="text/javascript" src="../../../../../_static/jquery.js"></script>
+ <script type="text/javascript" src="../../../../../_static/underscore.js"></script>
+ <script type="text/javascript" src="../../../../../_static/doctools.js"></script>
+
+
+
+
+
+ <script type="text/javascript" src="../../../../../_static/js/theme.js"></script>
+
+
+
+
+ <script type="text/javascript">
+ jQuery(function () {
+ SphinxRtdTheme.StickyNav.enable();
+ });
+ </script>
+
+
+<div class="rst-versions shift-up" 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
+ <span class="fa fa-caret-down"></span>
+ </span>
+ <div class="rst-other-versions">
+ <dl>
+ <dt>Languages</dt>
+ <dd><a href="../../../../../../en/index.html">English</a></dd>
+ <dd><a href="../../../../../../zh/index.html">ä¸æ</a></dd>
+ </dl>
+ <dl>
+ <dt>Versions</dt>
+ <dd><a href="http://singa.apache.org/v0.3.0/">0.3</a></dd>
+ <dd><a href="http://singa.apache.org/v1.1.0/">1.1</a></dd>
+ </dl>
+
+ </div>
+ <a href="http://incubator.apache.org/"> <img src= "../../../../../_static/apache.png" style="background-color:white;"> </a>
+</div>
+
+ <a href="https://github.com/apache/incubator-singa">
+ <img style="position: absolute; top: 0; right: 0; border: 0; z-index: 10000;"
+ src="https://s3.amazonaws.com/github/ribbons/forkme_right_orange_ff7600.png"
+ alt="Fork me on GitHub">
+</a>
+
+
+
+
+</body>
+</html>
\ No newline at end of file
Modified: incubator/singa/site/trunk/en/objects.inv
URL: http://svn.apache.org/viewvc/incubator/singa/site/trunk/en/objects.inv?rev=1806365&r1=1806364&r2=1806365&view=diff
==============================================================================
Binary files - no diff available.