Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with
or
.
Download ZIP
Newer
Older
100644 125 lines (91 sloc) 3.797 kB
823a89b @novas0x2a README & AUTHORS touchups
novas0x2a authored
1 INSTALLATION AND USE
2
228bba7 @oleg-alexandrov INSTALLGUIDE: Leave the building from source for the end
oleg-alexandrov authored
3 A. Installing the Software
9fd8e16 @ScottMcMichael Docs: Updated InstallGuide to reflect use of BinaryBuilder
ScottMcMichael authored
4
f83eca0 @oleg-alexandrov INSTALLGUIDE: Large overhaul
oleg-alexandrov authored
5 Stereo Pipeline pre-built binaries are available from two locations:
9fd8e16 @ScottMcMichael Docs: Updated InstallGuide to reflect use of BinaryBuilder
ScottMcMichael authored
6
f83eca0 @oleg-alexandrov INSTALLGUIDE: Large overhaul
oleg-alexandrov authored
7 Official releases at:
8 http://ti.arc.nasa.gov/tech/asr/intelligent-robotics/ngt/stereo/
9
10 Daily builds of the latest development version at:
11 http://byss.arc.nasa.gov/stereopipeline/daily_build/
12
228bba7 @oleg-alexandrov INSTALLGUIDE: Leave the building from source for the end
oleg-alexandrov authored
13 B. Using the Software
14
15 When you unpack the Stereo Pipeline tarball, it will contain a copy of
16 the documentation in pdf format, a set of command-line tools in the
17 "bin/" directory, and other dependencies. The "bin/" directory needs
18 to be in your path. See the README file for how to use Stereo
19 Pipeline.
20
21 C. Installing from Source
22
23 If desired, Stereo Pipeline can be built from source code as
24 well. The source code is available at
25
26 https://github.com/NeoGeographyToolkit/StereoPipeline
27
28 Building from source can be difficult, due to the large number of
29 dependencies, and the variety of Linux and Mac architectures Stereo
30 Pipeline supports. A separate software package called BinaryBuilder
31 will take care of setting up the build environment and building the
32 code. We describe below what dependencies BinaryBuilder needs and then
33 how to invoke it.
9fd8e16 @ScottMcMichael Docs: Updated InstallGuide to reflect use of BinaryBuilder
ScottMcMichael authored
34
35 1. Base dependencies - LINUX
36
f83eca0 @oleg-alexandrov INSTALLGUIDE: Large overhaul
oleg-alexandrov authored
37 The following packages need to be installed in order to build Stereo
38 Pipeline:
9fd8e16 @ScottMcMichael Docs: Updated InstallGuide to reflect use of BinaryBuilder
ScottMcMichael authored
39
1f1f0c6 @oleg-alexandrov INSTALLGUIDE: Specify minimum gcc and python versions
oleg-alexandrov authored
40 Python (version >= 2.6.1)
0cfdbb1 @oleg-alexandrov Clarify install guide
oleg-alexandrov authored
41 g++, gfortran (version >= 4.4.7)
1f1f0c6 @oleg-alexandrov INSTALLGUIDE: Specify minimum gcc and python versions
oleg-alexandrov authored
42 csh
9fd8e16 @ScottMcMichael Docs: Updated InstallGuide to reflect use of BinaryBuilder
ScottMcMichael authored
43 libtool
44 autoconf
45 automake
46 git-core
47 subversion
48 xserver-xorg-dev
49 xorg-dev
50 libx11-dev
ea35a8a @oleg-alexandrov INSTALLGUIDE: Expand on needed dependencies
oleg-alexandrov authored
51 libxext-dev
ba5019e @oleg-alexandrov INSTALLGUIDE: More clarifications about prerequisites
oleg-alexandrov authored
52 libxmu
53 libxmu-dev
54 libxi-dev
9fd8e16 @ScottMcMichael Docs: Updated InstallGuide to reflect use of BinaryBuilder
ScottMcMichael authored
55 libgl1-mesa-dev
56 libglu1-mesa-dev
f04a2f8 @oleg-alexandrov INSTALLGUIDE: Update doc for glut install
oleg-alexandrov authored
57 freeglut3-dev
9fd8e16 @ScottMcMichael Docs: Updated InstallGuide to reflect use of BinaryBuilder
ScottMcMichael authored
58
153cf7b @oleg-alexandrov INSTALLGUIDE: Minor polishing
oleg-alexandrov authored
59 If you have root access on your machine you can install them on a
60 Debian-based distribution using the following command:
f83eca0 @oleg-alexandrov INSTALLGUIDE: Large overhaul
oleg-alexandrov authored
61
1f1f0c6 @oleg-alexandrov INSTALLGUIDE: Specify minimum gcc and python versions
oleg-alexandrov authored
62 sudo apt-get install g++ gfortran csh libtool autoconf automake \
ba5019e @oleg-alexandrov INSTALLGUIDE: More clarifications about prerequisites
oleg-alexandrov authored
63 git-core subversion xserver-xorg-dev xorg-dev libx11-dev \
64 libxext-dev libxmu6 libxmu-dev libxi-dev libgl1-mesa-dev \
65 libglu1-mesa-dev freeglut3-dev
9fd8e16 @ScottMcMichael Docs: Updated InstallGuide to reflect use of BinaryBuilder
ScottMcMichael authored
66
153cf7b @oleg-alexandrov INSTALLGUIDE: Minor polishing
oleg-alexandrov authored
67 For Red Hat-based distributions one can do instead:
a28f6ca @oleg-alexandrov INSTALLGUIDE: How to install dependencies for Red Hat
oleg-alexandrov authored
68
1f1f0c6 @oleg-alexandrov INSTALLGUIDE: Specify minimum gcc and python versions
oleg-alexandrov authored
69 sudo yum -y install gcc-c++ gcc-gfortran tcsh libtool autoconf \
ba5019e @oleg-alexandrov INSTALLGUIDE: More clarifications about prerequisites
oleg-alexandrov authored
70 automake git subversion xorg-x11-server-Xorg libX11-devel \
71 libXext-devel libXmu libXmu-devel libXi-devel mesa-libGL-devel \
72 freeglut-devel
a28f6ca @oleg-alexandrov INSTALLGUIDE: How to install dependencies for Red Hat
oleg-alexandrov authored
73
0cfdbb1 @oleg-alexandrov Clarify install guide
oleg-alexandrov authored
74 If your git install fails on Red Hat, you may need to enable the EPEL
75 repository.
a28f6ca @oleg-alexandrov INSTALLGUIDE: How to install dependencies for Red Hat
oleg-alexandrov authored
76
0cfdbb1 @oleg-alexandrov Clarify install guide
oleg-alexandrov authored
77 It is important to check that the gcc, g++, and gfortran versions
78 are as above.
79
9fd8e16 @ScottMcMichael Docs: Updated InstallGuide to reflect use of BinaryBuilder
ScottMcMichael authored
80 2. Base dependencies - MAC
81
4d84581 @oleg-alexandrov INSTALLGUIDE: We install coreutils automatically on Mac
oleg-alexandrov authored
82 First install Homebrew or Macports, if you do not already have it.
9fd8e16 @ScottMcMichael Docs: Updated InstallGuide to reflect use of BinaryBuilder
ScottMcMichael authored
83
84 Next you need the following packages:
85
86 libtool
4d84581 @oleg-alexandrov INSTALLGUIDE: We install coreutils automatically on Mac
oleg-alexandrov authored
87 git
9fd8e16 @ScottMcMichael Docs: Updated InstallGuide to reflect use of BinaryBuilder
ScottMcMichael authored
88 subversion
89 xz
90
f83eca0 @oleg-alexandrov INSTALLGUIDE: Large overhaul
oleg-alexandrov authored
91 If you are using OSX 10.7 Lion, you will need to manually install the
92 OSX 10.5 SDK. This is required for building against ISIS since they
93 currently only have a 10.5 version of their binary. See instructions
94 here: http://lunokhod.org/?p=269
9fd8e16 @ScottMcMichael Docs: Updated InstallGuide to reflect use of BinaryBuilder
ScottMcMichael authored
95
f83eca0 @oleg-alexandrov INSTALLGUIDE: Large overhaul
oleg-alexandrov authored
96 3. Invoking Binary Builder
9fd8e16 @ScottMcMichael Docs: Updated InstallGuide to reflect use of BinaryBuilder
ScottMcMichael authored
97
f83eca0 @oleg-alexandrov INSTALLGUIDE: Large overhaul
oleg-alexandrov authored
98 Having installed the base libraries and tools, the following lines of
99 code will start the build of Stereo Pipeline in the directory
100 '~/projects/BinaryBuilder':
9fd8e16 @ScottMcMichael Docs: Updated InstallGuide to reflect use of BinaryBuilder
ScottMcMichael authored
101
102 cd ~; mkdir projects; cd projects
103 git clone https://github.com/NeoGeographyToolkit/BinaryBuilder.git
104 cd BinaryBuilder
b8a2c42 @oleg-alexandrov Minor update to INSTALLGUIDE
oleg-alexandrov authored
105 ./build.py --download-dir tarballs --build-root build_asp
9fd8e16 @ScottMcMichael Docs: Updated InstallGuide to reflect use of BinaryBuilder
ScottMcMichael authored
106
f83eca0 @oleg-alexandrov INSTALLGUIDE: Large overhaul
oleg-alexandrov authored
107 Due to the amount of code that must be downloaded and built,
108 BinaryBuilder will take quite a while to finish. If you see the
109 message "All done!" then it has succeeded. Otherwise something has
110 gone wrong and must be fixed before the build can continue. Often
111 this is due to one of the dependencies listed earlier being too old or
112 missing.
9fd8e16 @ScottMcMichael Docs: Updated InstallGuide to reflect use of BinaryBuilder
ScottMcMichael authored
113
f83eca0 @oleg-alexandrov INSTALLGUIDE: Large overhaul
oleg-alexandrov authored
114 If the build failed and you need to restart it after finding a fix,
115 use the following command:
9fd8e16 @ScottMcMichael Docs: Updated InstallGuide to reflect use of BinaryBuilder
ScottMcMichael authored
116
b8a2c42 @oleg-alexandrov Minor update to INSTALLGUIDE
oleg-alexandrov authored
117 ./build.py --download-dir tarballs --build-root build_asp --resume
9fd8e16 @ScottMcMichael Docs: Updated InstallGuide to reflect use of BinaryBuilder
ScottMcMichael authored
118
f83eca0 @oleg-alexandrov INSTALLGUIDE: Large overhaul
oleg-alexandrov authored
119 Once the build is successful you should make a distribution tarball to
120 store the completed build. Do so using the following command from the
121 BinaryBuilder directory:
9fd8e16 @ScottMcMichael Docs: Updated InstallGuide to reflect use of BinaryBuilder
ScottMcMichael authored
122
f83eca0 @oleg-alexandrov INSTALLGUIDE: Large overhaul
oleg-alexandrov authored
123 ./make-dist.py last-completed-run/install
823a89b @novas0x2a README & AUTHORS touchups
novas0x2a authored
124
Something went wrong with that request. Please try again.