Added: incubator/singa/site/trunk/zh/docs/installation.html URL: http://svn.apache.org/viewvc/incubator/singa/site/trunk/zh/docs/installation.html?rev=1833193&view=auto ============================================================================== --- incubator/singa/site/trunk/zh/docs/installation.html (added) +++ incubator/singa/site/trunk/zh/docs/installation.html Fri Jun 8 15:29:00 2018 @@ -0,0 +1,636 @@ + + + +<!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>å®è£ — incubator-singa 1.1.0 documentation</title> + + + + + + + + + + + + + + + + + <link rel="stylesheet" href="../_static/css/theme.css" type="text/css" /> + <link rel="stylesheet" href="../_static/pygments.css" type="text/css" /> + <link rel="index" title="Index" href="../genindex.html" /> + <link rel="search" title="Search" href="../search.html" /> + <link rel="next" title="软件æ¶æ" href="software_stack.html" /> + <link rel="prev" title="ææ¡£" href="index.html" /> + <link href="../_static/style.css" rel="stylesheet" type="text/css"> + <!--link href="../_static/fontawesome-all.min.css" rel="stylesheet" type="text/css"--> + <link rel="stylesheet" href="https://use.fontawesome.com/releases/v5.0.13/css/all.css"; integrity="sha384-DNOHZ68U8hZfKXOrtjWvjxusGo9WQnrNx2sqG0tfsghAvtVlRW3tvkXWZh58N9jp" crossorigin="anonymous"> + <style> + .fa:hover { + opacity: 0.7; + } + .fab:hover { + opacity: 0.7; + } + </style> + + + + <script src="../_static/js/modernizr.min.js"></script> + +</head> + +<body class="wy-body-for-nav"> + + + <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" alt="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 class="current"> +<li class="toctree-l1"><a class="reference internal" href="../downloads.html">ä¸è½½ SINGA</a></li> +<li class="toctree-l1 current"><a class="reference internal" href="index.html">ææ¡£</a><ul class="current"> +<li class="toctree-l2 current"><a class="current reference internal" href="#">å®è£ </a><ul> +<li class="toctree-l3"><a class="reference internal" href="#conda">ä»Condaå®è£ </a></li> +<li class="toctree-l3"><a class="reference internal" href="#">ä»æºç å®è£ </a><ul> +<li class="toctree-l4"><a class="reference internal" href="#condasinga">ç±condaå建SINGA</a></li> +<li class="toctree-l4"><a class="reference internal" href="#ubuntusinga">使ç¨æ¬å°å·¥å ·å¨Ubuntuä¸å建SINGA</a></li> +<li class="toctree-l4"><a class="reference internal" href="#windowssinga">å¨Windowsä¸ç¼è¯SINGA</a></li> +<li class="toctree-l4"><a class="reference internal" href="#">æ´å¤ç¼è¯éæ©</a></li> +</ul> +</li> +<li class="toctree-l3"><a class="reference internal" href="#faq">FAQ</a></li> +</ul> +</li> +<li class="toctree-l2"><a class="reference internal" href="software_stack.html">软件æ¶æ</a></li> +<li class="toctree-l2"><a class="reference internal" href="device.html">设å¤(Device)</a></li> +<li class="toctree-l2"><a class="reference internal" href="tensor.html">å¼ é(Tensor)</a></li> +<li class="toctree-l2"><a class="reference internal" href="layer.html">å±(Layer)</a></li> +<li class="toctree-l2"><a class="reference internal" href="net.html">åé¦ç½ç»</a></li> +<li class="toctree-l2"><a class="reference internal" href="initializer.html">åå§åå¨(Initializer)</a></li> +<li class="toctree-l2"><a class="reference internal" href="loss.html">æ失(Loss)</a></li> +<li class="toctree-l2"><a class="reference internal" href="metric.html">度é(Metric)</a></li> +<li class="toctree-l2"><a class="reference internal" href="optimizer.html">ä¼åå¨(Optimizer)</a></li> +<li class="toctree-l2"><a class="reference internal" href="data.html">æ°æ®(Data)</a></li> +<li class="toctree-l2"><a class="reference internal" href="image_tool.html">å¾åå·¥å ·</a></li> +<li class="toctree-l2"><a class="reference internal" href="snapshot.html">Snapshot</a></li> +<li class="toctree-l2"><a class="reference internal" href="utils.html">Utils</a></li> +<li class="toctree-l2"><a class="reference internal" href="model_zoo/index.html">模ååº</a></li> +</ul> +</li> +</ul> +<p class="caption"><span class="caption-text">å¼å</span></p> +<ul> +<li class="toctree-l1"><a class="reference internal" href="../develop/schedule.html">å¼åæ¶é´è¡¨</a></li> +<li class="toctree-l1"><a class="reference internal" href="../develop/how-contribute.html">å¦ä½è´¡ç®ç» SINGA</a></li> +<li class="toctree-l1"><a class="reference internal" href="../develop/contribute-code.html">å¦ä½è´¡ç®ä»£ç </a></li> +</ul> +<p class="caption"><span class="caption-text">社åº</span></p> +<ul> +<li class="toctree-l1"><a class="reference internal" href="../community/source-repository.html">æºä»£ç åº</a></li> +<li class="toctree-l1"><a class="reference internal" href="../community/mail-lists.html">项ç®é®ä»¶å表</a></li> +<li class="toctree-l1"><a class="reference internal" href="../community/issue-tracking.html">é®é¢è¿½è¸ª</a></li> +<li class="toctree-l1"><a class="reference internal" href="../community/team-list.html">SINGAå¢é</a></li> +</ul> + + + + </div> + </div> + </nav> + + <section data-toggle="wy-nav-shift" class="wy-nav-content-wrap"> + + + <nav class="wy-nav-top" 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><a href="index.html">ææ¡£</a> »</li> + + <li>å®è£ </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"> + + <div class="section" id=""> +<span id="id1"></span><h1>å®è£ <a class="headerlink" href="#" title="Permalink to this headline">¶</a></h1> +<div class="section" id="conda"> +<span id="conda"></span><h2>ä»Condaå®è£ <a class="headerlink" href="#conda" title="Permalink to this headline">¶</a></h2> +<p>Condaæ¯Pythonï¼CPPåå ¶ä»è½¯ä»¶å ç软件å 管çåã</p> +<p>ç®åï¼SINGAæéç¨äºLinuxåMacOSXçconda软件å ï¼Python 2.7åPython 3.6ï¼ã +建议使ç¨<a class="reference external" href="https://conda.io/miniconda.html";>Miniconda3</a>ä¸SINGAä¸èµ·ä½¿ç¨ãå®è£ å®minicondaåï¼æ§è¡ä»¥ä¸å½ä»¤ä¹ä¸æ¥å®è£ SINGAã</p> +<ol> +<li><p class="first">CPUçæ¬</p> +<div class="highlight-default notranslate"><div class="highlight"><pre><span></span> <span class="n">conda</span> <span class="n">install</span> <span class="o">-</span><span class="n">c</span> <span class="n">nusdbsystem</span> <span class="n">singa</span><span class="o">-</span><span class="n">cpu</span> +</pre></div> +</div> +</li> +<li><p class="first">ç±CUDAåcuDNNæ¯æçGPUçæ¬</p> +<div class="highlight-default notranslate"><div class="highlight"><pre><span></span> <span class="n">conda</span> <span class="n">install</span> <span class="o">-</span><span class="n">c</span> <span class="n">nusdbsystem</span> <span class="n">singa</span><span class="o">-</span><span class="n">gpu</span> +</pre></div> +</div> +</li> +</ol> +<p>çåäº</p> +<div class="highlight-default notranslate"><div class="highlight"><pre><span></span> <span class="n">conda</span> <span class="n">install</span> <span class="o">-</span><span class="n">c</span> <span class="n">nusdbsystem</span> <span class="n">singa</span><span class="o">=</span><span class="mf">1.1</span><span class="o">.</span><span class="mi">1</span><span class="o">=</span><span class="n">py36_cuda9</span><span class="o">.</span><span class="mi">0</span><span class="o">-</span><span class="n">cudnn7</span><span class="o">.</span><span class="mf">1.2</span> +</pre></div> +</div> +<p>å¨æ§è¡ä¸è¿°å½ä»¤ä¹åï¼å¿ é¡»å å®è£ CUDA 9.0ã å ¶ä»CUDAçæ¬çSinga软件å ä¹å¯ç¨ã 以ä¸è¯´æååºäºææå¯ç¨çSinga软件å ã</p> +<div class="highlight-default notranslate"><div class="highlight"><pre><span></span> <span class="n">conda</span> <span class="n">search</span> <span class="o">-</span><span class="n">c</span> <span class="n">nusdbsystem</span> <span class="n">singa</span> +</pre></div> +</div> +<p>å¦æä¸é¢æ令没æåºç°é误æ示ï¼è¯´æSINGAå·²ç»å®è£ æåã</p> +<div class="highlight-default notranslate"><div class="highlight"><pre><span></span> <span class="n">python</span> <span class="o">-</span><span class="n">c</span> <span class="s2">"from singa import tensor"</span> +</pre></div> +</div> +</div> +<div class="section" id=""> +<span id="id2"></span><h2>ä»æºç å®è£ <a class="headerlink" href="#" title="Permalink to this headline">¶</a></h2> +<p>æºæ件å¯ä»¥è¢«ä¸è½½ä¸º<a class="reference external" href="https://dist.apache.org/repos/dist/dev/incubator/singa/";>tar.gz æ件</a>ï¼æè 为ä¸ä¸ªgitä»åºï¼</p> +<div class="highlight-default notranslate"><div class="highlight"><pre><span></span> $ git clone https://github.com/apache/incubator-singa.git + $ cd incubator-singa/ +</pre></div> +</div> +<div class="section" id="condasinga"> +<span id="condasinga"></span><h3>ç±condaå建SINGA<a class="headerlink" href="#condasinga" title="Permalink to this headline">¶</a></h3> +<p>Conda-buildæ¯ä¸æ¬¾æå»ºå·¥å ·ï¼å¯ä»¥å®è£ anacondaäºä¸çç¸å ³åºå¹¶æ§è¡æ建èæ¬ã çæç软件å å¯ä»¥ä¸ä¼ å°anacondaäºä¸ä¾ä»äººä¸è½½åå®è£ ã</p> +<p>å®è£ conda-build (å®è£ minicondaå)</p> +<div class="highlight-default notranslate"><div class="highlight"><pre><span></span> <span class="n">conda</span> <span class="n">install</span> <span class="n">conda</span><span class="o">-</span><span class="n">build</span> +</pre></div> +</div> +<p>å建CPUçæ¬çSINGA</p> +<div class="highlight-default notranslate"><div class="highlight"><pre><span></span> <span class="n">export</span> <span class="n">BUILD_STR</span><span class="o">=</span><span class="n">cpu</span> + <span class="n">conda</span> <span class="n">build</span> <span class="n">tool</span><span class="o">/</span><span class="n">conda</span><span class="o">/</span><span class="n">singa</span><span class="o">/</span> <span class="o">--</span><span class="n">python3</span><span class="o">.</span><span class="mi">6</span> <span class="p">(</span><span class="ow">or</span> <span class="o">--</span><span class="n">python2</span><span class="o">.</span><span class="mi">7</span><span class="p">)</span> +</pre></div> +</div> +<p>ä¸é¢çæ令已å¨Ubuntu 16.04åMac OSXä¸æµè¯è¿ãæ´å¤ä¿¡æ¯è¯·åè<a class="reference external" href="https://travis-ci.org/apache/incubator-singa";>Travis-CI页é¢</a>ã</p> +<p>å建GPUçæ¬çSINGA</p> +<div class="highlight-default notranslate"><div class="highlight"><pre><span></span> <span class="n">export</span> <span class="n">BUILD_STR</span><span class="o">=</span><span class="n">cudax</span><span class="o">.</span><span class="n">y</span><span class="o">-</span><span class="n">cudnna</span><span class="o">.</span><span class="n">b</span><span class="o">.</span><span class="n">c</span> <span class="p">(</span><span class="n">e</span><span class="o">.</span><span class="n">g</span><span class="o">.</span> <span class="n">cuda9</span><span class="o">.</span><span class="mi">0</span><span class="o">-</span><span class="n">cudnn7</span><span class="o">.</span><span class="mf">1.2</span><span class="p">)</span> + <span class="n">export</span> <span class="n">CUDNN_PATH</span><span class="o">=<</span><span class="n">path</span> <span class="n">to</span> <span class="n">cudnn</span> <span class="n">folder</span><span class="o">></span> + <span class="n">conda</span> <span class="n">build</span> <span class="n">tool</span><span class="o">/</span><span class="n">conda</span><span class="o">/</span><span class="n">singa</span><span class="o">/</span> <span class="o">--</span><span class="n">python3</span><span class="o">.</span><span class="mi">6</span> <span class="p">(</span><span class="ow">or</span> <span class="o">--</span><span class="n">python2</span><span class="o">.</span><span class="mi">7</span><span class="p">)</span> +</pre></div> +</div> +<p>è¿äºåºäºGPUå¹³å°çæ令已ç»å¨Ubuntu 16.04 (cuDNN >= 7åCUDA >= 9)ä¸æµè¯è¿ã +<a class="reference external" href="https://hub.docker.com/r/nvidia/cuda/";>Nvidiaçdockeréå</a>æä¾äºcuDNNåCUDAçå建ç¯å¢ã</p> +<p>å±å¹ä¸å°æ¾ç¤ºçæçå æ件çä½ç½®ã +请åé <a class="reference external" href="https://conda.io/docs/commands/conda-install.html";>condaå®è£ </a> +对ä»æ¬å°æ件å®è£ 软件å ç说æã</p> +</div> +<div class="section" id="ubuntusinga"> +<span id="ubuntusinga"></span><h3>使ç¨æ¬å°å·¥å ·å¨Ubuntuä¸å建SINGA<a class="headerlink" href="#ubuntusinga" title="Permalink to this headline">¶</a></h3> +<p>ç¼è¯åè¿è¡SINGAéè¦ä»¥ä¸åºã +æå ³å¨Ubuntu 16.04ä¸å®è£ å®ä»¬ç说æï¼ +请åé SINGA <a class="reference external" href="https://github.com/apache/incubator-singa/blob/master/tool/docker/";>Dockerfiles</a>ã</p> +<ul class="simple"> +<li>cmake (>=2.8)</li> +<li>gcc (>=4.8.1) or Clang</li> +<li>google protobuf (>=2.5)</li> +<li>blas (tested with openblas >=0.2.10)</li> +<li>swig(>=3.0.10) for compiling PySINGA</li> +<li>numpy(>=1.11.0) for compiling PySINGA</li> +</ul> +<ol class="simple"> +<li>å¨incubator-singaç®å½ä¸å建ä¸ä¸ª<code class="docutils literal notranslate"><span class="pre">build</span></code>æ件夹并è¿å ¥å ¶ä¸</li> +<li>è¿è¡ <code class="docutils literal notranslate"><span class="pre">cmake</span> <span class="pre">[options]</span> <span class="pre">..</span></code> +é»è®¤æ åµä¸é¤äº<code class="docutils literal notranslate"><span class="pre">USE_PYTHON</span></code>ï¼å ¶ä»ææå¯é项é½æ¯OFF<ul> +<li><code class="docutils literal notranslate"><span class="pre">USE_MODULES=ON</span></code>, å½protobufåblas没æ被å®è£ æ¶ä½¿ç¨</li> +<li><code class="docutils literal notranslate"><span class="pre">USE_CUDA=ON</span></code>, å½CUDAåcuDNNå¯ç¨æ¶ä½¿ç¨</li> +<li><code class="docutils literal notranslate"><span class="pre">USE_PYTHON=ON</span></code>, ç¨äºç¼è¯PySINGA</li> +<li><code class="docutils literal notranslate"><span class="pre">USE_PYTHON3=ON</span></code>, ç¨äºæ¯æPython 3ç¼è¯ (é»è®¤çæ¯Python 2)</li> +<li><code class="docutils literal notranslate"><span class="pre">USE_OPENCL=ON</span></code>, ç¨äºæ¯æOpenCLç¼è¯</li> +<li><code class="docutils literal notranslate"><span class="pre">PACKAGE=ON</span></code>, ç¨äºå建Debianå </li> +<li><code class="docutils literal notranslate"><span class="pre">ENABLE_TEST</span></code>ï¼ç¨äºç¼è¯åå æµè¯ç¨ä¾</li> +</ul> +</li> +<li>ç¼è¯ä»£ç ï¼ å¦ï¼ <code class="docutils literal notranslate"><span class="pre">make</span></code></li> +<li>è¿å ¥pythonæ件夹</li> +<li>è¿è¡ <code class="docutils literal notranslate"><span class="pre">pip</span> <span class="pre">install</span> <span class="pre">.</span></code>æè <code class="docutils literal notranslate"><span class="pre">pip</span> <span class="pre">install</span> <span class="pre">-e</span> <span class="pre">.</span></code>ã第äºä¸ªæ令å建符å·é¾æ¥èä¸æ¯å°æ件å¤å¶å°pythonç«ç¹å æ件夹ä¸ã</li> +</ol> +<p>å½USE_PYTHON=ONæ¶ï¼ç¬¬4æ¥å第5æ¥ç¨äºå®è£ PySINGAã</p> +<p>å¨éè¿ENABLE_TEST=ONç¼è¯å¥½SINGAåï¼ä½ å¯ä»¥è¿è¡åå æµè¯</p> +<div class="highlight-default notranslate"><div class="highlight"><pre><span></span> $ ./bin/test_singa +</pre></div> +</div> +<p>ä½ å¯ä»¥çå°æææµè¯ç¨ä¾åæµè¯ç»æã +å¦æSINGAéè¿æææµè¯ï¼é£ä¹ä½ å·²ç»æåå®è£ äºSINGAã</p> +</div> +<div class="section" id="windowssinga"> +<span id="windowssinga"></span><h3>å¨Windowsä¸ç¼è¯SINGA<a class="headerlink" href="#windowssinga" title="Permalink to this headline">¶</a></h3> +<p>åºäºPythonæ¯æçWindowsä¸çå®è£ 说æå¯ä»¥å¨<a class="reference external" href="install_win.html">è¿é</a>æ¾å°ã</p> +</div> +<div class="section" id=""> +<span id="id3"></span><h3>æ´å¤ç¼è¯éæ©<a class="headerlink" href="#" title="Permalink to this headline">¶</a></h3> +<div class="section" id="use-modules"> +<span id="use-modules"></span><h4>USE_MODULES<a class="headerlink" href="#use-modules" title="Permalink to this headline">¶</a></h4> +<p>å¦æprotobufåopenblas没æå®è£ ï¼å¨ç¼è¯SINGAæ¶éè¦å¦ä¸å¤çï¼</p> +<div class="highlight-default notranslate"><div class="highlight"><pre><span></span> $ In SINGA ROOT folder + $ mkdir build + $ cd build + $ cmake -DUSE_MODULES=ON .. + $ make +</pre></div> +</div> +<p>cmakeä¼ä¸è½½OpenBlasåProtobufï¼2.6.1ï¼å¹¶åSINGAä¸èµ·ç¼è¯ã</p> +<p>ä½ å¯ä»¥ä½¿ç¨<code class="docutils literal notranslate"><span class="pre">cmake</span> <span class="pre">..</span></code>æ¥é ç½®ç¼è¯æä½æ令ã å¦æä¸äºä¾èµåºæ²¡æ被å®è£ å¨é»è®¤è·¯å¾ä¸ï¼ä½ éè¦å¯¼åºç¸åºçç¯å¢åéï¼</p> +<div class="highlight-default notranslate"><div class="highlight"><pre><span></span> <span class="n">export</span> <span class="n">CMAKE_INCLUDE_PATH</span><span class="o">=<</span><span class="n">path</span> <span class="n">to</span> <span class="n">the</span> <span class="n">header</span> <span class="n">file</span> <span class="n">folder</span><span class="o">></span> + <span class="n">export</span> <span class="n">CMAKE_LIBRARY_PATH</span><span class="o">=<</span><span class="n">path</span> <span class="n">to</span> <span class="n">the</span> <span class="n">lib</span> <span class="n">file</span> <span class="n">folder</span><span class="o">></span> +</pre></div> +</div> +</div> +<div class="section" id="use-python"> +<span id="use-python"></span><h4>USE_PYTHON<a class="headerlink" href="#use-python" title="Permalink to this headline">¶</a></h4> +<p>类似äºç¼è¯CPP代ç ï¼ PySINGAå¯ä»¥è¢«è¿ä¹ç¼è¯ï¼</p> +<div class="highlight-default notranslate"><div class="highlight"><pre><span></span> $ cmake -DUSE_PYTHON=ON .. + $ make + $ cd python + $ pip install . +</pre></div> +</div> +</div> +<div class="section" id="use-cuda"> +<span id="use-cuda"></span><h4>USE_CUDA<a class="headerlink" href="#use-cuda" title="Permalink to this headline">¶</a></h4> +<p>ç¨æ·è¢«æ¨èå®è£ CUDAå<a class="reference external" href="https://developer.nvidia.com/cudnn";>cuDNN</a>以å¨GPUä¸è¿è¡SINGAæ¶è·å¾æ´å¥½çæ§è½ã</p> +<p>SINGAå·²ç»å¨CUDA 9åcuDNN 7ä¸æµè¯è¿ã å¦æcuDNNå¨éç³»ç»ç®å½ä¸è§£åï¼å¦/home/bob/local/cudnn/, ä¸é¢çæ令éè¦è¢«æ§è¡ä»¥è®©cmakeåè¿è¡æ¶è½æ¾å°å®ï¼</p> +<div class="highlight-default notranslate"><div class="highlight"><pre><span></span> $ export CMAKE_INCLUDE_PATH=/home/bob/local/cudnn/include:$CMAKE_INCLUDE_PATH + $ export CMAKE_LIBRARY_PATH=/home/bob/local/cudnn/lib64:$CMAKE_LIBRARY_PATH + $ export LD_LIBRARY_PATH=/home/bob/local/cudnn/lib64:$LD_LIBRARY_PATH +</pre></div> +</div> +<p>cmake对CUDAåcuDNNçæä½é项åºè¯¥è¢«å¼å¯ï¼</p> +<div class="highlight-default notranslate"><div class="highlight"><pre><span></span> # ä¾èµåºå·²ç»è¢«å®è£ + $ cmake -DUSE_CUDA=ON .. + $ make +</pre></div> +</div> +</div> +<div class="section" id="use-opencl"> +<span id="use-opencl"></span><h4>USE_OPENCL<a class="headerlink" href="#use-opencl" title="Permalink to this headline">¶</a></h4> +<p>SINGAç¨opencl-headeråviennaclï¼1.7.1çæ¬ææ´æ°ï¼ä»¥è·å¾OpenCLæ¯æã å®ä»¬å¯ç±ä»¥ä¸æ令å®è£ ï¼</p> +<div class="highlight-default notranslate"><div class="highlight"><pre><span></span> # å¨Ubuntu 16.04ä¸ + $ sudo apt-get install opencl-headers, libviennacl-dev + # å¨Fedoraä¸ + $ sudo yum install opencl-headers, viennacl +</pre></div> +</div> +<p>å¦å¤ï¼ä½ å°éè¦OpenCL Installable Client Driver (ICD)以å¨ä½ çå¹³å°ä¸è¿è¡OpenCLã</p> +<ul class="simple"> +<li>对äºAMDåNvidia GPU, 驱å¨å è¿éè¦å å«æ£ç¡®çOpenCL ICDã</li> +<li>对äºè±ç¹å°CPUså/æGPUs, å¯ä»¥ä»<a class="reference external" href="https://software.intel.com/en-us/articles/opencl-drivers";>è±ç¹å°å®ç½</a>ä¸è·åå°ã 注æï¼ å®ç½ä¸æä¾ç驱å¨ä» æ¯æè¿æçCPUsåGPUsã</li> +<li>对äºæ´èçè±ç¹å°CPUsï¼ä½ å¯ä»¥éç¨<code class="docutils literal notranslate"><span class="pre">beignet-opencl-icd</span></code>å ã</li> +</ul> +<p>注æï¼å¨CPUä¸è¿è¡OpenCLç®åæ¯ä¸æ¨èçï¼å 为å¾æ ¢ã å åä¼ è¾æ¯ä»¥ç§ç级å«ï¼CPUä¸ä¸º1000 msï¼èGPUä¸ä¸º1毫ç§ï¼ã</p> +<p>æ´å¤å ³äºOpenCLç¯å¢é ç½®çä¿¡æ¯å¯ä»¥ä»<a class="reference external" href="https://wiki.tiker.net/OpenCLHowTo";>è¿é</a>è·å¾ã</p> +<p>å¦æViennaCLå çæ¬ä½äº1.7.1ï¼ä½ å°éè¦ä»æºç ç¼è¯ï¼</p> +<p>ä»<a class="reference external" href="https://github.com/viennacl/viennacl-dev";>gitä»åº</a>cloneï¼checkoutå°<code class="docutils literal notranslate"><span class="pre">release-1.7.1</span></code>æ ç¾ãè®°å¾æä»åºçè·¯å¾å å°ç¯å¢åé<code class="docutils literal notranslate"><span class="pre">PATH</span></code>ä¸ï¼å¹¶ä¸å建åºå°<code class="docutils literal notranslate"><span class="pre">LD_LIBRARY_PATH</span></code>ã</p> +<p>ç¼è¯åºäºOpenCLæ¯æçSINGA (æµè¯ä¸SINGA 1.1)ï¼</p> +<div class="highlight-default notranslate"><div class="highlight"><pre><span></span> $ cmake -DUSE_OPENCL=ON .. + $ make +</pre></div> +</div> +</div> +<div class="section" id="package"> +<span id="package"></span><h4>PACKAGE<a class="headerlink" href="#package" title="Permalink to this headline">¶</a></h4> +<p>æ¤è®¾ç½®ç¨äºå建Debianå ã 设置PACKAGE=ON并ç¨ä»¥ä¸å½ä»¤å建å ï¼</p> +<div class="highlight-default notranslate"><div class="highlight"><pre><span></span> $ cmake -DPACKAGE=ON + $ make package +</pre></div> +</div> +</div> +</div> +</div> +<div class="section" id="faq"> +<span id="faq"></span><h2>FAQ<a class="headerlink" href="#faq" title="Permalink to this headline">¶</a></h2> +<ul> +<li><p class="first">Q: å¨ä½¿ç¨ç±wheelå®è£ çPySINGA(âimport singaâ)æ¶ï¼åºç°é误ã</p> +<p>A: 请æ¥ç<code class="docutils literal notranslate"><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>详ç»é误æ示ã è¿ææ¶æ¯ç±ä¾èµåºé æçï¼æ¯å¦ï¼æå¤ä¸ªçæ¬çprotobufï¼cudnn缺失ï¼numpyçæ¬ä¸å¹é ã ä¸é¢çæ¥éª¤è¯¦è¿°äºä¸åçæ¡ä¾ï¼</p> +<ol> +<li><p class="first">æ£æ¥cudnnï¼cudaågccçæ¬ï¼æ¨è使ç¨cudnn5ï¼cuda7.5ågcc4.8/4.9ã å¦ægccæ¯5.0çæ¬ï¼ éè¦éä½çæ¬ã å¦æcudnnç¡®å®æè ä¸wheelçæ¬ä¸å¹é ï¼ä½ å¯ä»¥å°æ£ç¡®çcudnnçæ¬ä¸è½½å°~/local/cudnn/ 并ä¸</p> +<div class="highlight-default notranslate"><div class="highlight"><pre><span></span> $ echo "export LD_LIBRARY_PATH=/home/<yourname>/local/cudnn/lib64:$LD_LIBRARY_PATH" >> ~/.bashrc +</pre></div> +</div> +</li> +<li><p class="first">å¦ææ¯protobufçé®é¢ï¼éè¦ä¸è½½ææ°ç<a class="reference external" href="https://issues.apache.org/jira/browse/SINGA-255";>ç¼è¯è¿protobufåopenblasçwhlæ件</a>ã æè ï¼ä½ å¯ä»¥ä»æºç å®è£ protobufå°æå®æ件夹ï¼æ¯å¦ï¼~/local/ï¼è§£åtaræ件ï¼ç¶åæ§è¡</p> +<div class="highlight-default notranslate"><div class="highlight"><pre><span></span> $ ./configure --prefix=/home/<yourname>local + $ make && make install + $ echo "export LD_LIBRARY_PATH=/home/<yourname>/local/lib:$LD_LIBRARY_PATH" >> ~/.bashrc + $ source ~/.bashrc +</pre></div> +</div> +</li> +<li><p class="first">å¦ææ¾ä¸å°å ¶ä»pythonåºï¼ä½ å¯ä»¥ç¨pipæcondaå建pythonèæç¯å¢ã</p> +</li> +<li><p class="first">å¦æä¸æ¯ä»¥ä¸åå é æçï¼è¿å ¥<code class="docutils literal notranslate"><span class="pre">_singa_wrap.so</span></code>æå¨æ件夹ï¼æ§è¡</p> +<div class="highlight-default notranslate"><div class="highlight"><pre><span></span> $ python + >> import importlib + >> importlib.import_module('_singa_wrap') +</pre></div> +</div> +</li> +</ol> +<div class="highlight-default notranslate"><div class="highlight"><pre><span></span>æ£æ¥é误信æ¯ã æ¯å¦ï¼å¦ænumpyçæ¬ä¸å¹é ï¼é误信æ¯å°ä¼æ¯ + + RuntimeError: module compiled against API version 0xb but this version of numpy is 0xa + +æ¥çï¼ä½ éè¦æånumpyçæ¬ã +</pre></div> +</div> +</li> +</ul> +<ul> +<li><p class="first">Q: è¿è¡<code class="docutils literal notranslate"><span class="pre">cmake</span> <span class="pre">..</span></code>æ¥éï¼æ¾ä¸å°ä¾èµåºã</p> +<p>A: å¦æä½ æ²¡æå®è£ ç¸åºåºï¼å°±å»å®è£ å®ä»¬ãå¦æä½ æè¿äºåºå®è£ å¨éç³»ç»é»è®¤çè·¯å¾ä¸ï¼å¦/usr/localï¼ä½ å¯ä»¥å°æ£ç¡®è·¯å¾å¯¼åºå°ç¯å¢åéä¸ï¼</p> +<div class="highlight-default notranslate"><div class="highlight"><pre><span></span> $ export CMAKE_INCLUDE_PATH=<path to your header file folder> + $ export CMAKE_LIBRARY_PATH=<path to your lib file folder> +</pre></div> +</div> +</li> +</ul> +<ul> +<li><p class="first">Q: <code class="docutils literal notranslate"><span class="pre">make</span></code>æ¥éï¼å¦è¿æ¥é¶æ®µ</p> +<p>A: å¦æä½ çåºæ件å¨éç³»ç»é»è®¤è·¯å¾ä¸ï¼ä½ éè¦å¯¼åºç¸åºçåé</p> +<div class="highlight-default notranslate"><div class="highlight"><pre><span></span> $ export LIBRARY_PATH=<path to your lib file folder> + $ export LD_LIBRARY_PATH=<path to your lib file folder> +</pre></div> +</div> +</li> +</ul> +<ul> +<li><p class="first">Q: 头æ件é误ï¼æ¯å¦ï¼âcblas.h no such file or directory existsâ</p> +<p>A: ä½ éè¦æcblas.hçè·¯å¾å å ¥å°CPLUS_INCLUDE_PATHï¼å¦</p> +<div class="highlight-default notranslate"><div class="highlight"><pre><span></span> $ export CPLUS_INCLUDE_PATH=/opt/OpenBLAS/include:$CPLUS_INCLUDE_PATH +</pre></div> +</div> +</li> +<li><p class="first">Q:ç¼è¯SINGAæ¶ï¼æåç°äºé误<code class="docutils literal notranslate"><span class="pre">SSE2</span> <span class="pre">instruction</span> <span class="pre">set</span> <span class="pre">not</span> <span class="pre">enabled</span></code></p> +<p>A:ä½ å¯ä»¥å°è¯å¦ä¸å½ä»¤</p> +<div class="highlight-default notranslate"><div class="highlight"><pre><span></span> $ make CFLAGS='-msse2' CXXFLAGS='-msse2' +</pre></div> +</div> +</li> +<li><p class="first">Q:å½æè¯å¾å¯¼å ¥.pyæ件æ¶ï¼æå¾å°é误æ示<code class="docutils literal notranslate"><span class="pre">ImportError:</span> <span class="pre">cannot</span> <span class="pre">import</span> <span class="pre">name</span> <span class="pre">enum_type_wrapper</span></code>ã</p> +<p>A: ä½ éè¦å®è£ ç»å®å°pythonçprotobufï¼å¯ä»¥ç±å¦ä¸å½ä»¤å®è£ </p> +<div class="highlight-default notranslate"><div class="highlight"><pre><span></span> $ sudo apt-get install protobuf +</pre></div> +</div> +<p>æè ä»æºç å®è£ </p> +<div class="highlight-default notranslate"><div class="highlight"><pre><span></span> $ cd /PROTOBUF/SOURCE/FOLDER + $ cd python + $ python setup.py build + $ python setup.py install +</pre></div> +</div> +</li> +<li><p class="first">Q: å½æä»æºç å建OpenBLASæ¶ï¼è¢«åç¥éè¦Fortranç¼è¯å¨ã</p> +<p>A: ä½ å¯ä»¥ç¨å¦ä¸å½ä»¤ç¼è¯OpenBLAS</p> +<div class="highlight-default notranslate"><div class="highlight"><pre><span></span> $ make ONLY_CBLAS=1 +</pre></div> +</div> +<p>æè </p> +<div class="highlight-default notranslate"><div class="highlight"><pre><span></span> $ sudo apt-get install libopenblas-dev +</pre></div> +</div> +</li> +<li><p class="first">Q: å½æå建protocol bufferæ¶ï¼åºç°é误æ示<code class="docutils literal notranslate"><span class="pre">GLIBC++_3.4.20</span> <span class="pre">not</span> <span class="pre">found</span> <span class="pre">in</span> <span class="pre">/usr/lib64/libstdc++.so.6</span></code>ã</p> +<p>A: è¿è¯´æè¿æ¥å¨æ¾å°äºlibstdc++.so.6ï¼ä½æ¯è¿ä¸ªåºå±äºä¸ä¸ªæ´èçæ¬çGCCç¼è¯å¨ã è¦ç¼è¯çç¨åºä¾èµäºå®ä¹å¨æ°çæ¬GCCä¸çlibstdc++åºï¼æ以è¿æ¥å¨å¿ 须被åç¥å¦ä½æ¾å°æ°ççå¯å ±äº«çlibstdc++åºã æç®åçå¤çæ¹æ³æ¯æ¾å°æ£ç¡®çlibstdc++åºï¼å¯¼åºå°LD_LIBRARY_PATHåéã æ¯å¦ï¼å¦æGLIBC++_3.4.20被åå¨å¦ä¸å½ä»¤çè¾åºä¸</p> +<div class="highlight-default notranslate"><div class="highlight"><pre><span></span> $ strings /usr/local/lib64/libstdc++.so.6|grep GLIBC++ +</pre></div> +</div> +<p>ä¹åï¼ä½ åªéè¦è®¾ç½®ç¯å¢åé</p> +<div class="highlight-default notranslate"><div class="highlight"><pre><span></span> $ export LD_LIBRARY_PATH=/usr/local/lib64:$LD_LIBRARY_PATH +</pre></div> +</div> +</li> +<li><p class="first">Q: å½æå建glogæ¶æ¥éï¼âsrc/logging_unittest.cc:83:20: error: âgflagsâ is not a namespace-nameâã</p> +<p>A: è¿å¯è½æ¯ä½ è£ äºä¸ä¸ªä¸åå½å空é´çgflagsï¼æ¯å¦âgoogleâï¼æ以glogæ¾ä¸å°âgflagsâå½å空é´ã gflagsä¸æ¯å建glogå¿ é¡»çï¼ æä»¥ä½ å¯ä»¥ä¿®æ¹configure.acæ件以忽ç¥gflagsã</p> +<div class="highlight-default notranslate"><div class="highlight"><pre><span></span> <span class="mf">1.</span> <span class="n">cd</span> <span class="n">to</span> <span class="n">glog</span> <span class="n">src</span> <span class="n">directory</span> + <span class="mf">2.</span> <span class="n">change</span> <span class="n">line</span> <span class="mi">125</span> <span class="n">of</span> <span class="n">configure</span><span class="o">.</span><span class="n">ac</span> <span class="n">to</span> <span class="s2">"AC_CHECK_LIB(gflags, main, ac_cv_have_libgflags=0, ac_cv_have_libgflags=0)"</span> + <span class="mf">3.</span> <span class="n">autoreconf</span> +</pre></div> +</div> +<p>ä¹åï¼ä½ å¯ä»¥éæ°å建glogã</p> +</li> +<li><p class="first">Q: å½ä½¿ç¨èæç¯å¢æ¶ï¼æ¯æ¬¡æè¿è¡pip installé½ä¼éæ°å®è£ numpyã ç¶èï¼å¨<code class="docutils literal notranslate"><span class="pre">import</span> <span class="pre">numpy</span></code>æ¶ï¼numpyå¯è½å¹¶æ²¡æ被使ç¨ã</p> +<p>A: è¿å¯è½æ¯å 为å¨ä½¿ç¨èæç¯å¢æ¶ï¼<code class="docutils literal notranslate"><span class="pre">PYTHONPATH</span></code>被设置æäºç©ºä»¥é²æ¢ä¸èæç¯å¢ä¸çè·¯å¾åçå²çªã</p> +</li> +<li><p class="first">Q: å½ä»æºç ç¼è¯PySINGAæ¶ï¼ä¼å 为缺失<numpy/objectarray.h>èåºç°ç¼è¯é误ã</p> +<p>A: 请å®è£ numpy并ä¸éè¿å¦ä¸å½ä»¤å¯¼åºnumpy头æ件</p> +<div class="highlight-default notranslate"><div class="highlight"><pre><span></span> $ export CPLUS_INCLUDE_PATH=`python -c "import numpy; print numpy.get_include()"`:$CPLUS_INCLUDE_PATH +</pre></div> +</div> +</li> +<li><p class="first">Q: å½å¨Mac OS Xä¸è¿è¡PySINGAæ¶ï¼æå¾å°äºé误信æ¯âFatal Python error: PyThreadState_Get: no current thread Abort trap: 6âã</p> +<p>A: è¿ä¸ªé误å¾å ¸åå°åºç°å¨å½ä½ ç³»ç»ä¸åå¨å¤ä¸ªçæ¬çpython并ä¸ä½ æ¯éè¿pipå®è£ +SINGAçï¼è¿ä¸ªé®é¢å¯ä»¥éè¿ç±condaå®è£ SINGAæ¥è§£å³ï¼ï¼ æ¯å¦ï¼ä¸ä¸ªæ¥èªäºOSï¼ä¸ä¸ªéè¿Homebrewå®è£ ã åSINGAè¿æ¥çPythonå¿ é¡»åPython解æå¨æ¯å个çæ¬ãä½ å¯ä»¥éè¿which pythonæ¥æ¥çpython解æå¨çæ¬ï¼å¹¶éè¿otool -L <path to _singa_wrap.so>æ£æ¥åPySINGAè¿æ¥çPythonçæ¬ã 为äºè§£å³è¿ä¸ªé®é¢ï¼ éè¦ç¨æ£ç¡®çPythonçæ¬æ¥ç¼è¯SINGAã ç¹å«å°ï¼å¦æä½ ä»æºç å建çPySINGAï¼å½å¤èµ·<a class="reference external" href="http://stackoverflow.com/questions/15291500/i-have-2-versions-of-python-installed-but-cmake-is-using-older-version-how-do";>cmake</a>æ¶ä½ é è¦æå®å®è£ è·¯å¾</p> +<div class="highlight-default notranslate"><div class="highlight"><pre><span></span> $ cmake -DPYTHON_LIBRARY=`python-config --prefix`/lib/libpython2.7.dylib -DPYTHON_INCLUDE_DIR=`python-config --prefix`/include/python2.7/ .. +</pre></div> +</div> +<p>å¦æä»äºè¿å¶æ件å®è£ PySINGAï¼æ¯å¦debianæè wheelï¼é£ä¹ä½ éè¦æ¹åpython解æå¨ï¼å¦éç½®åé$PATHï¼ææ£ç¡®çPythonè·¯å¾å å¨æåé¢ã</p> +</li> +</ul> +</div> +</div> + + + </div> + + </div> + <footer> + + <div class="rst-footer-buttons" role="navigation" aria-label="footer navigation"> + + <a href="software_stack.html" class="btn btn-neutral float-right" title="软件æ¶æ" accesskey="n" rel="next">Next <span class="fa fa-arrow-circle-right"></span></a> + + + <a href="index.html" class="btn btn-neutral" title="ææ¡£" accesskey="p" rel="prev"><span class="fa fa-arrow-circle-left"></span> Previous</a> + + </div> + + + <hr/> + + <div role="contentinfo"> + <p> + © Copyright 2018 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/rtfd/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', + LANGUAGE:'None', + COLLAPSE_INDEX:false, + FILE_SUFFIX:'.html', + HAS_SOURCE: true, + SOURCELINK_SUFFIX: '.txt' + }; + </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.Navigation.enable(true); + }); + </script> + +<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 + <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> + + <a href="https://github.com/apache/incubator-singa"; class="fa fa-github" style="padding: 10px; font-size: 20px; width: 30px; text-align: center; text-decoration: none; margin: 5px 2px;"></a> + <a href="https://aws.amazon.com/marketplace/seller-profile?id=5bcac385-12c4-4802-aec7-351e09b77b4c"; class="fab fa-aws" style="padding: 10px; font-size: 20px; width: 30px; text-align: center; text-decoration: none; margin: 5px 2px;"></a> + <a href="https://hub.docker.com/r/nusdbsystem/singa/"; class="fab fa-docker" style="padding: 10px; font-size: 20px; width: 30px; text-align: center; text-decoration: none; margin: 5px 2px;"></a> + <a href="https://www.linkedin.com/groups/13550034"; class="fa fa-linkedin" style="padding: 10px; font-size: 20px; width: 30px; text-align: center; text-decoration: none; margin: 5px 2px;"></a> + <a href="https://twitter.com/ApacheSinga"; class="fa fa-twitter" style="padding: 10px; font-size: 20px; width: 30px; text-align: center; text-decoration: none; margin: 5px 2px;"></a> + <a href="https://www.facebook.com/Apache-SINGA-347284219056544/"; class="fa fa-facebook" style="padding: 10px; font-size: 20px; width: 30px; text-align: center; text-decoration: none; margin: 5px 2px;"></a> + <a href="https://www.researchgate.net/project/Apache-SINGA"; class="fab fa-researchgate" style="padding: 10px; font-size: 20px; width: 30px; text-align: center; text-decoration: none; margin: 5px 2px;"></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
![https://s3.amazonaws.com/github/ribbons/forkme_right_orange_ff7600.png"](https://s3.amazonaws.com/github/ribbons/forkme_right_orange_ff7600.png"){kind=link}
