############
Installation
############

Requirements
============

dew_gwdata relies on some specific Python packages to be installed in order to
work. You will need to have an Anaconda Python Distribution installed. I recommend
using "mambaforge" for this - see instruction for installing this on DEW computers
here:

file:///P:/projects_gw/State/Groundwater_Toolbox/Python/wheels/docs/dew_ws_tools/latest_source/installing_python.html

Installing dew_gwdata
========================

Once you have conda/mamba installed, you can run this in a command shell
such as Miniforge Prompt to install
dew_gwdata and all its dependencies:

.. code-block:: none

    conda install pandas greenlet oracledb orjson
    pip install dew_gwdata

(Substitute ``mamba`` for ``conda`` if you have mamba installed - if you don't know
what the difference is, just use the command above)

The ``conda install`` command installs some dependencies that have to have pre-built binary
versions installed, hence mamba/conda is needed in lieu of having a compiler
installed. If that makes no sense to you, don't worry about it.


Updating the dew_gwdata package
==================================

Uupdate from PyPI:

.. code-block:: none

    pip install -U dew_gwdata

The source code is stored on the DEW Water Science Bitbucket account at 
https://bitbucket.org/dewsurfacewater/dew_gwdata. You can request access to
this by emailing Claire.Sims@sa.gov.au with your Bitbucket username.
