Update README.md

README.md

@@ -1,3 +1,27 @@
----
-license: apache-2.0
----
+---
+license: apache-2.0
+---
+# ACE-climSST-EAMv2
+
+Ai2 Climate Emulator (ACE) is a family of models designed to simulate atmospheric variability from the time scale of days to centuries.
+
+**Disclaimer: ACE models are research tools and should not be used for operational climate predictions.**
+
+ACE-climSST-EAMv2 is the model described in [Application of the AI2 Climate Emulator to E3SMv2's Global Atmosphere Model, With a Focus on Precipitation Fidelity](https://agupubs.onlinelibrary.wiley.com/doi/full/10.1029/2024JH000136).
+It is trained on output from the E3SMv2's atmosphere model (a.k.a. EAMv2) forced with annually-repeating climatological sea surface temperature.
+
+Code for doing inference with ACE models can be found here: [https://github.com/ai2cm/ace](https://github.com/ai2cm/ace)
+with corresponding documentation here: [https://ai2-climate-emulator.readthedocs.io/en/stable/](https://ai2-climate-emulator.readthedocs.io/en/stable/).
+
+Briefly, the strengths of ACE-climSST-EAMv2 are:
+- long-term stability
+- highly accurate time-mean climate compared to its target dataset
+- faithful emulation of the precipitation PDF and tropical variability in EAMv2
+
+Some known weaknesses are:
+- responses to El Niño-like sea surface temperature and long-term warming trends are not accurately captured
+- small but non-zero drifts in total dry air mass of the atmosphere
+
+Refer to [published manuscript](https://agupubs.onlinelibrary.wiley.com/doi/full/10.1029/2024JH000136) for more details.
+
+Note the checkpoint provided here is the same as the one [here](https://portal.nersc.gov/archive/home/projects/e3sm/www/e3smv2-fme-dataset), just with the optimizer state removed to decrease the checkpoint size.