From 11e4d332b45f055a70671bd2284585b21c82324f Mon Sep 17 00:00:00 2001
From: imreddyTeja <treddy0205@gmail.com>
Date: Thu, 27 Feb 2025 18:27:17 -0800
Subject: [PATCH] Update Interfacer.md with atmos get_field changes

---
 docs/src/interfacer.md | 27 ++++++++++++++++++++++++++-
 1 file changed, 26 insertions(+), 1 deletion(-)

diff --git a/docs/src/interfacer.md b/docs/src/interfacer.md
index 02ba61c439..e380db7727 100644
--- a/docs/src/interfacer.md
+++ b/docs/src/interfacer.md
@@ -105,7 +105,7 @@ following properties:
 
 | Coupler name      | Description | Units |
 |-------------------|-------------|-------|
-| `co2`              | global mean co2 | ppm |
+| `emissivity`   | surface emissivity | |
 | `surface_direct_albedo`   | bulk direct surface albedo over the whole surface space | |
 | `surface_diffuse_albedo`   | bulk diffuse surface albedo over the whole surface space | |
 | `surface_temperature` | temperature over the combined surface space | K |
@@ -115,6 +115,31 @@ following properties:
 A function to return the air density of the atmosphere simulation
 extrapolated to the surface, with units of [kg m^-3].
 
+### AtmosModelSimulation - required functions to run with ClimaLandSimulation
+
+Coupling with full `ClimaLand` model requires the following functions, in addition
+to the functions required for coupling with a general `SurfaceModelSimulation`.
+
+- `get_field(::AtmosModelSimulation. ::Val{property}):
+
+This getter function must be extended
+for the following properties:
+
+| Coupler name      | Description | Units |
+|-------------------|-------------|-------|
+| `air_pressure`     | boundary air pressure | Pa |
+| `air_temperature`  | boundary air temperature | K |
+| `cos_zenith_angle` | cosine of the zenith angle | |
+| `co2`              | global mean co2 | ppm |
+| `diffuse_fraction` | fraction of downwards shortwave flux that is direct | |
+| `humidity`         | boundary humidity | kg kg^-1 |
+| `LW_d`             | downwards longwave flux | W m^-2 |
+| `SW_d`             | downwards shortwave flux | W m^-2 |
+
+Note that `air_temperature`, `air_pressure`, `cos_zenith_angle`, `co2`, `diffuse_fraction`, `LW_d` and
+`SW_d` will not be present in a `ClimaAtmosSimulation` if the model is setup no radiation.
+Because of this, a `ClimaAtmosSimulation` must have radiation if running with the full `ClimaLand` model.
+
 ### SurfaceModelSimulation - required functions
 Analogously to the `AtmosModelSimulation`, a `SurfaceModelSimulation`
 requires additional functions to those required for a general `ComponentModelSimulation`.