From f93684438a742fa2de3bdfd9f200dca67ec561b4 Mon Sep 17 00:00:00 2001
From: Christopher Yeh <chrisyeh96@users.noreply.github.com>
Date: Tue, 28 Jun 2022 07:33:37 +0000
Subject: [PATCH] Update README with publication info

---
 README.md | 45 +++++++++++++++++++++++++++++++++++++++------
 1 file changed, 39 insertions(+), 6 deletions(-)

diff --git a/README.md b/README.md
index a2a3668..7421e7c 100644
--- a/README.md
+++ b/README.md
@@ -1,11 +1,20 @@
-## Data Files (in /data)
+[**Paper**](https://dl.acm.org/doi/10.1145/3538637.3538853) |
+[**Video**](https://youtu.be/iDhDfDrXqoA)
+
+# Robust Online Voltage Control with an Unknown Grid Topology
+
+[Christopher Yeh](https://chrisyeh96.github.io/), [Jing Yu](https://scholar.google.com/citations?user=akiDVE8AAAAJ&hl=en), [Yuanyuan Shi](https://yyshi.eng.ucsd.edu/), [Adam Wierman](https://adamwierman.com/)
+
+**California Institute of Technology and UC San Diego**
+
+
+## Data Files (in `/data`)
 
 **PV.mat**
 - contains single key `'actual_PV_profile'`
 - float64 array, shape [14421]
 - min: 0.0, max: ~13.4
-- units: TODO
-- TODO: sign
+- units: MW
 - description: solar generation, measured every 6 seconds
 
 **aggr_p.mat**
@@ -13,14 +22,14 @@
 - float64 array, shape [14421]
 - min: ~2.4, max: ~7.1
 - units: MW
-- description: active power injection, measured every 6 seconds for 24h, TODO
+- description: active power injection, measured every 6 seconds for 24h
 
 **aggr_q.mat**
 - contains single key `'q'`
 - float64 array, shape [14421]
 - min: ~1.1, max: ~3.1
 - units: MVar
-- description: reactive power injection, measured every 6 seconds for 24h, TODO
+- description: reactive power injection, measured every 6 seconds for 24h
 
 **pq_fluc.mat**
 - contains single key `'pq_fluc'`
@@ -33,7 +42,6 @@
 
 **SCE_56bus.mat**
 - contains single key `'case_mpc'`
-- units: TODO
 - description: a "MATPOWER" file. See the convert2matpower.m file for description.
 - mat['case_mpc'][0,0] has 4 "keys"
     - 'version': shape [1], type uint8
@@ -41,3 +49,28 @@
     - 'bus': shape [56, 13], type float64
     - 'branch': shape [55, 13], type float64
     - 'gen': shape [1, 21], type int16
+
+See the attachment attached to [releases](https://github.com/chrisyeh96/voltctrl/releases) for Python `.pkl` files containing the results of running the various algorithms. These Pickle files are read by the various Jupyter notebooks for plotting and analysis.
+
+
+## Citation
+
+Please cite this article as follows, or use the BibTeX entry below.
+
+> C. Yeh, J. Yu, Y. Shi, and A. Wierman, "Robust online voltage control with an unknown grid topology," in _e-Energy '22: Proceedings of the Thirteenth ACM International Conference on Future Energy Systems_, Association for Computing Machinery, Jun. 2022, pp. 240–250, ISBN: 9781450393973. DOI: 10.1145/3538637.3538853. [Online]. Available: [https://dl.acm.org/doi/10.1145/3538637.3538853](https://dl.acm.org/doi/10.1145/3538637.3538853).
+
+```tex
+@inproceedings{
+    yeh2022robust,
+    author = {Christopher Yeh and Jing Yu and Yuanyuan Shi and Adam Wierman},
+    booktitle = {{e-Energy 22': Proceedings of the Thirteenth ACM International Conference on Future Energy Systems}},
+    doi = {10.1145/3538637.3538853},
+    isbn = {9781450393973},
+    month = {6},
+    pages = {240-250},
+    publisher = {Association for Computing Machinery},
+    title = {Robust online voltage control with an unknown grid topology},
+    url = {https://dl.acm.org/doi/10.1145/3538637.3538853},
+    year = {2022}
+}
+```