From 4056d0eabe487922b7d75091f9211b9b7e8c35a0 Mon Sep 17 00:00:00 2001
From: lkugler <lukas.kugler@gmail.com>
Date: Wed, 21 Jun 2023 01:36:15 +0200
Subject: [PATCH] .

---
 docs/source/notebooks/tutorial1.ipynb | 44 +++++++++++++++++++++++++++
 1 file changed, 44 insertions(+)

diff --git a/docs/source/notebooks/tutorial1.ipynb b/docs/source/notebooks/tutorial1.ipynb
index b2b85b3..abfb586 100644
--- a/docs/source/notebooks/tutorial1.ipynb
+++ b/docs/source/notebooks/tutorial1.ipynb
@@ -58,6 +58,50 @@
     "```\n",
     "where times are filled, depending on the assimilation time.\n",
     "\n",
+    "### Customizing the DART namelist\n",
+    "By default, the DART namelist of the build directory will be used (copied). \n",
+    "If you want to modify any parameters, specify your changes in a python dictionary like below. For a description of the parameters, see `the official DART documentation <https://docs.dart.ucar.edu/>`_.\n",
+    "```python\n",
+    "exp.dart_nml = {'&assim_tools_nml':\n",
+    "                    dict(filter_kind='1',\n",
+    "                         sampling_error_correction='.true.',\n",
+    "                        ),\n",
+    "                '&filter_nml':\n",
+    "                    dict(ens_size=exp.n_ens,\n",
+    "                         num_output_state_members=exp.n_ens,\n",
+    "                         num_output_obs_members=exp.n_ens,\n",
+    "                         inf_flavor=['0', '4'],\n",
+    "                         output_members='.true.',\n",
+    "                         output_mean='.true.',\n",
+    "                         output_sd='.true.',\n",
+    "                         stages_to_write='output',\n",
+    "                        ),\n",
+    "                '&quality_control_nml':\n",
+    "                    dict(outlier_threshold='-1',\n",
+    "                        ),\n",
+    "                '&location_nml':\n",
+    "                    dict(horiz_dist_only='.false.',\n",
+    "                '&model_nml':\n",
+    "                    dict(wrf_state_variables =\n",
+    "                        [['U',     'QTY_U_WIND_COMPONENT',     'TYPE_U',    'UPDATE','999',],\n",
+    "                         ['V',     'QTY_V_WIND_COMPONENT',     'TYPE_V',    'UPDATE','999',],\n",
+    "                         ['W',     'QTY_VERTICAL_VELOCITY',    'TYPE_W',    'UPDATE','999',],\n",
+    "                         ['PH',    'QTY_GEOPOTENTIAL_HEIGHT',  'TYPE_GZ',   'UPDATE','999',],\n",
+    "                         ['THM',   'QTY_POTENTIAL_TEMPERATURE','TYPE_T',    'UPDATE','999',],\n",
+    "                         ['MU',    'QTY_PRESSURE',             'TYPE_MU',   'UPDATE','999',],\n",
+    "                         ['QVAPOR','QTY_VAPOR_MIXING_RATIO',   'TYPE_QV',   'UPDATE','999',],\n",
+    "                         ['QICE',  'QTY_ICE_MIXING_RATIO',     'TYPE_QI',   'UPDATE','999',],\n",
+    "                         ['QCLOUD','QTY_CLOUDWATER_MIXING_RATIO','TYPE_QC', 'UPDATE','999',],\n",
+    "                         ['CLDFRA','QTY_CLOUD_FRACTION',       'TYPE_CFRAC','UPDATE','999',],\n",
+    "                         ['PSFC',  'QTY_SURFACE_PRESSURE',     'TYPE_PSFC', 'UPDATE','999',],\n",
+    "                         ['T2',    'QTY_2M_TEMPERATURE',       'TYPE_T',    'UPDATE','999',],\n",
+    "                         ['TSK',   'QTY_SKIN_TEMPERATURE',     'TYPE_T',    'UPDATE','999',],\n",
+    "                         ['REFL_10CM','QTY_RADAR_REFLECTIVITY','TYPE_REFL', 'UPDATE','999',]]),\n",
+    "                }\n",
+    "```\n",
+    "Any parameters in this dictionary will be overwritten compared to the default namelist.\n",
+    "\n",
+    "\n",
     "\n",
     "### Single observation experiment\n",
     "If you want to assimilate one observation, use \n",
-- 
GitLab