From df4d5c3816ae2d7a5bd911a3457dbd50ff9862b3 Mon Sep 17 00:00:00 2001 From: Marlee Smith Date: Tue, 11 Jun 2024 14:54:37 -0600 Subject: [PATCH 01/10] Removing filter_input.cdl.REMOVED.git-id file from repo --- models/bgrid_solo/work/filter_input.cdl.REMOVED.git-id | 1 - 1 file changed, 1 deletion(-) delete mode 100644 models/bgrid_solo/work/filter_input.cdl.REMOVED.git-id diff --git a/models/bgrid_solo/work/filter_input.cdl.REMOVED.git-id b/models/bgrid_solo/work/filter_input.cdl.REMOVED.git-id deleted file mode 100644 index 74b187155a..0000000000 --- a/models/bgrid_solo/work/filter_input.cdl.REMOVED.git-id +++ /dev/null @@ -1 +0,0 @@ -a1aff6a5661c8a511de0142ccd3b404b27509b82 \ No newline at end of file From 213756f401526bd962ef61b5a63e6ffe041766dd Mon Sep 17 00:00:00 2001 From: Marlee Smith Date: Wed, 12 Jun 2024 16:35:49 -0600 Subject: [PATCH 02/10] Updating workshop_setup.sh to include additional necessary commmands (copying perfect_output.nc into filter_input.nc and setting perturb_from_single_instance = .true. --- models/bgrid_solo/work/workshop_setup.sh | 8 +++++++- 1 file changed, 7 insertions(+), 1 deletion(-) diff --git a/models/bgrid_solo/work/workshop_setup.sh b/models/bgrid_solo/work/workshop_setup.sh index 730de38259..9090cc41e9 100755 --- a/models/bgrid_solo/work/workshop_setup.sh +++ b/models/bgrid_solo/work/workshop_setup.sh @@ -39,12 +39,18 @@ #---------------------------------------------------------------------- # Build the DART programs -echo 'runing quickbuild.sh' +echo 'running quickbuild.sh' ./quickbuild.sh nompi echo 'running perfect_model_obs' ./perfect_model_obs || exit 41 +echo 'copying the output from perfect_model_obs to the input file for filter' +cp perfect_output.nc filter_input.nc + +echo 'changing the &filter_nml setting perturb_from_single_instance to .true. in ./input.nml' +sed -i -e 's/perturb_from_single_instance = .false.,/perturb_from_single_instance = .true.,/g' ./input.nml + echo 'running filter' ./filter || exit 51 From db532bee5fa48dfed6e06940dc33ab61d33215da Mon Sep 17 00:00:00 2001 From: Marlee Smith Date: Wed, 12 Jun 2024 17:10:07 -0600 Subject: [PATCH 03/10] Updating the bgrid_solo documentation to include a list of steps to run filter with a perturbed ensemble member restart files (what is done by running ./workshop_setup.sh). This makes the procedure more visible to the users and allows the users to see how the input files are being used. --- models/bgrid_solo/readme.rst | 30 ++++++++++++++++++++++++++---- 1 file changed, 26 insertions(+), 4 deletions(-) diff --git a/models/bgrid_solo/readme.rst b/models/bgrid_solo/readme.rst index 7673f5a466..79403aad14 100644 --- a/models/bgrid_solo/readme.rst +++ b/models/bgrid_solo/readme.rst @@ -27,10 +27,32 @@ model time step to maintain stability for larger model grids. The model state variables are the gridded surface pressure, temperature, and u and v wind components. -The ``bgrid_solo`` directory has a ``work/workshop_setup.csh`` script that compiles -and runs an example. This example is intended to demonstrate that the same -process used for a low-order model may be used for a much more -complex model and generates output for state-space or observation-space diagnostics. +The ``bgrid_solo`` directory has a ``work/workshop_setup.sh`` script that compiles +and runs an example, producing a bgrid_solo netcdf file and perturbing it to get an +ensemble. This example is intended to demonstrate that the same process used for a +low-order model may be used for a much more complex model and generates output for +state-space or observation-space diagnostics. + +Alternatively, the steps in the ``work/workshop_setup.sh`` script can be executed +indivudally on the command line. These steps are as follows: + +1. | ``./quickbuild.sh`` (or ``quickbuild.sh nompi`` if you are not building with mpi) + | This will create perfect_input.nc from the already available file + ``models/bgrid_solo/work/perfect_input.cdl`` + +2. | ``./perfect_model_obs`` + | Creates a synthetic observation sequence from a hindcast model + +3. | ``cp perfect_output.nc filter_input.nc`` + | Copies the output from perfect_model_obs program to the input file for filter + +4. | In ``work/input.nml``, set ``perturb_from_single_instance = .true.`` in the + &filter_nml + | This setting allows filter to generate an ensemble of perturbed ensemble member + restart files + +5. | ``./filter`` + | Runs the assimilation program Some examples of ways in which this model can be configured and modified to test DART assimilation capabilities are documented in Anderson et al. (2005). [3]_ From f4c42c4debe384aa0601a5b771038f965670527b Mon Sep 17 00:00:00 2001 From: Marlee Smith Date: Wed, 3 Jul 2024 15:37:36 -0600 Subject: [PATCH 04/10] Moving the documentation in workshop_setup.sh to bgrid_solo/readme.rst and improving the clarity of the doc --- models/bgrid_solo/readme.rst | 61 +++++++++++++++++++++++++++--------- 1 file changed, 46 insertions(+), 15 deletions(-) diff --git a/models/bgrid_solo/readme.rst b/models/bgrid_solo/readme.rst index 79403aad14..73eaa7ee64 100644 --- a/models/bgrid_solo/readme.rst +++ b/models/bgrid_solo/readme.rst @@ -27,32 +27,41 @@ model time step to maintain stability for larger model grids. The model state variables are the gridded surface pressure, temperature, and u and v wind components. -The ``bgrid_solo`` directory has a ``work/workshop_setup.sh`` script that compiles -and runs an example, producing a bgrid_solo netcdf file and perturbing it to get an -ensemble. This example is intended to demonstrate that the same process used for a -low-order model may be used for a much more complex model and generates output for -state-space or observation-space diagnostics. +In the ``DART/models/bgrid_solo/work`` directory, an example "perfect model" experiment +can be run in which a bgrid_solo netcdf file is produced and then perturbed +to get an ensemble. This example is intended to demonstrate that the same +process used for a low-order model may be used for a much more complex model +and generates output for state-space or observation-space diagnostics. -Alternatively, the steps in the ``work/workshop_setup.sh`` script can be executed -indivudally on the command line. These steps are as follows: +The steps to run this example are as follows: 1. | ``./quickbuild.sh`` (or ``quickbuild.sh nompi`` if you are not building with mpi) - | This will create perfect_input.nc from the already available file - ``models/bgrid_solo/work/perfect_input.cdl`` + | Builds all DART executables and perfect_input.nc from the cdl file + ``perfect_input.cdl`` 2. | ``./perfect_model_obs`` - | Creates a synthetic observation sequence from a hindcast model + | Reads in an observation sequence file which has only observation definitions + (``obs_seq.in``) and generates synthetic observation values from a hindcast + model (``perfect_input.nc``). Results in an output observation sequence file + (``obs_seq.out``) to be assimilated by 'filter' and perfect_output.nc, the + output state vector file 3. | ``cp perfect_output.nc filter_input.nc`` - | Copies the output from perfect_model_obs program to the input file for filter + | Copies the output from the perfect_model_obs program to the input file for + the filter program 4. | In ``work/input.nml``, set ``perturb_from_single_instance = .true.`` in the - &filter_nml - | This setting allows filter to generate an ensemble of perturbed ensemble member - restart files + ``&filter_nml`` + | This setting causes filter to perturb a single restart file to generate an + ensemble 5. | ``./filter`` - | Runs the assimilation program + | Runs the assimilation program, resulting in three main output files: + | ``preassim.nc`` - the state of all ensemble members prior to the assimilation + (i.e. the forecast) + | ``analysis.nc`` - the state of all ensemble members after the assimilation + | ``obs_seq.final`` - the ensemble members' estimate of what the observations + should have been. Some examples of ways in which this model can be configured and modified to test DART assimilation capabilities are documented in Anderson et al. (2005). [3]_ @@ -80,6 +89,28 @@ Program ``ps_rand_local`` generates a set of randomly located surface pressure observations with an interactively specified error variance. It also allows the observations to be confined to a rectangular subdomain. +Diagnostics +----------- + +The best method to determine the performance of an experiment in which you +assimilate data from real-world sources is to compare the ensemble estimates of +the observation to your real-world data. You can estimate the bias and error of +the ensemble mean or gauge how many of the real-world observations are actually +being assimilated. These diagnostics are known as observation-space diagnostics. +DART provides the program ``obs_diag`` and MATLAB observation space diagnostics +for you to use to quickly assess the performance of your experiment. + +``obs_diag`` reads the ``obs_seq.final`` files and calculates several quantities, +such as the root-mean-squared error, bias, and spread, for an arbitrary number of +regions and levels. ``obs_diag`` outputs a netCDF file called ``obs_diag_output.nc``, +which can then be used in the DART MATLAB routines located in +``DART/diagnostics/matlab/``. + +For more detail on obs_diag and the MATLAB diagnostics, see `PROGRAM obs_diag +(threed_sphere) `_ and `MATLAB observation space diagnostics +`_ + Namelist -------- From 191a9deaa3803f6790fcf6663b7cf3f3e4be0eb7 Mon Sep 17 00:00:00 2001 From: Marlee Smith Date: Wed, 3 Jul 2024 15:43:01 -0600 Subject: [PATCH 05/10] removing the script workshop_setup.sh to have our users run the experiment's steps individually and better understand the process --- models/bgrid_solo/work/workshop_setup.sh | 59 ------------------------ 1 file changed, 59 deletions(-) delete mode 100755 models/bgrid_solo/work/workshop_setup.sh diff --git a/models/bgrid_solo/work/workshop_setup.sh b/models/bgrid_solo/work/workshop_setup.sh deleted file mode 100755 index 9090cc41e9..0000000000 --- a/models/bgrid_solo/work/workshop_setup.sh +++ /dev/null @@ -1,59 +0,0 @@ -#!/bin/csh -# -# DART software - Copyright UCAR. This open source software is provided -# by UCAR, "as is", without charge, subject to all terms of use at -# http://www.image.ucar.edu/DAReS/DART/DART_download -# -# -# Executes a known "perfect model" experiment using an existing -# observation sequence file (obs_seq.in) and initial conditions appropriate -# for both 'perfect_model_obs' (perfect_input.nc) and 'filter' (filter_input.nc). -# There are enough initial conditions for 80 ensemble members in filter. -# Use ens_size = 81 and it WILL bomb. Guaranteed. -# The 'input.nml' file controls all facets of this execution. -# -# 'create_obs_sequence' and 'create_fixed_network_sequence' were used to -# create the observation sequence file 'obs_seq.in' - this defines -# what/where/when we want observations. This script builds these -# programs in support of the tutorial exercises but does not RUN them. -# -# 'perfect_model_obs' results in a true_state.nc file that contains -# the true state, and obs_seq.out - a file that contains the -# synthetic "observations" that will be assimilated by 'filter'. -# -# 'filter' results in three files (at least): preassim.nc - the state -# of all ensemble members prior to the assimilation (i.e. the forecast), -# analysis.nc - the state of all ensemble members after the -# assimilation, and obs_seq.final - the ensemble members' -# estimate of what the observations should have been. -# -# Once 'perfect_model_obs' has advanced the model and harvested the -# observations for the assimilation experiment, 'filter' may be run -# over and over by simply changing the namelist parameters in input.nml. -# -# The result of each assimilation can be explored in model-space with -# matlab scripts that directly read the netCDF output, or in observation-space. -# 'obs_diag' is a program that will create observation-space diagnostics -# for any result of 'filter' and results in a couple data files that can -# be explored with yet more matlab scripts. -#---------------------------------------------------------------------- - -# Build the DART programs -echo 'running quickbuild.sh' -./quickbuild.sh nompi - -echo 'running perfect_model_obs' -./perfect_model_obs || exit 41 - -echo 'copying the output from perfect_model_obs to the input file for filter' -cp perfect_output.nc filter_input.nc - -echo 'changing the &filter_nml setting perturb_from_single_instance to .true. in ./input.nml' -sed -i -e 's/perturb_from_single_instance = .false.,/perturb_from_single_instance = .true.,/g' ./input.nml - -echo 'running filter' -./filter || exit 51 - -exit 0 - - From ab8b7ad82da6a1b1dbd114294386cbdd95e8dd8a Mon Sep 17 00:00:00 2001 From: Marlee Smith Date: Mon, 8 Jul 2024 12:12:26 -0600 Subject: [PATCH 06/10] Fixing the references in readme.rst --- .../programs/obs_diag/threed_sphere/obs_diag.rst | 2 ++ models/bgrid_solo/readme.rst | 7 +++---- 2 files changed, 5 insertions(+), 4 deletions(-) diff --git a/assimilation_code/programs/obs_diag/threed_sphere/obs_diag.rst b/assimilation_code/programs/obs_diag/threed_sphere/obs_diag.rst index e18fc89bdc..45f69a6ec0 100644 --- a/assimilation_code/programs/obs_diag/threed_sphere/obs_diag.rst +++ b/assimilation_code/programs/obs_diag/threed_sphere/obs_diag.rst @@ -1,3 +1,5 @@ +.. _obs-diag-threed-sphere: + PROGRAM ``obs_diag`` (for observations that use the threed_sphere location module) ================================================================================== diff --git a/models/bgrid_solo/readme.rst b/models/bgrid_solo/readme.rst index 73eaa7ee64..e1384d182f 100644 --- a/models/bgrid_solo/readme.rst +++ b/models/bgrid_solo/readme.rst @@ -106,10 +106,9 @@ regions and levels. ``obs_diag`` outputs a netCDF file called ``obs_diag_outp which can then be used in the DART MATLAB routines located in ``DART/diagnostics/matlab/``. -For more detail on obs_diag and the MATLAB diagnostics, see `PROGRAM obs_diag -(threed_sphere) `_ and `MATLAB observation space diagnostics -`_ +For more detail on obs_diag and the MATLAB diagnostics, see :ref:`PROGRAM obs_diag +for the threed_sphere location module ` and +:ref:`MATLAB observation space diagnostics `. Namelist -------- From a0d099c9965dfb73d3c81efa146e0dd684add556 Mon Sep 17 00:00:00 2001 From: Marlee Smith Date: Mon, 8 Jul 2024 16:54:10 -0600 Subject: [PATCH 07/10] Fixing the formatting of the programs, directories, and filenames to all be consistent --- models/bgrid_solo/readme.rst | 33 +++++++++++++++++---------------- 1 file changed, 17 insertions(+), 16 deletions(-) diff --git a/models/bgrid_solo/readme.rst b/models/bgrid_solo/readme.rst index e1384d182f..7458c708a2 100644 --- a/models/bgrid_solo/readme.rst +++ b/models/bgrid_solo/readme.rst @@ -197,9 +197,10 @@ The following values are specified in ``model_nml``. | | | default value. | +----------------------+--------------------+-------------------------------------------+ | override | logical | If true, then the initial model date is | -| | | taken from namelist entry current_time, | -| | | even if an atmos_model.res file is found | -| | | in directory INPUT. For most DART | +| | | taken from namelist entry | +| | | current_time, even if an | +| | | ``atmos_model.res`` file is found | +| | | in the directory ``INPUT``. For most DART | | | | applications, atmospheric restart values | | | | are coming from DART files and no INPUT | | | | directory is used. | @@ -220,12 +221,12 @@ The following values are specified in ``model_nml``. | | | model advance changes the time by | | | | dt_bias. However, internally the bgrid | | | | model is moving things forward by | -| | | dt_atmos. By running perfect_model_obs | +| | | dt_atmos. By running ``perfect_model_obs``| | | | with one time step for the internal bgrid | -| | | clock (for instance dt_atmos = 3600, | -| | | dt_bias = 3600), and filter with another | -| | | (dt_atmos = 3000, and dt_bias = 3600) | -| | | model error is simulated. | +| | | clock (for instance ``dt_atmos = 3600``, | +| | | ``dt_bias = 3600``), and ``filter`` with | +| | | another (``dt_atmos = 3000``, ``dt_bias = | +| | | 3600``), model error is simulated. | +----------------------+--------------------+-------------------------------------------+ | state_variables(:,2) | character(len=129) | Strings that identify the bgrid_solo | | | | variables that should be part of the DART | @@ -236,19 +237,19 @@ The following values are specified in ``model_nml``. | template_file | character(len=256) | This is the name of the file that | | | | specifies the resolution of the variables | | | | DART uses to create the DART state | -| | | vector. If *template_file = "null"* the | -| | | *&bgrid_cold_start_nml* namelist | +| | | vector. If ``template_file = "null"`` the | +| | | ``&bgrid_cold_start_nml`` namelist | | | | variables are used to specify the | | | | resolution. The actual input filenames | -| | | for *filter* and *perfect_model_obs* come | -| | | from their respective namelists. | +| | | for ``filter`` and ``perfect_model_obs`` | +| | | come from their respective namelists. | | | | The resolutions in the file specified in | -| | | *template_file* must match the | +| | | ``template_file`` must match the | | | | resolutions of the variables in the input | | | | filenames. To start an experiment with a | -| | | new model resolution, set template_file | -| | | to "null" and set the resolutions in | -| | | bgrid_cold_start_nml. | +| | | new model resolution, set ``template_file=| +| | | "null"`` and set the resolutions in | +| | | in the ``&bgrid_cold_start_nml``. | +----------------------+--------------------+-------------------------------------------+ The following values are specified in ``bgrid_cold_start_nml``. From a244e0b72e675f488e7849bf5e3c0bdcc0d677f1 Mon Sep 17 00:00:00 2001 From: kdraeder Date: Tue, 9 Jul 2024 14:36:53 -0600 Subject: [PATCH 08/10] Marlee's updated links and file name formats, and my word-smithing and format suggestions --- models/bgrid_solo/readme.rst | 64 +++++++++++++++++------------------- 1 file changed, 30 insertions(+), 34 deletions(-) diff --git a/models/bgrid_solo/readme.rst b/models/bgrid_solo/readme.rst index 7458c708a2..eb61bdda96 100644 --- a/models/bgrid_solo/readme.rst +++ b/models/bgrid_solo/readme.rst @@ -36,15 +36,14 @@ and generates output for state-space or observation-space diagnostics. The steps to run this example are as follows: 1. | ``./quickbuild.sh`` (or ``quickbuild.sh nompi`` if you are not building with mpi) - | Builds all DART executables and perfect_input.nc from the cdl file + | Builds all DART executables and ``perfect_input.nc`` from the cdl file ``perfect_input.cdl`` 2. | ``./perfect_model_obs`` | Reads in an observation sequence file which has only observation definitions (``obs_seq.in``) and generates synthetic observation values from a hindcast - model (``perfect_input.nc``). Results in an output observation sequence file - (``obs_seq.out``) to be assimilated by 'filter' and perfect_output.nc, the - output state vector file + model (``perfect_input.nc``). Results in output state vector file (``perfect_output.nc``) + and an output observation sequence file (``obs_seq.out``) to be assimilated by 'filter' 3. | ``cp perfect_output.nc filter_input.nc`` | Copies the output from the perfect_model_obs program to the input file for @@ -58,10 +57,9 @@ The steps to run this example are as follows: 5. | ``./filter`` | Runs the assimilation program, resulting in three main output files: | ``preassim.nc`` - the state of all ensemble members prior to the assimilation - (i.e. the forecast) + (i.e. the forecast with any prior inflation applied) | ``analysis.nc`` - the state of all ensemble members after the assimilation - | ``obs_seq.final`` - the ensemble members' estimate of what the observations - should have been. + | ``obs_seq.final`` - the ensemble members' estimate of the observations. Some examples of ways in which this model can be configured and modified to test DART assimilation capabilities are documented in Anderson et al. (2005). [3]_ @@ -73,21 +71,20 @@ interactive user input and create a text file that can be piped into program examples for users who are interested in designing their own custom obs_sequence files. -Program ``column_rand`` creates an obs_sequence with randomly located columns of -observations (essentially synthetic radiosondes) that observe surface pressure -along with temperature and wind components at all model levels. ++ | Program ``column_rand`` creates an obs_sequence with randomly located columns of + | observations (essentially synthetic radiosondes) that observe surface pressure + | along with temperature and wind components at all model levels. -Program ``id_set_def_stdin`` generates an obs_sequence file that observes every -state variable with error variance of 10000 for surface pressure and 1.0 for -temperature and wind components. ++ | Program ``id_set_def_stdin`` generates an obs_sequence file that observes every + | state variable with error variance of 10000 for surface pressure and 1.0 for + | temperature and wind components. -Program ``ps_id_stdin`` generates an obs_sequence that observes every surface -pressure variable for the default model size (30x60) with an error variance of -100. ++ | Program ``ps_id_stdin`` generates an obs_sequence that observes every surface + | pressure variable for the default model size (30x60) with an error variance of 100. -Program ``ps_rand_local`` generates a set of randomly located surface pressure -observations with an interactively specified error variance. It also allows the -observations to be confined to a rectangular subdomain. ++ | Program ``ps_rand_local`` generates a set of randomly located surface pressure + | observations with an interactively specified error variance. It also allows the + | observations to be confined to a rectangular subdomain. Diagnostics ----------- @@ -97,18 +94,18 @@ assimilate data from real-world sources is to compare the ensemble estimates of the observation to your real-world data. You can estimate the bias and error of the ensemble mean or gauge how many of the real-world observations are actually being assimilated. These diagnostics are known as observation-space diagnostics. -DART provides the program ``obs_diag`` and MATLAB observation space diagnostics +DART provides the program ``obs_diag`` and MATLAB observation space diagnostics for you to use to quickly assess the performance of your experiment. -``obs_diag`` reads the ``obs_seq.final`` files and calculates several quantities, +``obs_diag`` reads the ``obs_seq.final`` files and calculates several quantities, such as the root-mean-squared error, bias, and spread, for an arbitrary number of -regions and levels. ``obs_diag`` outputs a netCDF file called ``obs_diag_output.nc``, +regions and levels. ``obs_diag`` outputs a netCDF file called ``obs_diag_output.nc``, which can then be used in the DART MATLAB routines located in ``DART/diagnostics/matlab/``. -For more detail on obs_diag and the MATLAB diagnostics, see :ref:`PROGRAM obs_diag -for the threed_sphere location module ` and -:ref:`MATLAB observation space diagnostics `. +For more detail on obs_diag and the MATLAB diagnostics, see +:ref:`PROGRAM obs_diag for the threed_sphere location module ` +and :ref:`MATLAB observation space diagnostics `. Namelist -------- @@ -190,20 +187,19 @@ The following values are specified in ``model_nml``. +======================+====================+===========================================+ | current_time(4) | integer | Specifies the initial time of the Bgrid | | | | model internal clock. The four integer | -| | | values are the day, hour, minutes, and | -| | | seconds. The default version of the Bgrid | +| | | values are the day, hour, minute, and | +| | | second. The default version of the Bgrid | | | | model has neither a diurnal or seasonal | | | | cycle, so these can all be set to 0, the | | | | default value. | +----------------------+--------------------+-------------------------------------------+ | override | logical | If true, then the initial model date is | -| | | taken from namelist entry | -| | | current_time, even if an | -| | | ``atmos_model.res`` file is found | -| | | in the directory ``INPUT``. For most DART | -| | | applications, atmospheric restart values | -| | | are coming from DART files and no INPUT | -| | | directory is used. | +| | | taken from namelist entry current_time, | +| | | even if an ``atmos_model.res`` file | +| | | is found in the directory ``INPUT``. | +| | | For most DART applications, atmospheric | +| | | restart values come from DART files and | +| | | no INPUT directory is used. | +----------------------+--------------------+-------------------------------------------+ | dt_atmos | integer | Model timestep in seconds. | +----------------------+--------------------+-------------------------------------------+ From 9227518723ac153b595d61eea17473f21e683452 Mon Sep 17 00:00:00 2001 From: Marlee Smith Date: Tue, 9 Jul 2024 16:54:14 -0600 Subject: [PATCH 09/10] fixing formatting stragglers --- models/bgrid_solo/readme.rst | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/models/bgrid_solo/readme.rst b/models/bgrid_solo/readme.rst index eb61bdda96..84bba0f960 100644 --- a/models/bgrid_solo/readme.rst +++ b/models/bgrid_solo/readme.rst @@ -43,11 +43,11 @@ The steps to run this example are as follows: | Reads in an observation sequence file which has only observation definitions (``obs_seq.in``) and generates synthetic observation values from a hindcast model (``perfect_input.nc``). Results in output state vector file (``perfect_output.nc``) - and an output observation sequence file (``obs_seq.out``) to be assimilated by 'filter' + and an output observation sequence file (``obs_seq.out``) to be assimilated by ``filter`` 3. | ``cp perfect_output.nc filter_input.nc`` - | Copies the output from the perfect_model_obs program to the input file for - the filter program + | Copies the output from the ``perfect_model_obs`` program to the input file for + the ``filter`` program 4. | In ``work/input.nml``, set ``perturb_from_single_instance = .true.`` in the ``&filter_nml`` From 37f553a50c697efe1148eb4afa596b36064ca690 Mon Sep 17 00:00:00 2001 From: Helen Kershaw Date: Thu, 11 Jul 2024 10:15:32 -0400 Subject: [PATCH 10/10] changelog and conf.py for release --- CHANGELOG.rst | 7 +++++++ conf.py | 2 +- 2 files changed, 8 insertions(+), 1 deletion(-) diff --git a/CHANGELOG.rst b/CHANGELOG.rst index e1dc25ad49..d50c46d295 100644 --- a/CHANGELOG.rst +++ b/CHANGELOG.rst @@ -22,6 +22,13 @@ individual files. The changes are now listed with the most recent at the top. +**July 11 2024 :: Bgrid documentation and scripting fix. Tag v11.5.1** + +- Updated Bgrid documentation and removed outdated scripts and files +- Fixed obs_diag rank histogram documentation links +- Improved inflation file documentation +- GitHub action for running all quickbuilds in DART + **May 16 2024 :: WRF v4. Tag v11.5.0** - WRF-DART and WRF-DART Tutorial updated to WRFv4. Note, not backwards compatible with WRFv3.9. diff --git a/conf.py b/conf.py index 6b2fdb2ab3..db0041097f 100644 --- a/conf.py +++ b/conf.py @@ -21,7 +21,7 @@ author = 'Data Assimilation Research Section' # The full version, including alpha/beta/rc tags -release = '11.5.0' +release = '11.5.1' root_doc = 'index' # -- General configuration ---------------------------------------------------