Install Guide
=============

Register
--------

Nodeworks is an open-source multiphase flow solver and is free to download and
use. A one-time no-cost registration is required prior to downloading the
software. To register, go to https://mfix.netl.doe.gov/register and submit your
account information. Your application will be manually been reviewed and
accepted, so please allow for 2-3 business days for your registration to be
processed. You will receive a confirmation email when you can login.

OS Support
----------

Nodeworks is a pure python library. As a result, all operating systems that
python and the dependencies can be installed on will run nodeworks. Development
and testing is performed on the following operating systems:

- Linux
  - Ubuntu 16.04
- macOS (latest)
- Windows
  - Windows 7
  - Windows 10

Installation
------------

Using conda
+++++++++++

The easiest and recommended way to install nodeworks and the dependencies is
through the Anaconda Distribution. Download and install Miniconda_ or Anaconda_.

Once Miniconda_ or Anaconda_ are installed:

- Browse to the `Nodeworks Download Page`_
- Copy the conda install command. The conda command will look similar to this,
  but with your own individual username and hexadecimal token::

   conda install nodeworks -c https://usr:token@mfix.netl.doe.gov/dist

- Paste the conda install command into your Linux or Mac terminal, or into your
  Anaconda Prompt on Windows
- Execute the install command

The installation will download other dependencies and Nodeworks. The process
will take a few minutes to complete. Once completed, the application can be
started by using the following command::

  nodeworks

.. Note::
  This is a very similar to the MFiX instillation process. The only difference
  is that `mfix` is replaced with `nodeworks`. You can install both `mfix` and
  `nodeworks` at the same time with::

   conda install mfix nodeworks -c https://usr:token@mfix.netl.doe.gov/dist

From source
+++++++++++

If you already have a python environment setup without using Miniconda_ or
Anaconda_, nodeworks can be installed from source:

- Browse to the `Nodeworks Download Page`_
- Download the tarball, extract, and go into the top level source directory::

   tar xf nodeworks-*.tar.gz
   cd nodeworks

- install nodeworks with::

   python setup.py install

Please see the dependencies listed below. Once completed and the dependencies
are met, the application can be started by using the following command::

     nodeworks

.. Note::
  To build the local documentation, the following libraries are required:
  - sphinx
  - sphinx_rtd_theme

Required Dependencies
---------------------

If the `conda install` command was used as recommended above, these dependencies
have already been satisfied. If you installed from source or are missing nodes,
the following libraries are required:

- A Qt wrapper: PyQt4, PyQt5, or PySide
- qtpy

qtpy can easily be installed via::

  pip install qtpy

These requirements can be easily met by using Anaconda_.

Node Dependencies
-----------------

Nodes can have other dependencies, based on their functionality. These
dependencies are soft, meaning that they will not prevent nodeworks from,
loading. They will only prevent nodes that depend on these dependencies from
loading.

If using Miniconda_ or Anaconda_, these dependencies can be easily installed
with the following conda command::

  conda install <dependency>

optimization toolset
++++++++++++++++++++

For the optimization toolset, the following libraries are required:

- numpy
- matplotlib
- scikit-learn
- sympy
- scipy
- SALib

and can easily be installed with conda::

  conda install numpy matplotlib scikit-learn sympy scipy SALib

image processing
++++++++++++++++

For image processing nodes, these libraries are used:

- opencv
- scikit-image
- imageio
- numpy
- scipy

and can easily be installed with conda::

  conda install opencv scikit-image imageio numpy scipy

wavelets
++++++++

For wavelet analysis, the following library is used:

- pywavelets

and can easily be installed with conda::

  conda install pywavelets


Update
------

To update nodeworks, follow the above install instructions

Uninstall
---------

If installed with conda, uninstall by running the following command::

  conda uninstall nodeworks

If installed from source, uninstall by running::

  pip uninstall nodeworks



.. _Anaconda: http://continuum.io/downloads
.. _Miniconda: https://conda.io/miniconda.html
.. _`Nodeworks Download Page`: https://mfix.netl.doe.gov/mfix/download-nodeworks