.. _download:

Download and Installation
=========================

**Download source code for nobotouls**
:download:`here<./download/nobotouls.zip>`.

----------------------------------------------------

**Necessary python environment**

0. :program:`Python 2.7`:
   https://www.python.org/download/releases/2.7/

1. Python :program:`Setup-Tools`:
   https://pypi.python.org/pypi/setuptools

2. :program:`Numpy`: http://www.numpy.org/

3. :program:`Matplotlib`: http://matplotlib.org/

4. :program:`Scipy`: http://www.scipy.org/

5. :program:`Matplotlib-Basemap`: http://matplotlib.org/basemap

6. For Digital Elevation Data manipulation:

   * http://gdal.org/python/

   * https://pcjericks.github.io/py-gdalogr-cookbook/

7. For movie production the *external program* :program:`mencoder`
   (the base program for the graphical frontend :program:`mplayer`):

   http://mplayerhq.hu/design7/news.html

For Linux users all this can simply be downloaded by the package
manager for the Linux-distribution, e.g. for :program:`Ubuntu 14.04`:

::

    sudo apt-get install python2.7 python-setuptools matplotlob python-mpltoolkits.basemap python-gdal mencoder

.. warning::

   *Windows users* are strongly recommended to *change to Linux*!


Linux
-----

1. Download source code :download:`nobotouls for Linux
   here. <./download/nobotouls.zip>`

2. Download :download:`test data here. <./download/data.zip>`

3. Unzip testdata and program package in any directory

::

   gunzip nobotouls.zip

4. Enter directory :file:`nobotouls-<version>`, install with root
   previlegies and with working internet connection (most dependencies
   should be automatically resolved via setup-tools and pip).

   ::
   
       cd nobotouls-<version>
       sudo python2 setup.py install

   If you want to edit the source could, than install like this:

   ::

       sudo python2 setup.py develop

   Any change in the source code is then available throughout the platform.



5. Run somewhere from the shell

::

   <programm.py> <arguments>


Windows
-------

Only a simple extraction in a directory works, because standard
installation like in Linux does not work yet.

0. Install the :program:`python 2.7` development environment
   :program:`Anaconda`, `see here for information
   <https://www.continuum.io/why-anaconda>`_, and `download here
   <https://www.continuum.io/downloads>`_.

1. Download source code :download:`nobotouls for Windows
   here. <./download/nobotouls.zip>`

2. Download
   :download:`test data here. <./download/data.zip>`

3. Unizip evrything in any folder

4. 

   .. note::

       Copy the directory :file:`config` to your home directory and name
       it :file:`.nobotouls/`

4. Run a command with a command line tool from within tha source
   directory :file:`src`:

   ::

       python.exe <programm.py> <arguments>

5. Carefully watch the error messages and try to resolve the
   dependencies :-(

---------------------------------------------------------------------


**Linux and Windows**

Templates of the :file:`sqlite-database` and the
:file:`input-parameter file` are in the subfolder :file:`./config` or
in the configuration directory :file:`~/.nobotouls`.