.. PyDDA documentation master file, created by
   sphinx-quickstart on Tue May 15 12:19:06 2018.
   You can adapt this file completely to your liking, but it should at least
   contain the root `toctree` directive.

Welcome to the PyDDA documentation!
===================================

.. image:: logo.png
    :width: 400px
    :align: center
    :height: 200px
    :alt: alternate text

.. image:: https://zenodo.org/badge/DOI/10.5281/zenodo.3939148.svg
   :target: https://doi.org/10.5281/zenodo.3939148

This is the main page for the documentation of PyDDA. Below are links that
provide documentation on the installation and use of PyDDA as well as 
description of each of PyDDA's subroutines.

=========================
System Requirements
=========================

This works on any modern version of Linux, Mac OS X, and Windows. For Windows,
HRRR data integration is not supported. In addition, since PyDDA takes advtange
of parallelism we recommend:
::
    An Intel machine with at least 4 cores
    8 GB RAM
    1 GB hard drive space
::

While PyDDA will work on less than this, you may run into performance issues.
In addition, we do not support Python versions less than 3.6. If you have an older version installed, PyDDA may work just fine but we will not provide support for any issues unless you are using at least Python 3.6.

=========================
Installation instructions
=========================

The GitHub repository for PyDDA is available at:

`<https://github.com/openradar/PyDDA>`_

Before you install PyDDA, ensure that the following dependencies are installed:
::

    Python 3.6+
    Py-ART 1.9.0+
    scipy 1.0.1+
    numpy 1.13.1+
    matplotlib 1.5.3+
    cartopy 0.16.0+
::

In order to use the HRRR data constraint, cfgrib needs to be installed. `cfgrib
<http://github.com/ecmwf/cfgrib>`_ currently only works on Mac OS and Linux, so
this is an optional dependency of PyDDA so that Windows users can still use PyDDA.
In order to install cfgrib, simply do:

.. _cfgrib: https://github.com/ecmwf/cfgrib

::

 pip install cfgrib
::

There are multiple ways to install PyDDA. The recommended way to install PyDDA is
through the use of the `Anaconda <http://anaconda.org>`_ package manager. If you
have anaconda installed simply type:
::

    conda install -c conda-forge pydda
::

This will install PyDDA and all of the required dependencies. You still need to
install `cfgrib <http://github.com/ecmwf/cfgrib>`_ if you wish to read HRRR data.
If you do not have anaconda, you can still install PyDDA using pip. Running this command
will install PyDDA and the required dependencies:
::

    pip install pydda
::


If you wish to contribute to PyDDA, you should install PyDDA from source. To do this,
just type in the following commands assuming you have the above dependencies installed.

::

 git clone https://github.com/openradar/PyDDA
 cd PyDDA
 python setup.py install
::
 
Contents:

.. toctree::
   :maxdepth: 3
    
   contributors_guide/index
   source/auto_examples/index
   dev_reference/index

Indices and tables
==================

* :ref:`genindex`
* :ref:`modindex`
* :ref:`search`

