diff --git a/README.md b/README.md
index 558e7d2e664196614461f817b5355992e42840cf..03a34017fea2d117b36b650daeaefe327db3c40f 100644
--- a/README.md
+++ b/README.md
@@ -1,4 +1,24 @@
-# disaggregation
+# Disaggregation algorithm
 
-Source code for disaggregation.
-For the web app implementation, please check the "webapp" branch.
+This disaggregation algorithm enables the coupling of two tools:
+
+- KomMod, an energy optimization tool developed at Fraunhofer ISE;
+- SimStadt, an urban energy simulation platform developed at the Stuttgart University of Applied Sciences.
+
+The combination of these tools results in a framework that allows the study of optimal solutions for the provision of heat to buildings in both urban and rural regions.
+
+For further technical details please refer to this journal article:
+Steingrube, A.; Bao, K.; Wieland, S.; Lalama, A.; Kabiro, P.M.; Coors, V.; Schröter, B. A Method for Optimizing and Spatially Distributing Heating Systems by Coupling an Urban Energy Simulation Platform and an Energy System Model. _Resources_ 2021, 10, 52. https://doi.org/10.3390/resources10050052
+
+## Prerequisites
+
+- Street segments created using [this](https://transfer.hft-stuttgart.de/gitlab/ensource-2/street-segmentation) tool
+
+## Example usage
+
+- Generate disaggregated grid using all of the street segments in the provided street segment file:
+  - `python disaggregation_lookahead.py -s input_segments/rainau_stat_lines_with_industry.csv`
+
+---
+
+For the web app implementation, please check the `webapp` branch.