finished documentation update

Author: davidclemenssewall

doc/source/developer_guide/dg_driver.rst

@@ -40,7 +40,7 @@ Overview
 
 The icepack driver exists to test the column physics.  At the present time, it is hardwired
 to run 4 different gridcells on one processor with the same forcing used for all gridcells.  
-There is no MPI and no threading built into the icepack driver.  There is limited IO capabilities,
-no history files, and no netcdf restart files.  The model generally runs very quickly.
+There is no MPI and no threading built into the icepack driver.  There is limited IO capabilities. 
+The model generally runs very quickly.
 
 Forcing data and details on these data are available in :ref:`force`.

doc/source/icepack_index.rst

@@ -357,6 +357,7 @@ section :ref:`tabnamelist`.
    "potT", "atmospheric potential temperature", "K"
    "PP_net", "total primary productivity per grid cell", "mg C/m\ :math:`^2`/s"
    "precip_units", ":math:`\bullet` liquid precipitation data units", ""
+   "precalc_forc", ":math:`\bullet` if true, average/interpolate forcing data on initialization", ""
    "print_points", ":math:`\bullet` if true, print point data", "F"
    "Pstar", "ice strength parameter", "2.75\ :math:`\times`\ 10\ :math:`^4`\ N/m\ :math:`^2`"
    "puny", "a small positive number", "1\ :math:`\times`\ 10\ :math:`^{-11}`" 

doc/source/user_guide/ug_case_settings.rst

@@ -371,6 +371,7 @@ forcing_nml
    "", "``ISPOL``", "ISPOL experiment data  (see :ref:`force`)", ""
    "", "``NICE``", "N-ICE experiment data  (see :ref:`force`)", ""
    "", "``SHEBA``", "Opening/closing dataset from SHEBA", ""
+   "``precalc_forc``", "logical", "average/interpolate forcing data on initialization", "``.false.``"
    "``precip_units``", "``mks``", "liquid precipitation data units", "``mks``"
    "", "``mm_per_month``", "", ""
    "", "``mm_per_sec``", "(same as MKS units)", ""

doc/source/user_guide/ug_running.rst

@@ -741,7 +741,24 @@ cases.  Current filenames can be found in the options scripts in
     Atmospheric and oceanic forcing are available from the 2019-2020 Multidisciplinary Drifting Observatory 
     for the Study of Arctic Climate (MOSAiC) expedition :cite:`Clemens-Sewall24`. The atmospheric forcing is
     available minutely and the oceanic forcing is available daily. These data are based on observations from
-    a collection of drifting ice floes in the Arctic Ocean. MOSAiC
+    a collection of drifting ice floes in the Arctic Ocean. MOSAiC consisted of two drift experiments, 
+    in which the R/V Polarstern was moored to a drifting ice floe and continuous observations were made. The
+    first drift started in October 2019 North of the Laptev Sea (85.4N, 129.2E) and ended in July 2020 in
+    the Fram Strait (79.2N, 2.6W). The second drift was from August to September, 2020 in the vicinity of
+    the North Pole (approximately 88.6N, 110.6E). 
+    
+    Atmospheric forcing fields from :cite:`Clemens-Sewall24` consist of 2-m air temperature (K), 2-m 
+    specific humidity (kg/kg), 2-m wind velocity in the u and v directions (m/s), downward solar radiation 
+    (:math:`W/m^2`), and downward longwave radiation (:math:`W/m^2`). For the first drift, snowfall rate
+    (:math:`kg/m^2/s`) is also available. Oceanic forcing fields consist of mixed layer salinity (PSU),
+    mixed layer depth (m), turbulent heat fluxes over the halocline and thermocline (:math:`W/m^2`),
+    mixed layer temperature (K), ocean-ice friction velocity (m/s), and sea ice drift speed (m/s). Note,
+    icepack's driver currently lacks a mechanism to use the ocean-ice friction velocity and/or sea ice
+    drift speed in the thermodynamics calculations. Additionally, caution should be used when using the
+    ocean mixed layer temperatures directly because for much of the experiment icepack's parameterization
+    of the ocean mixed layer freezing point differs from the true freezing point by ~0.5 C.
+    
+    MOSAiC data are available exclusively as MDF-formatted netCDF files (see :ref:`init`).