From 8ceed76cb594923fe06c491c97d107ea7171232e Mon Sep 17 00:00:00 2001 From: David Clemens-Sewall Date: Mon, 11 Nov 2024 15:06:26 -0700 Subject: [PATCH] finished documentation update --- doc/source/developer_guide/dg_driver.rst | 4 ++-- doc/source/icepack_index.rst | 1 + doc/source/user_guide/ug_case_settings.rst | 1 + doc/source/user_guide/ug_running.rst | 19 ++++++++++++++++++- 4 files changed, 22 insertions(+), 3 deletions(-) diff --git a/doc/source/developer_guide/dg_driver.rst b/doc/source/developer_guide/dg_driver.rst index b8389b90f..14dae9d97 100755 --- a/doc/source/developer_guide/dg_driver.rst +++ b/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`. diff --git a/doc/source/icepack_index.rst b/doc/source/icepack_index.rst index 712d1d891..5ef42f323 100755 --- a/doc/source/icepack_index.rst +++ b/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}`" diff --git a/doc/source/user_guide/ug_case_settings.rst b/doc/source/user_guide/ug_case_settings.rst index 3dea32fb6..c483b0eb9 100644 --- a/doc/source/user_guide/ug_case_settings.rst +++ b/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)", "" diff --git a/doc/source/user_guide/ug_running.rst b/doc/source/user_guide/ug_running.rst index d4d56de33..337901ece 100755 --- a/doc/source/user_guide/ug_running.rst +++ b/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`).