diff --git a/README.md b/README.md
new file mode 100644
index 0000000..557dd9b
--- /dev/null
+++ b/README.md
@@ -0,0 +1,38 @@
+# PNRESD
+
+This repository contains the Data for Van Zalinge et al. (2017), On determining the point of no return in climate change, Earth System Dynamics.
+
+----------------------------------
+
+The repository contains the subdirectories DATA and FIGURES.
+
+----------------------------------
+
+## FIGURES:
+contains python scripts to generate Figures 5,6 and 7 of the paper. Where required, it used the data contained in DATA. The paper's remaining results can be generated based on the information given in the paper.
+
+----------------------------------
+
+## DATA:
+-------------------
+-Carbon_Response: The 100 GtC emission pulse to a present-day world (Joos et al., 2013), as found on http://climatehomes.unibe.ch/~joos/IRF_Intercomparison/results.html
+
+Reference: Joos, F., Roth, R., Fuglestvedt, J. S., Peters, G. P., Enting, I. G., von Bloh, W., Brovkin, V., Burke, E. J., Eby, M., Edwards, N. R., Friedrich, T., Frölicher, T. L., Halloran, P. R., Holden, P. B., Jones, C., Kleinen, T., Mackenzie, F. T., Matsumoto, K., Meinshausen, M., Plattner, G.-K., Reisinger, A., Segschneider, J., Shaffer, G., Steinacher, M., Strassmann, K., Tanaka, K., Timmermann, A., and Weaver, A. J.: Carbon dioxide and climate impulse response functions for the computation of greenhouse gas metrics: a multi-model analysis, Atmos. Chem. Phys., 13, 2793-2825, doi:10.5194/acp-13-2793-2013, 2013
+
+-------------------
+-PlaSim_Ensembles: Model results for running PlaSim for abrupt CO2 doubling and smooth CO2 increase at a rate of 1% per year.
+Data gives a 200-year GMST annual mean timeseries for a 201 member ensemble, starting at pre-industrial conditions.
+The data is courtesy of F. Lunkeit and V. Lucarini (University of Hamburg, Germany).
+
+For the PlaSim model consult:
+https://www.mi.uni-hamburg.de/en/arbeitsgruppen/
+theoretische-meteorologie/modelle/plasim.html
+
+Reference: Fraedrich, K., Jansen, H., Kirk, E., Luksch, U., and Lunkeit, F.: The
+Planet Simulator: Towards a user friendly model, Meteorol. Z.,
+14, 299–304, 2005.
+
+-------------------
+-RCP_Data: CO2 concentrations and emissions from the RCP database (see http://www.pik-potsdam.de/~mmalte/rcps/)
+
+Reference: Meinshausen, M., S. J. Smith, K. V. Calvin, J. S. Daniel, M. L. T. Kainuma, J.-F. Lamarque, K. Matsumoto, S. A. Montzka, S. C. B. Raper, K. Riahi, A. M. Thomson, G. J. M. Velders and D. van Vuuren (2011). "The RCP Greenhouse Gas Concentrations and their Extension from 1765 to 2300." Climatic Change (Special Issue), DOI: 10.1007/s10584-011-0156-z, freely available online (PDF) (HTML)