Installing Client Programs
==========================

The radar can be controlled without installing anything on your computer.
However, in order to save the data (which is important, of course!) you must
install software on your computer for viewing and saving the data.  The process
is different for Windows, Mac, and Linux.  Some of the Python dependencies



Windows
-------

- Install Nanomsg binaries:

  - `Python 3.5-32 <https://arrc.ou.edu/~cody/packages/nanomsg-1.0-cp35-cp35m-win32.whl>`_
  - `Python 3.5-64 <https://arrc.ou.edu/~cody/packages/nanomsg-1.0-cp35-cp35m-win_amd64.whl>`_
  - `Python 3.6-32 <https://arrc.ou.edu/~cody/packages/nanomsg-1.0-cp36-cp36m-win32.whl>`_
  - `Python 3.6-64 <https://arrc.ou.edu/~cody/packages/nanomsg-1.0-cp36-cp36m-win_amd64.whl>`_

From `Christoph Gohlke's Website <https://www.lfd.uci.edu/~gohlke/pythonlibs/>`_,
install the following packages, for the version of Python you have installed:

- numpy
- scipy
- cartopy
- shapely

Everything else can be installed via pip.  In the software directory of the wni
repository, run ``pip install -e '.[client]'``  Make sure this is the pip assoicated with
the correct version of Python.

Mac
---

The radar software can be installed on Mac using `HomeBrew <https://brew.sh/>`_

Assuming HomeBrew is installed and configured correctly, the following should
install everything correctly:

.. code-block:: bash

    brew install python
    brew install jupyter
    brew install geos
    brew install proj
    brew install nanomsg
    python3 -m pip install pillow
    python3 -m pip install matplotlib
    python3 -m pip install scipy
    ln -s /usr/local/lib/libnanomsg.dylib /usr/local/lib/libnanomsg.so

Special care has to be taken to install the Python bindings for nanomsg; it
needs to be installed from source, because some features have not been released
to PyPI yet.

.. code-block:: bash

   cd ~
   git clone https://github.com/tonysimpson/nanomsg-python.git
   cd nanomsg-python
   git checkout 9417ffc03742af404d7f093da26a5a539d3c395a # version in master is broken
   python3 -m pip install .

Finally, navigate to the ``sw`` directory inside the WNI repository, and
install it:

.. code-block:: bash

   python3 -m pip install -e '.[client]'

Linux
-----

TODO