-
Notifications
You must be signed in to change notification settings - Fork 172
/
INSTALLGUIDE
129 lines (95 loc) · 3.85 KB
/
INSTALLGUIDE
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
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:
g++
gfortran
libtool
autoconf
automake
git-core
subversion
xserver-xorg-dev
xorg-dev
libx11-dev
libgl1-mesa-dev
libglu1-mesa-dev
libglut3-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 libtool autoconf automake \
git-core subversion xserver-xorg-dev xorg-dev libx11-dev \
libgl1-mesa-dev libglu1-mesa-dev libglut3-dev
For Red Hat-based distributions one can do instead:
sudo yum -y install gcc-c++ gcc-gfortran libtool autoconf automake \
git subversion xorg-x11-server-Xorg libX11-devel \
mesa-libGL-devel freeglut-devel
(If your git install fails, you may need to enable the EPEL repository.)
2. Base dependencies - MAC
First install Macports (http://www.macports.org/) if you do not
already have it.
Next you need the following packages:
libtool
git-core
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
Next you need to compile a copy of GNU Coreutils. The following
instructions should do so:
cd ~/packages
wget http://ftp.gnu.org/gnu/coreutils/coreutils-8.16.tar.xz
xz -d coreutils-8.16.tar.xz
tar xfv coreutils-8.16.tar
cd coreutils-8.16
./configure --prefix $PWD/build
make install -j 8
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
MAC USERS: The last line needs to specify the path to the coreutils
you installed earlier:
./build.py --coreutils ~/packages/coreutils-8.16/build/bin
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 --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.