OTB Development Team
OTB provides:
Many of these functionalities are provided by ITK and have been tested and documented for the use with remote sensing data.
The PLEIADES optic component is composed of two "small satellites" (mass of one ton) offering a spatial resolution at nadir of 0.7 m and a field of view of 20 km. Their great agility enables a daily access all over the world, essentially for defense and civil security applications, and a coverage capacity necessary for the cartography kind of applications at scales better than those accessible to SPOT family satellites. Moreover, PLEIADES will have stereoscopic acquisition capacity to meet the fine cartography needs, notably in urban regions, and to bring more information when used with aerial photography.
The ORFEO "targeted" acquisition capacities made it a system particularly adapted to defense or civil security missions, as well as critical geophysical phenomena survey such as volcanic eruptions, which require a priority use of the system resources.
With respect to the constraints of the franco-italian agreement, cooperations have been set up for the PLEIADES optical component with Sweden, Belgium, Spain and Austria.
The creation of a preparatory program is needed because of :
This program was initiated by CNES mid-2003 and will last until 2009. It consists in two parts, between which it is necessary to keep a strong interaction:
This Accompaniment Program uses simulated data (acquired during airborne campaigns) and satellite images quite similar to Pleiades (as QuickBird and Ikonos), used in a communal way on a set of special sites. The validation of specified products and services will be realized with those simulated data
Apart from the initial cooperation with Italy, the ORFEO Accompaniment Program enlarged to Belgium, with integration of Belgian experts in the different WG as well as a participation to the methodological part.
Support for the following platforms is planned:
We assume that you will install everything on a directory called INSTALL_DIR, which usually is /usr/local, /home/jordi/local or whatever you want. Make sure that you have downloaded the source code for:
Important note: on some Linux distributions (eg. Debian, Ubuntu, Fedora), you may use the official packages for CMake, GDAL and Fltk. Once you have installed these packages, you can skip to step 4.
cd INSTALL_DIR gunzip gdal.1.4.2.tar.gz tar xvf gdal.1.4.2.tar cd gdal.1.4.2 ./configure --prefix=INSTALL_DIR make make install
It seems to be a bug in the GDAL install procedure: if you are installing it without root privileges, even if your INSTALL_DIR is a directory for which you have the write permissions, GDAL tries to copy the python bindings together with the Python site packages, which are usually somewhere in /usr/lib.
Actually, since this is the last step in the GDAL install procedure, when you get the error message, the GDAL libs and header files are already installed, so you can safely ignore the error.
The -without-python option passed to the configure step avoids this. However, some users may want to have Python bindings, so recommending this option for the install may not be OK for everybody.
cd INSTALL_DIR gunzip cmake-2.4.7.tar.gz tar xvf cmake-2.4.7.tar cd cmake-2.4.7 ./configure --prefix=INSTALL_DIR make make installIn order to properly use cmake, add INSTALL_DIR/bin to your path with export PATH=$PATH:INSTALL_DIR/bin or something similar.
cd INSTALL_DIR bunzip2 fltk-1.1.7-source.tar.bz2 OR gunzip fltk-1.1.7-source.tar.gz tar xvf fltk-1.1.7-source.tar mkdir Fltk-binary cd Fltk-binary ccmake ../fltk-1.1.7 --> follow the CMake instructions, in particular: --> set CMAKE_INSTALL_PREFIX to INSTALL_DIR within CMake --> set BUILD_EXAMPLES to ON within CMake --> generate the configuration with 'g' make make install --> check that the examples located in INSTALL_DIR/Fltk-binary/bin work, in particular, the fractals example which makes use of the OpenGL library needed by OTB.
You can choose not to install Fltk but in this case, you will not be able to compile the visualization features of OTB.
cd INSTALL_DIR gunzip OrfeoToolbox-2.0.0.tgz tar xvf OrfeoToolbox-2.0.0.tar mkdir OTB-Binary cd OTB-Binary ccmake ../OrfeoToolbox-2.0.0 --> follow the CMake instructions, in particular: --> set BUILD_EXAMPLES to ON within CMake --> set BUILD_SHARED_LIBS to ON within CMake --> set BUILD_TESTING to OFF within CMake --> set CMAKE_INSTALL_PREFIX to INSTALL_DIR within CMake --> set GDAL_INCLUDE_DIRS to INSTALL_DIR/include within CMake --> set GDAL_LIBRARY_DIRS to INSTALL_DIR/lib within CMake --> set OTB_USE_EXTERNAL_ITK to OFF within CMake --> set FLTK_DIR to INSTALL_DIR/Fltk-Binary within CMake OR if you do not have FLTK press 't' to change to advanced mode and set OTB_USE_VISU to OFF --> generate the configuration with 'g' make
If you want a faster compilation and don't want the compilation of the examples, you can set BUILD_EXAMPLES to OFF. Some plateforms apparently have more difficulties with shared libraries, if you experience any problem with that, you can set BUILD_SHARED_LIBS to OFF but the built size might reach 1 GB.
After these steps, you have the source of OTB in INSTALL_DIR/OrfeoToolbox-2.0.0 and the compiled binaries and libraries in INSTALL_DIR/OTB-Binary. Keeping the sources is important as most programs you will designed will need an access to the txx files during compilation. However, the binaries directory knows were its sources are and you will need to point only to the INSTALL_DIR/OTB-Binary when the cmake for your program will ask you where the OTB is.
If you want to put OTB in a standard location, you can proceed with:
make install
but this is only optional.
MSVC++ 7.1 project files are needed to compile GDAL.
These files can be downloaded at http://vterrain.org/dist/gdal132_vc71.zip.
Then, unzip it to your GDAL folder, and it will create a folder (named "VisualStudio").
Load the solution (.sln file) and build the gdal project.
More details can be found at http://vterrain.org/Distrib/gdal.html.
Use CMake on Windows to generate MSVC++ 7.1 project files from fltk sources.
Open the solution and build the fltk project.
Use CMake on Windows to generate MSVC++ 7.1 project files from otb sources.
Open the solution and build the otb project.
Open a MS-DOS prompt.
Run the VCVARS32.bat script that comes with the compiler (it can be found in Microsoft Visual Studio 8/VC/bin).
Then, go to the GDAL root directory, and tape :
nmake /f makefile.vc
Once the build is successful, tape this line to install GDAL :
nmake /f makefile.vc install
More details about this install can be found at http://www.gdal.org/gdal_building.html.
Use CMake on Windows to generate MSVC++ 8.0 project files from fltk sources.
Open the solution and build the fltk project.
Use CMake on Windows to generate MSVC++ 8.0 project files from otb sources.
Open the solution and build the otb project.
Then, launch MinGW : a prompt appears (similar to Linux one).
To compile GDAL, at configure step, use these options :
./configure -prefix=INSTALL_DIR --host=mingw32 --without-libtool --without-python --with-png=internal --with-libtiff=internal --with-jpeg=internalThen the usual make and make install.
Generate MSYS Makefiles with CMake (Windows version) from fltk sources.
Then, under prompt, tape make and make install where you have generated Makefiles with CMake.
Similar to fltk install.
To compile GDAL, at configure step, use these options :
./configure --prefix=INSTALL_DIR --with-png=internal --with-libtiff=internal --with-jpeg=internalThen the usual make and make install.
See Linux part for details (same procedure).
See Linux part for details (same procedure).
That should be all! Otherwise, subscribe to otb-users@googlegroups.com and you will get some help.
See http://www.gnu.org/software/tar/manual/tar.html#Checksumming for details on the bug characterization.
The solution is to use the GNU tar command if it is available on your system (gtar).
Put OTB_USE_VISU to OFF to avoid these problems.
Some bugs can appear while compiling GDAL with JPEG2000 files : disable this format to solve the problem.
This problem can be solved by downloading GDAL binaries for Windows at http://vterrain.org/Distrib/gdal.html.
OTB presents a large set of features and it is not always easy to start using it. After the installation, you can proceed to the tutorials (in the Software Guide). This should give you a quick overview of the possibilities of OTB and will teach you how to build your own programs.
The maximum physical space a user can allocate depends on her platform. Therefore, image allocation in OTB is restricted by image dimension, size, pixel type and number of bands.
Fortunately, thanks to the streaming mechanism implemented within OTB's pipeline (actually ITK's), this limitation can be bypassed. The use of the otb::StreamingImageFileWriter at the end of the pipeline, or the itk::StreamingImageFilter at any point of the pipeline will seamlessly break the large, problematic data into small pieces whose allocation is possible. These pieces are processed one afther the other, so that there is not allocation problem anymore. We are often working with images of pixels.
For the streaming to work, all the filters in the pipeline must be streaming capable (this is the case for most of the filters in OTB). The output image format also need to be streamable (not PNG or JPEG, but TIFF or ENVI, for instance).
To tune the size of the streaming pieces, the OTB has two CMake variables. The first is named OTB_STREAM_IMAGE_SIZE_TO_ACTIVATE_STREAMING. It represents the minimum size of the image in bytes for which streaming may be helpful. The second, OTB_STREAM_MAX_SIZE_BUFFER_FOR_STREAMING, specifies the maximum size in bytes a streaming piece should have. It can be used to compute the optimal number of pieces to break the input data into.
These two parameters have been used in the OTB-Applications/Utils/ applications. Take this as an example of how they can be used. They can also be tuned by the user to match her specific needs.
First, you can send an email to otb@cnes.fr to let us know what functionality you would like to introduce in OTB. If the functionality seems important for the OTB users, we will then discuss on how to send your code, make the necessary adaptions, check with you that the results are correct and finally include it in the next release.
Besides the satisfaction of contributing to an open source project, we will include the references to relevant papers in the software guide. Having algorithms published in the form of reproducible research helps science move faster and encourages people who needs your algorithms to use them.
You will also benefit from the strengths of OTB: multiplatform, streaming and threading, etc.
All functionalities which are useful for remote sensing data are of interest. As OTB is a library, it should be generic algorithms: change, detection, fusion, object detection, segmentation, interpolation, etc.
More specific applications can be contributed to the OTB-Applications package.
The first version was 1.0.0 in July 2006. Version 1.2.0, 1.4.0 and 1.6.0 were released in between and the current one 2.0.0 was released in December 2007. The next one will probably be 2.2.0.
Nevertheless, the main milestones for the OTB development are the following: