diff --git a/README.md b/README.md
index 693b874..0cbe516 100644
--- a/README.md
+++ b/README.md
@@ -1,2 +1,16 @@
 # iris
 Imperial College Storm Model
+
+This is IRIS (v0.1), the Imperial College Storm Model. For a detailed description and analysis, see Sparks & Toumi (2024). The 10,000 year global synthetic dataset described there is available here.
+
+The data (rundata/) and code (run/) needed for IRIS are all here. 
+
+    run/run_iris.py 
+
+is set up to produce the sample 100 year global output which is included in numpy format here:
+
+    out/
+
+and in text format here:
+
+    out_txt/
\ No newline at end of file