From a4e4b3fb59f62b44041e1ead1fcd01924716bafe Mon Sep 17 00:00:00 2001
From: Stephen <slee290@gmail.com>
Date: Wed, 27 Mar 2024 02:54:49 -0400
Subject: [PATCH] providing basic readme context

---
 README.md | 32 ++++++++++++++++++++++++++++++--
 1 file changed, 30 insertions(+), 2 deletions(-)

diff --git a/README.md b/README.md
index ed2f4f0..4b1db52 100644
--- a/README.md
+++ b/README.md
@@ -1,3 +1,31 @@
-# beacon
+# The BEACON model
 
-More documentation will be available very soon.
+##### Note, March 27, 2024: More documentation will be available very soon.
+
+
+This repo contains open source code for the BEACON electricity access estimation model, as which generated the access layers visible on the Open Energy Maps™ (OEMaps) (https://www.openenergymaps.org/) platform. 
+
+Please refer to Open Energy Maps™ (OEMaps)'s [documentation](https://openenergymaps.org/docs/OEMaps_Documentation_20240326.pdf) for more information.
+
+
+# Citing this work
+
+We are still working on our academic paper. In the meantime, please refer to and cite this PhD thesis:
+
+~~~~
+Lee, S.J. Multimodal Data Fusion for Estimating Electricity Access and Demand (Doctoral Thesis). Massachusetts Institute of Technology, 2023. Retrieved from https://stephenjl.com/pdf/sjl-phd-thesis-final_20230831.pdf
+~~~~
+
+Bibtex:
+
+~~~~
+@phdthesis{lee2023multimodal,
+  title={Multimodal Data Fusion for Estimating Electricity Access and Demand},
+  author={Lee, Stephen J},
+  year={2023},
+  school={Massachusetts Institute of Technology}
+~~~~
+
+# Sponsors and Collaborators
+
+Please refer to Open Energy Maps™ (OEMaps)'s [documentation](https://openenergymaps.org/docs/OEMaps_Documentation_20240326.pdf) for a list of sponsors and collaborators.