diff --git a/docs/source/notebooks/tutorial1.ipynb b/docs/source/notebooks/tutorial1.ipynb index 24de18dee6bbd0f0e8f4f4c99a0cca83fc91ab09..b2b85b3884ef91c5dafed611f14def39b8cf165c 100644 --- a/docs/source/notebooks/tutorial1.ipynb +++ b/docs/source/notebooks/tutorial1.ipynb @@ -16,7 +16,11 @@ "id": "93d59d4d-c514-414e-81fa-4ff390290811", "metadata": {}, "source": [ - "### Configuring the experiment\n", + "## Configuring the hardware\n", + "In case you use a cluster which is not supported, copy an existing cluster configuration and modify it, e.g. `config/jet.py`.\n", + "\n", + "\n", + "## Configuring the experiment\n", "Firstly, you need to configure the experiment.\n", "Copy the existing template and modify it `cp config/exp_template.py config/exp1.py`.\n", "\n", @@ -35,27 +39,27 @@ "exp.update_vars = ['U', 'V', 'W', 'THM', 'PH', 'MU', 'QVAPOR', 'QCLOUD', 'QICE', 'PSFC']\n", "\n", "```\n", - "In case you want to generate new observations like for an observing system simulations experiment, OSSE), set \n", + "\n", + "### Generating observations\n", + "In case you want to generate new observations, like for an observing system simulations experiment (OSSE), set \n", "```python\n", "exp.use_existing_obsseq = False\n", "```\n", - "Else, you can use pre-existing observation files:\n", - "```python\n", - "exp.use_existing_obsseq = '/users/students/lehre/advDA_s2023/dartwrf_tutorial/very_cold_observation.out'\n", - "```\n", - "\n", - "`exp.nature` defines the path from where observations can be generated (necessary if `exp.use_existing_obsseq = False`)\n", + "in this case, you need to set the path to WRF nature run files from where DART can generate observations:\n", "```python\n", "exp.nature_wrfout_pattern = '/usr/data/sim_archive/exp_v1_nature/*/1/wrfout_d01_%Y-%m-%d_%H:%M:%S'\n", "```\n", "\n", - "`exp.input_profile` is used, if you create initial conditions from a so called wrf_profile (see WRF guide).\n", + "### Using pre-existing observation files\n", + "\n", + "You can use pre-existing observation files with\n", "```python\n", - "exp.input_profile = '/doesnt_exist/initial_profiles/wrf/ens/raso.fc.<iens>.wrfprof'\n", + "exp.use_existing_obsseq = '/usr/data/sim_archive/exp_ABC/obs_seq_out/%Y-%m-%d_%H:%M_obs_seq.out'\n", "```\n", + "where times are filled, depending on the assimilation time.\n", "\n", "\n", - "#### Single observation\n", + "### Single observation experiment\n", "If you want to assimilate one observation, use \n", "```python\n", "t = dict(plotname='Temperature', plotunits='[K]',\n", @@ -72,7 +76,7 @@ "exp.observations = [t,] # select observations for assimilation\n", "```\n", "\n", - "#### Multiple observations\n", + "### Assimilating multiple observations\n", "To generate a grid of observations, use\n", "```python\n", "vis = dict(plotname='VIS 0.6µm', plotunits='[1]',\n", @@ -80,7 +84,7 @@ " n_obs=961, obs_locations='square_array_evenly_on_grid',\n", " error_generate=0.03, error_assimilate=0.03,\n", " loc_horiz_km=50)\n", - "exp.observations = [vis,]\n", + "exp.observations = [t, vis,]\n", "```\n", "\n", "Caution, n_obs should only be one of the following:\n", @@ -99,13 +103,10 @@ "id": "16bd3521-f98f-4c4f-8019-31029fd678ae", "metadata": {}, "source": [ - "### Configuring the hardware\n", - "In case you use a cluster which is not supported, configure paths inside `config/clusters.py`.\n", - "\n", "\n", "\n", "\n", - "### Assimilate observations\n", + "## Configuring the assimilation experiment\n", "We start by importing some modules:\n", "```python\n", "import datetime as dt\n",