Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
124 lines (92 sloc) 3.885 kb
INSTALLATION AND USE
A. Obtaining the Software
If you are reading this text, you presumably have a copy of the
software. However, you can obtain the most recent version from
https://github.com/NeoGeographyToolkit/StereoPipeline
B. Installing the Software
Stereo Pipeline pre-built binaries are available from two locations:
Official releases at:
http://ti.arc.nasa.gov/tech/asr/intelligent-robotics/ngt/stereo/
Daily builds of the latest development version at:
http://byss.arc.nasa.gov/stereopipeline/daily_build/
If desired, Stereo Pipeline can be built from source as well. Building
from source can be difficult, due to the large number of dependencies,
and the variety of Linux and Mac architectures Stereo Pipeline
supports. A separate software package called BinaryBuilder will take
care of setting up the build environment and building the code. We
describe below what dependencies BinaryBuilder needs and then how to
invoke it.
1. Base dependencies - LINUX
The following packages need to be installed in order to build Stereo
Pipeline:
Python (version >= 2.6.1)
g++, gfortran (version >= 4.4.7)
csh
libtool
autoconf
automake
git-core
subversion
xserver-xorg-dev
xorg-dev
libx11-dev
libxext-dev
libxmu
libxmu-dev
libxi-dev
libgl1-mesa-dev
libglu1-mesa-dev
freeglut3-dev
If you have root access on your machine you can install them on a
Debian-based distribution using the following command:
sudo apt-get install g++ gfortran csh libtool autoconf automake \
git-core subversion xserver-xorg-dev xorg-dev libx11-dev \
libxext-dev libxmu6 libxmu-dev libxi-dev libgl1-mesa-dev \
libglu1-mesa-dev freeglut3-dev
For Red Hat-based distributions one can do instead:
sudo yum -y install gcc-c++ gcc-gfortran tcsh libtool autoconf \
automake git subversion xorg-x11-server-Xorg libX11-devel \
libXext-devel libXmu libXmu-devel libXi-devel mesa-libGL-devel \
freeglut-devel
If your git install fails on Red Hat, you may need to enable the EPEL
repository.
It is important to check that the gcc, g++, and gfortran versions
are as above.
2. Base dependencies - MAC
First install Homebrew or Macports, if you do not already have it.
Next you need the following packages:
libtool
git
subversion
xz
If you are using OSX 10.7 Lion, you will need to manually install the
OSX 10.5 SDK. This is required for building against ISIS since they
currently only have a 10.5 version of their binary. See instructions
here: http://lunokhod.org/?p=269
3. Invoking Binary Builder
Having installed the base libraries and tools, the following lines of
code will start the build of Stereo Pipeline in the directory
'~/projects/BinaryBuilder':
cd ~; mkdir projects; cd projects
git clone https://github.com/NeoGeographyToolkit/BinaryBuilder.git
cd BinaryBuilder
./build.py --download-dir tarballs --build-root build_asp
Due to the amount of code that must be downloaded and built,
BinaryBuilder will take quite a while to finish. If you see the
message "All done!" then it has succeeded. Otherwise something has
gone wrong and must be fixed before the build can continue. Often
this is due to one of the dependencies listed earlier being too old or
missing.
If the build failed and you need to restart it after finding a fix,
use the following command:
./build.py --download-dir tarballs --build-root build_asp --resume
Once the build is successful you should make a distribution tarball to
store the completed build. Do so using the following command from the
BinaryBuilder directory:
./make-dist.py last-completed-run/install
C. Using the Software
When you unpack the Stereo Pipeline tarball, it will contain a copy of
the documentation in pdf format, a set of command-line tools in the
"bin/" directory, and other dependencies. The "bin/" directory needs
to be in your path. See the README file for how to use Stereo
Pipeline.
Jump to Line
Something went wrong with that request. Please try again.