README.md

Tools for the Daisy project

• Data conversion

  • hip - Tools for working with data from Hydrologisk Informations- og Prognosesystem.

• Data retrieval

  • dmi - Scripts for retrieving weather data from DMI.

Installation

Linux

These instructions assume you have a working python installation with pip.

1. Use your package manager to install

   • netcdf
   • udunits
   • git

   On debian use

    apt install libnetcdf19 libudunits2-0 git
   

2. (Optional) Create a virtual environment

    python -m venv ~/.venvs/daisy-tools
    source ~/.venvs/daisy-tools/bin/activate
   

3. Use pip to install daisy tools

    pip install git+https://github.com/daisy-model/tools.git@hip
   

OSX

These instructions assume you have a working python installation with pip.

1. Install homebrew. See https://brew.sh/

2. Use homebrew to install

   • netcdf. See https://formulae.brew.sh/formula/netcdf#default
   • udunits. See https://formulae.brew.sh/formula/udunits#default
   • git. See https://formulae.brew.sh/formula/git#default

   .

    brew install netcdf udunits git
   

3. (Optional) Create a virtual environment

    python -m venv ~/.venvs/daisy-tools
    source ~/.venvs/daisy-tools/bin/activate
   

4. Use pip to install daisy tools

    pip install git+https://github.com/daisy-model/tools.git@hip
   

Windows

1. Install Miniconda or Anaconda. Install Miniconda unless you want all the extra stuff in Anaconda.

2. Start the Miniconda/Anaconda Powershell prompt.

3. Download the conda environment file environment.yml and create a new environment from it using the following commands. This will install all dependencies.

    curl.exe -o daisy-tools-environment.yml https://raw.githubusercontent.com/daisy-model/tools/hip/environment.yml
    conda env create -f daisy-tools-environment.yml
    rm daisy-tools-environment.yml
    conda activate daisy-tools
   

4. Set the path to udunits2.xml and reactivate the environment

    conda env config vars set UDUNITS2_XML_PATH="$env:CONDA_PREFIX\Library\share\udunits\udunits2.xml"
    conda activate daisy-tools
   

5. Download and install daisy tools

    curl.exe -o daisy_tools.tar.gz -L https://github.com/daisy-model/tools/releases/latest/download/daisy_tools.tar.gz
    pip install daisy_tools.tar.gz
    rm daisy_tools.tar.gz
   

Usage

See the README in each tool directory.