Installation

We provide different standalone binary packages for OTB-Applications:

  • for Windows platform (7 or higher)
  • for 64bit Linux distribution
  • for MacOS X

Other binaries can be available as packages (OSGeo packages, Debian/Ubuntu packages, OpenSuse packages), however be advised that they may not be up-to-date nor delivered with full features. If you want to build from source or if we don’t provide packages for your system, some informations are available into the , in the section (Building from Source)

Windows

We provide for Windows Seven and later through standalone packages. They are cross-compiled with MinGW, for 32bit and 64bit platforms. They contain all and their launchers (both command line and graphical launchers are provided). Check the download page : OTB Download page

There is a 32bit and a 64bit version. They contain the same directory structure:

  • monteverdi.bat : A launcher script for Monteverdi
  • mapla.bat : A launcher script for Mapla
  • otbenv.bat : A script to initialize the environment for OTB executables
  • bin : A folder containing application launchers (otbcli.bat, otbgui.bat) and the DLLs.
  • lib : A folder containing application DLLs.

The applications can be launched from the Mapla launcher. If you want to use the otbcli and otbgui launchers, you can initialize a command prompt with otbenv.bat.

Linux 64bit

We provide for Linux 64bit OS through standalone packages. They contain all OTB Applications and their launchers (both command line and graphical launchers are provided). Check the download page : OTB Download page

This package is a self-extractible archive. You may uncompress it with a double-click on the file, or with the command line :

> chmod +x OTB-&\otbversion&-Linux64.run
> ./OTB-&\otbversion&-Linux64.run

Please note that the resulting installation is not meant to be moved, you should uncompress the archive in its final location. Once the archive is extracted, the directory structure is made of :

  • monteverdi.sh : A launcher script for Monteverdi
  • mapla.sh : A launcher script for Mapla
  • otbenv.profile : A script to initialize the environment for OTB executables
  • bin : A folder containing application launchers (otbcli.sh, otbgui.sh), Monteverdi and Mapla.
  • lib : A folder containing all shared libraries and OTB applications.
  • share : A folder containing common resources and copyright mentions.

In order to run the command line launchers, this package doesn’t require any special library that is not present in most modern Linux distributions. The graphical executable (otbgui launchers, Monteverdi and Mapla) use the X11 libraries, which are widely used in a lot of distributions :

libx11-6 libxext6 libxau6 libxxf86vm1 libxdmcp6 libdrm2

Monteverdi also requires the standard graphics libraries libgl1 and libglu1. Make sure you have at least one version of them installed in your system.

The applications can be launched from the Mapla launcher. If you want to use the otbcli and otbgui launchers, you can initialize your environment with source otbenv.profile.

MacOS X

We provide for MacOS X through a standalone package. This package is a self-extractible archive, quite similar to the Linux one. You may uncompress it with the command line :

> chmod +x  OTB-&\otbversion&-Darwin64.run
> ./OTB-&\otbversion&-Darwin64.run

Once the archive is extracted, you can see OTB–Darwin64 directory in the same direcrtory along with OTB–Darwin64.run

Contents of OTB–Darwin64 is briefly listed below:

  • Monteverdi.app : A Mac OSX .app for Monteverdi
  • Mapla.app : A Mac OSX .app for Mapla.
  • bin : A folder containing application launchers (otbcli.sh, otbgui.sh), monteverdi and mapla binaries.
  • lib : A folder containing all shared libraries and OTB applications.
  • share : A folder containing common resources and copyright mentions.

Notes:

  • If you want to use the otbcli and otbgui launchers, you must access them via a terminal prompt.
  • The OSX .app are provided for monteverdi (viewer) and mapla (application browser).
  • You must use monteverdi and mapla through their .app files only.
  • You are allowed to move these .app files and refrain from moving or deleting OTB–Darwin64 after extraction. In case you need to have OTB installed in some other directory. Extract the .run file there.

Other packages

Warning ! These packages may not be up-to-date with latest OTB releases. In addition, some features of the library may not be available on every platform. Some of these are not maintained by OTB-team. If you want to get involved in the packaging of OTB for your favourite platform, please contact us through the developer’s mailing list : otb-developers@googlegroups.com.

Debian

There are OTB packages for Debian (unstable) since version 5.2.0. OTB Applications packages may be available as Debian packages through APT repositories:

  • otb-bin for command line applications
  • otb-bin-qt for Qt applications
  • python-otb for python applications

Due to license issues, the OTB package built in Debian doesn’t contain 6S. As a consequence, the package does not contain the OpticalCalibration application.

Ubuntu 12.04 and higher

For Ubuntu 12.04 and higher, OTB Applications packages may be available as Debian packages through APT repositories:

  • otb-bin for command line applications
  • otb-bin-qt for Qt applications
  • python-otb for python applications

Since release 3.14.1, OTB Applications packages are available in the ubuntugis-unstable repository.

Since release 5.2.0, the Ubuntu packages derive from the Debian packages.

You can add it by using these command-lines:

sudo aptitude install add-apt-repository
sudo apt-add-repository ppa:ubuntugis/ubuntugis-unstable

After you can run:

sudo aptitude install otb-bin otb-bin-qt python-otb

If you are using Synaptic, you can add the repositories, update and install the packages through the graphical interface.

For further informations about Ubuntu packages go to ubuntugis-unstable launchpad page and click on Read about installing.

apt-add-repository will try to retrieve the GPG keys of the repositories to certify the origin of the packages. If you are behind a http proxy, this step won’t work and apt-add-repository will stall and eventually quit. You can temporarily ignore this error and proceed with the update step. Following this, aptitude update will issue a warning about a signature problem. This warning won’t prevent you from installing the packages.

OpenSuse 12.X and higher

For OpenSuse 12.X and higher, OTB Applications packages are available through zypper.

First, you need to add the appropriate repositories with these command-lines (please replace \(11.4\) by your OpenSuse version):

sudo zypper ar
http://download.opensuse.org/repositories/games/openSUSE_11.4/ Games
sudo zypper ar
http://download.opensuse.org/repositories/Application:/Geo/openSUSE_11.4/ GEO
sudo zypper ar
http://download.opensuse.org/repositories/home:/tzotsos/openSUSE_11.4/ tzotsos

Now run:

sudo zypper refresh
sudo zypper install OrfeoToolbox
sudo zypper install OrfeoToolbox-python

Alternatively you can use the One-Click Installer from the openSUSE Download page or add the above repositories and install through Yast Package Management.

There is also support for the recently introduced ’rolling’ openSUSE distribution named ’Tumbleweed’. For Tumbleweed you need to add the following repositories with these command-lines:

sudo zypper ar
http://download.opensuse.org/repositories/games/openSUSE_Tumbleweed/ Games
sudo zypper ar
http://download.opensuse.org/repositories/Application:/Geo/openSUSE_Tumbleweed/ GEO
sudo zypper ar
http://download.opensuse.org/repositories/home:/tzotsos/openSUSE_Tumbleweed/ tzotsos

and then add the OTB packages as shown above.

MacPort

OTB Applications are now available on MacPorts. The port name is called ’orfeotoolbox’. You can follow the `MacPorts documentation < http://guide.macports.org/>`__ to install MacPorts first, then install the ’orfeotoolbox’ port. After the installation, you can used directly on your system, the OTB applications.