You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@mxnet.apache.org by ma...@apache.org on 2019/02/19 15:13:22 UTC

[incubator-mxnet] branch master updated: update raspberry pi install instructions (#14172)

This is an automated email from the ASF dual-hosted git repository.

marcoabreu pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/incubator-mxnet.git


The following commit(s) were added to refs/heads/master by this push:
     new af9e3b3  update raspberry pi install instructions (#14172)
af9e3b3 is described below

commit af9e3b3ae9f55b51dd2557a8b664622571ceda48
Author: Aaron Markham <ma...@amazon.com>
AuthorDate: Tue Feb 19 07:08:39 2019 -0800

    update raspberry pi install instructions (#14172)
---
 docs/install/index.md          | 50 +++++++++++++++++++++++++++++++++++++-----
 docs/install/raspbian_setup.md |  4 ++--
 2 files changed, 47 insertions(+), 7 deletions(-)

diff --git a/docs/install/index.md b/docs/install/index.md
index 76f22e7..2b7e045 100644
--- a/docs/install/index.md
+++ b/docs/install/index.md
@@ -1188,7 +1188,7 @@ MXNet should work on any cloud provider's CPU-only instances. Follow the Python
 <div class="devices">
   <div class="raspberry-pi">
 
-MXNet supports the Debian based Raspbian ARM based operating system so you can run MXNet on Raspberry Pi Devices.
+MXNet supports the Debian based Raspbian ARM based operating system so you can run MXNet on Raspberry Pi 3B devices.
 
 These instructions will walk through how to build MXNet for the Raspberry Pi and install the Python bindings for the library.
 
@@ -1196,6 +1196,9 @@ You can do a dockerized cross compilation build on your local machine or a nativ
 
 The complete MXNet library and its requirements can take almost 200MB of RAM, and loading large models with the library can take over 1GB of RAM. Because of this, we recommend running MXNet on the Raspberry Pi 3 or an equivalent device that has more than 1 GB of RAM and a Secure Digital (SD) card that has at least 4 GB of free memory.
 
+## Quick installation
+You can use this [pre-built Python wheel](wget https://mxnet-public.s3.amazonaws.com/install/raspbian/mxnet-1.5.0-py2.py3-none-any.whl) on a Raspberry Pi 3B with Stretch. You will likely need to install several dependencies to get MXNet to work. Refer to the following **Build** section for details.
+
 **Cross compilation build (Experimental)**
 
 ## Docker installation
@@ -1222,11 +1225,48 @@ ci/build.py -p armv7
 
 ## Install
 
-Create a virtualenv and install the package we created previously.
+Your Pi will need several dependencies.
+
+Install MXNet dependencies with the following:
+```
+sudo apt-get update
+sudo apt-get install -y \
+    apt-transport-https \
+    build-essential \
+    ca-certificates \
+    cmake \
+    curl \
+    git \
+    libatlas-base-dev \
+    libcurl4-openssl-dev \
+    libjemalloc-dev \
+    liblapack-dev \
+    libopenblas-dev \
+    libopencv-dev \
+    libzmq3-dev \
+    ninja-build \
+    python-dev \
+    software-properties-common \
+    sudo \
+    unzip \
+    virtualenv \
+    wget
+```
+Install virtualenv with:
+```
+sudo pip install virtualenv
+```
+Create a Python 2.7 environment for MXNet with:
+```
+virtualenv -p `which python` mxnet_py27
+```
+You may use Python 3, however the [wine bottle detection example](https://mxnet.incubator.apache.org/versions/master/tutorials/embedded/wine_detector.html) for the Pi with camera requires Python 2.7.
+
+Create a virtualenv and install the wheel we created previously, or the wheel that you downloaded.
 
 ```
-virtualenv -p `which python3` mxnet_py3
-source mxnet_py3/bin/activate
+virtualenv -p `which python3` mxnet_py27
+source mxnet_py27/bin/activate
 pip install mxnet-x.x.x-py2.py3-none-any.whl
 ```
 
@@ -1257,7 +1297,7 @@ Install these dependencies using the following commands in any directory:
 
 ```
     sudo apt-get update
-    sudo apt-get -y install git cmake ninja-build build-essential g++-4.9 c++-4.9 liblapack* libblas* libopencv* libopenblas* python3-dev virtualenv
+    sudo apt-get -y install git cmake ninja-build build-essential g++-4.9 c++-4.9 liblapack* libblas* libopencv* libopenblas* python3-dev python-dev virtualenv
 ```
 
 Clone the MXNet source code repository using the following `git` command in your home directory:
diff --git a/docs/install/raspbian_setup.md b/docs/install/raspbian_setup.md
index a432d48..896d472 100644
--- a/docs/install/raspbian_setup.md
+++ b/docs/install/raspbian_setup.md
@@ -17,9 +17,9 @@
 
 <!-- This page should be deleted after sometime (Allowing search engines
 to update links) -->
-<meta http-equiv="refresh" content="3; url=http://mxnet.io/install/index.html" />
+<meta http-equiv="refresh" content="3; url=https://mxnet.incubator.apache.org/versions/master/install/index.html?platform=Devices&language=Python&processor=CPU" />
 <!-- Just in case redirection does not work -->
 <p>
-  <a href="http://mxnet.io/install/index.html">
+  <a href="https://mxnet.incubator.apache.org/versions/master/install/index.html?platform=Devices&language=Python&processor=CPU">
     This content is moved to a new MXNet install page. Redirecting... </a>
 </p>