Skip to content

Latest commit

 

History

History
107 lines (79 loc) · 2.85 KB

INSTALL_INSTRUCTIONS.md

File metadata and controls

107 lines (79 loc) · 2.85 KB
Raw

DELF installation

Tensorflow

For detailed steps to install Tensorflow, follow the Tensorflow installation instructions. A typical user can install Tensorflow using one of the following commands:

# For CPU:
pip install tensorflow
# For GPU:
pip install tensorflow-gpu

Protobuf

The DELF library uses protobuf (the python version) to configure feature extraction and its format. You will need the protoc compiler, version >= 3.3. The easiest way to get it is to download directly. For Linux, this can be done as (see here for other platforms):

Linux

wget https://github.com/google/protobuf/releases/download/v3.3.0/protoc-3.3.0-linux-x86_64.zip
unzip protoc-3.3.0-linux-x86_64.zip
PATH_TO_PROTOC=`pwd`

OSX

wget https://github.com/protocolbuffers/protobuf/releases/download/v3.7.0/protoc-3.7.0-osx-x86_64.zip
unzip protoc-3.3.0-linux-x86_64.zip
PATH_TO_PROTOC=`pwd`

Python dependencies

Install python library dependencies:

sudo pip install matplotlib
sudo pip install numpy
sudo pip install scikit-image
sudo pip install scipy

tensorflow/models

Now, clone tensorflow/models, and install required libraries: (note that the object_detection library requires you to add tensorflow/models/research/ to your PYTHONPATH, as instructed here)

git clone https://github.com/tensorflow/models

# First, install slim's "nets" package.
cd models/research/slim/
sudo pip install -e .

# Second, setup the object_detection module by editing PYTHONPATH.
cd ..
# From tensorflow/models/research/
export PYTHONPATH=$PYTHONPATH:`pwd`

Then, compile DELF's protobufs. Use PATH_TO_PROTOC as the directory where you downloaded the protoc compiler.

# From tensorflow/models/research/delf/
${PATH_TO_PROTOC?}/bin/protoc delf/protos/*.proto --python_out=.

Finally, install the DELF package.

# From tensorflow/models/research/delf/
sudo pip install -e . # Install "delf" package.

At this point, running

python -c 'import delf'

should just return without complaints. This indicates that the DELF package is loaded successfully.

Troubleshooting

Python version

Installation issues may happen if multiple python versions are mixed. The instructions above assume python2.7 version is used; if using python3.X, be sure to use pip3 instead of pip, and all should work.

pip install

Issues might be observed if using pip install with -e option (editable mode). You may try out to simply remove the -e from the commands above. Also, depending on your machine setup, you might need to run the pip install command without sudo at the beginning.