From d474bfec5172bb37e1c7675174d0664ea0acba79 Mon Sep 17 00:00:00 2001
From: MatteusDeloge <matteus.deloge@craftworkz.be>
Date: Mon, 6 Nov 2017 20:28:25 +0100
Subject: [PATCH] Added fully working installation instructions based on user
 feedback from OpenGrid meeting 06/11/2017

---
 README.md | 56 +++++++++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 56 insertions(+)

diff --git a/README.md b/README.md
index 4c18aa4..c368405 100644
--- a/README.md
+++ b/README.md
@@ -8,3 +8,59 @@ Open-source algorithms for data-driven building analysis and control
 
 License: Apache 2.0
 
+# Installation
+## Basic setup
+For the OpenGrid code to run and to enable setup you need a working installation
+of Python 3.5 (or above) and git.
+
+You can check your Python 3.* installation by running `python3 --version` in the terminal. Git can be easily installed on most  Unix based systems by running `sudo apt-get install git-all` in the terminal.
+
+Change your working directory to a clear location where you want to clone the opengrid library to. Then clone the repository and `cd` into it.
+```
+git clone https://github.com/opengridcc/opengrid.git
+cd opengrid
+```
+(optional) set your local git username by running `git config user.name "git-username"`
+
+## Dependencies
+To be able to install all dependencies make sure you have pip3 installed. If not run `sudo apt-get install python3-pip`
+
+Most of the dependencies for OpenGrid are contained in the requirements.txt file that can be found in the root directory of the cloned repository. Installing all these dependencies (and additional dependencies) can be done with the following commands:
+```
+sudo -H pip3 install -r requirements.txt
+sudo apt-get update && sudo apt-get -y install \
+   python3 \
+   python3-dev \
+   python3-setuptools \
+   python3-pip \
+   build-essential \
+   libssl-dev \
+   libffi-dev \
+   python3-numpy \
+   python3-scipy \
+   python3-matplotlib \
+   python3-pandas
+sudo -H pip3 install jupyter
+```
+The last step now is to set your PYTHONPATH to the recently clone `opengrid` repository:
+```
+export PYTHONPATH=$PYTHONPATH:"path to chosen directory"/opengrid
+```
+This directory must be the root folder we just cloned.
+
+## Testing your setup
+To test if everything is setup correctly you can execute te test script:
+```
+// when in the root opengrid directory
+cd opengrid/tests
+python3 test_analyses.py
+```
+If the terminal prints out something like:
+```
+.
+----------------------------------------------------------------------
+Ran 1 test in 0.017s
+
+OK
+```
+Then your setup is OK! Welcome to the OpenGrid development team.