Commit fed56eb2 authored by Julien Michel's avatar Julien Michel

DOC: Sync en guide with fr guide

parent 1849f8ba
......@@ -42,6 +42,27 @@ The data package for the training can be downloaded at \url{www.orfeo-toolbox.or
\subsection{QGIS}
Install QGIS: \url{http://www.qgis.org/en/site/forusers/download.html}.
\subsection{Python}
This dependency is required only if python module is part of your training. Download the 3.5.4 version available here : \url{https://www.python.org/ftp/python/3.5.4/python-3.5.4-amd64.exe}. It does not require root privileges.
Once isntalled, it is also required to install Numpy with pip.
If you are on a company network behind a proxy, configure it with the following command in a Windows prompt:
\begin{verbatim}
set HTTPS_PROXY=http://Domain\User:Passwd@proxy_address:port
\end{verbatim}
Then, in the same prompt, install Numpy with pip:
\begin{verbatim}
python.exe -m pip install numpy
\end{verbatim}
By default OTB python bindings are compatible with python 2.7. You need to edit the \verb?otbenv.bat? file to modify the line with \verb?PYTHONPATH?, by changing \verb?lib/python? to \verb?lib/python3?.
\subsection{Command line}
Install a minimal command line environment for Windows. For instance, Git for Windows is very easy to install:
\url{http://git-scm.com/download/win}.
......@@ -106,6 +127,16 @@ $\rightarrow$ "OTB-Applications browser".
\label{fig:windows-otbgui}
\end{figure}
To test python bindings:
\begin{enumerate}
\item Open a Windows prompt,
\item Exéecute configuration script \verb?otbenv.bat? to set the environment up
\item Run python interpreter
\item Enter the following instruction \verb?import otbApplication?. This must return without any error
\end{enumerate}
% En commentaire pour l'instant, c'est peut être un peu inutile puisqu'il n'y a
% aucune action associée en terme d'installation
\begin{comment}
......@@ -133,6 +164,15 @@ update the provider option in the QGIS processing properties.
This section explains how to install the tools in a Linux environment like Ubuntu. This procedure can also be used on other Linux distributions by using the appropriate package manager (dnf, yum,
emerge, pacman\ldots)
\subsection{Python}
This dependency is required only if python module is part of your training. Python can be installed though the package manager by installing the following packages: \textbf{python3} et \textbf{python3-numpy}.
\begin{verbatim}
sudo apt-get install python3 python3-numpy
\end{verbatim}
By default OTB python bindings are compatible with python 2.7. You need to edit the \verb?otb.profile? file to modify the line with \verb?PYTHONPATH?, by changing \verb?lib/python? to \verb?lib/python3?.
\subsection{QGIS}
QGIS can be installed via a command line like:
\begin{verbatim}
......@@ -186,6 +226,15 @@ $\rightarrow$ "OTB-Applications browser".
\item Run an application using the terminal, for instance
\texttt{otbgui\_Rescale}. (see figure \ref{fig:windows-otbgui}).
To test python bindings:
\end{enumerate}
\begin{enumerate}
\item Open a terminal
\item Source the configuration script \verb?otb.profile? : \verb?$ source otb.profile?
\item Run python interpreter (from same terminal)
\item Enter the following instruction \verb?import otbApplication?. It must return without any error
\end{enumerate}
\clearpage
......@@ -198,37 +247,4 @@ OTB-6.4.0-Darwin64.run from \url{https://www.orfeo-toolbox.org/download/}.
This is a self-extracting binary which extracts itself in the current directory. Testing the installation is done like in the Linux case.
\clearpage
\section{Python install for OTB}
Starting from OTB 5.8.0, OTB bindings for Python 2.7 are distributed with binary package. With OTB 6.4.0, additional bindings for Python 3.5 are also included. Please note that using a different Python version may not be compatible with OTB wrappings. If no compatible Python 2.x version is found a notification is generated during the installation process. If the installation completes without issue, information relating to your Python bindings will be provided.
You must have Python numpy bindings installed in your system. They can be installed locally without admin rights as follows: “pip install –user numpy”. This is to give users the option to select their own existing Python installation rather than the one dibstributed by the OTB package.
By default, bindings for Python 2.7 will be enabled with the otbenv script. If you want to use bindings for Python 3.5, you can copy this script and modify:
\begin{verbatim}
lib/python into lib/python3, for variable PYTHONPATH
\end{verbatim}
Notes:
\begin{enumerate}
\item You must use monteverdi and mapla through mapla.sh and monteverdi.sh helper scripts in extracted directory.
\item The helper scripts for monteverdi and mapla set required environment variables
\item You might be tempted to move “OTB-6.4.0-Linux64” into another location say /usr/local/ after extraction. But avoid this action!
\item To have “OTB-6.4.0-Linux64” installed in /usr/local or /opt execute “OTB-6.4.0-Linux64.run” in that directory.
\item Multiple installation of OTB can exists in same system without one conflicting the other!
\end{enumerate}
\subsection{Test}
In order to test the Python OTB dependencies, try:
\begin{enumerate}
\item Load the environment variables (Linux : sourcing the otb.profile; Windows: executing otbenv.bat)
\item Launch the python console (Linux: execute python ; Windows: python.exe)
\item Execute in the python console : import numpy
\item Execute in the python console : import otbApplication
\end{enumerate}
If no error message is printed after the import commands, everything is fine. If not, check the Python version (2.7 or 3.5), and the PATH,OTB_APPLICATION_PATH and PYTHONPATH variables.
\end{document}
Markdown is supported
0% or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment